share/man/man4/aq.4
32	Or similar. The reasoning is then people can search through the hardware release notes to see what kind of hardware they need, if they want say, a 10g Ethernet card. I also wrote this in style.mdoc(7).

emaste added inline comments.Thu, Nov 20, 3:30 PM

share/man/man4/aq.4
32	No objection, but that information is in the Nd -- `aq – Aquantia / Marvell AQ1xx 10 Gigabit Ethernet driver`

ziaee added inline comments.Thu, Nov 20, 3:34 PM

share/man/man4/aq.4
32	Yeah, it's not for the manual, it's for the HW Relnotes. The entire HARDWARE section appears verbatim in the HW Relnotes. When it has no context, then the document becomes only useful for a very narrow use case of "Find in Page"ing your specific hardware you already have. And, I know, but if we do it this way, we can maintain it. Otherwise the HW Relnotes becomes full of dead links that someone has to actually line by line investigate the history of what it's talking about, which is a colossal effort.

Update HARDWARE introduction, thanks @ziaee

Are there kernconfs to compile the module? We also usually put that in synopsis.

I see this formulation in share/man/man4/mgb.4 and share/man/man4/muge.4 and I probably looked at one of those as a template. I'll take a look at updating those first. mgb(4) is a driver for PCIe GigE hw, muge(4) USB GigE.