man.4: Add .Sh HARDWARE for some wireless drivers for release notes

[bz]

Summary

iwlwifi.4 and rtw88.4 did not show up in the hardware list in the
release notes for 13.4.
The doc/website/tools/hardware-notes-processor.rb script parses
the .Sh HARDWARE section to automagically create a note once the
manual page is listed in the website/archetypes/release/hardware.adoc
file.

While here update the other committed man pages not yet connected
to the build.

Reported by: re (cperciva), grahamperrin
Sponsored by: The FreeBSD Foundation
MFC after: 3 days

[concussious.bugzilla_runbox.com]

The doc/website/tools/hardware-notes-processor.rb script parses the .Sh HARDWARE section to automagically create a note once the manual page is listed in the website/archetypes/release/hardware.adoc file.

This is extremely significant news to me. HARDWARE is not a standard section in mdoc(7) or mentioned in style.mdoc(5). The linter (at least used to) complains about non-standard sections. I will work on this.

[bz]

In D46851#1068386, @concussious.bugzilla_runbox.com wrote:

The doc/website/tools/hardware-notes-processor.rb script parses the .Sh HARDWARE section to automagically create a note once the manual page is listed in the website/archetypes/release/hardware.adoc file.

This is extremely significant news to me. HARDWARE is not a standard section in mdoc(7) or mentioned in style.mdoc(5). The linter (at least used to) complains about non-standard sections. I will work on this.

That is something I had mentioned to Colin and grahamperrin as well (lack of documentation in mdoc(7)).
I'll be more than happy if this and whatever tools people use for man pages grow knowledge of it after about 20 years.

I haven;t dug into it but I wonder what the old scripts in the doc/website repo did to extract the changes as there would likely have been the history of a lot of this. @brueffer @simon @trhodes are the people I have on my mind when it comes to this. Maybe someone is reading here still and can shed some light.

[concussious.bugzilla_runbox.com]

I'll be more than happy if this and whatever tools people use for man pages grow knowledge of it after about 20 years.

I am working on manual pages every week for the past year and have no intentions to stop. I will ask on mandoc-tech and see if the mandoc lead is willing to accept this into the standard and mdoc(7). If not, I will submit a github PR to style.mdoc(5) and cc everyone ITT, unless there are any objections. Thank you so much.

[cperciva]

In D46851#1068386, @concussious.bugzilla_runbox.com wrote:

The doc/website/tools/hardware-notes-processor.rb script parses the .Sh HARDWARE section to automagically create a note once the manual page is listed in the website/archetypes/release/hardware.adoc file.

This is extremely significant news to me. HARDWARE is not a standard section in mdoc(7) or mentioned in style.mdoc(5). The linter (at least used to) complains about non-standard sections. I will work on this.

Thank you! I only became aware of this recently when I started doing releases and had to put the website bits together. This particular ruby script was committed by @carlavilla in 2021 but it's entirely possible that it replaced an older script -- it arrived as part of a commit "Use Hugo Archetype to generate new releases".

[bz]

In D46851#1068393, @cperciva wrote:

In D46851#1068386, @concussious.bugzilla_runbox.com wrote:

The doc/website/tools/hardware-notes-processor.rb script parses the .Sh HARDWARE section to automagically create a note once the manual page is listed in the website/archetypes/release/hardware.adoc file.

This is extremely significant news to me. HARDWARE is not a standard section in mdoc(7) or mentioned in style.mdoc(5). The linter (at least used to) complains about non-standard sections. I will work on this.

Thank you! I only became aware of this recently when I started doing releases and had to put the website bits together. This particular ruby script was committed by @carlavilla in 2021 but it's entirely possible that it replaced an older script -- it arrived as part of a commit "Use Hugo Archetype to generate new releases".

I'll just add this here; I believe the old hardware notes had sections for the different sorts of drivers; we should sub-section "wired ethernet" / "wirleess" / "stroage" / ... / "misc" somehow as that'll help a lot to find something. Do we have a better platform / mailing list / a PR to attach all this to?

[concussious.bugzilla_runbox.com]

Do we have a better platform / mailing list / a PR to attach all this to?

It's rough, but: https://github.com/freebsd/freebsd-src/pull/1451

[bz]

share/man/man4/rtw88.4

95–106

This looks weird.

[bz]

share/man/man4/rtw88.4

95–106

All good. Just odd display of the change.

[bz]

Anyone from manpages who could review this change?

[concussious.bugzilla_runbox.com]

Linted and looked at each rendered page, LGTM.