Attempt to improve whitespace. I'm not sure if I'm understanding @jrtc27's whitespace suggestion but also I've never done this part of it before.

Revert to showing the disable text, which will always work because pkg
parses the last thing. add a squirrely statement saying to remove the
config file if they made one.

add -g from @ivy's comment on the mailing list.

In D55458#1276878, @minsoochoo0122_proton.me wrote:

I'm falling behind for this topic. Does this mean starting from pkg 2.5, we don't need pkgbasify? Also what version of FreeBSD support this?

• remove example for converting to pkgbase
• remove warning

Hardware section is looking good! Consider sorting them in reverse order, so that as it gets longer over time, the current stuff that people are more likely to be able to source is at the top.

Also note that pkg search was made case sensitive in pkg 2.5.0.

• add egl-wayland/egl-wayland2 and work on egl/x11 to match/add xcb/xlib

I'd suggest the ABI issue should be a pkg-message that is conditionally enabled for the affected ports.

Hey Vladlen! Here's what I've got so far, out of time!

Does that sound ok to you?

The workaround is a part of an issue in the Open Issues section,

The corresponding change has been merged into OpenZFS.

Is "use of a symlink to select the kernel tree to boot" not clear?

Your version leaves out "regression" which I included because this use worked before.

Good idea.

Approved with removing the anchors just before

If you're going to take these out, probably should take out the anchors just before them too

Vladlen's suggested text would address my concerns. @leres can you do this before the release announcement goes out in ten hours? If I hear nothing and no one objects, I will commit the one I wrote already in a few hours.

Thanks for your hard work @vladlen!

Make sure to use PR: and not Fixes: for the commit message trailer!

omg this is amazing!

I really like Graham's suggested workaround, but I personally think it's wrong to punctuate items in this type of list. It's bad for URLs. I approve for accepting any combination or none of the suggestions. Thanks @vladlen!

In D55753#1275591, @vladlen wrote:

Would you like me to land D55751 as it was in the original issue description?

Anyone? This is a brand new chapter written by a core team member which has been up for over 3 months. We just need 20 minutes someone who understands how the handbook works...

btw, i would also oppose adding this to build(7). manpages are not bug trackers. but if it belongs anywhere, it's there.

Thanks so much everyone!

Oops, the multiple variants was a typo. I actually want to use version
for the second one. Thanks for your attention to detail here!

The last patch didn't work in testing on my laptop. Sorry for the noise. Here is an updated patch which I am currently booted from.

use adamw's suggestions. I appreciate the attention to detail!

Wow, this is interesting. I've been running FreeBSD coreboot for many years, I'll test this next week on my APU2.

See ls for similar language.

okay, matt updated the patch

I'm not really seeing this as a general improvement

Once you commit this I'll add some more.

I like this section because I primarily work on the manpages project, so showing it has activity is very appreciated to me. I would organize them by section number, then alphabetically, but I can do that! Thank you so much for doing this!

Ping. Perhaps the patch could use rebasing.

Thanks Tomoaki!
Thanks Danfe!

remove example numbers. note they are requested in style.mdoc(5).

remove example numbers. note example numbers are requested in style.mdoc(5).

flesh out more

add info about repos. notably, i am lying about pkg unregister -r,
i know pkg unregister doesn't support repos yet, but i am proposing
it does, or that someone else proposes how we are supposed to do this,
or admits that we have no plan how people are supposed to upgrade.

remove hyphen

use database or compiler versions, i like that.
i like the text we've come up with so far otherwise.

attempt to restore ints

finish converting to bool

restore missing brace, thanks @cperciva!

attempt to convert to bool, thanks @fuz