snd_hda.4: Improve HARDWARE for HW Relnotes

[ziaee]

Summary

Rewrite the HARDWARE section to improve hardware release notes. Add a
path to the complete list in src like we did in u3g.4, and move it after
DESCRIPTION like we did in all Wi-Fi drivers. Hopefully, we can
improve the HW Relnotes generation to add a cgit link when it sees a
path macro. While here, tag SPDX and remove document description quotes.

MFC after: 3 days

[mav]

While I guess u3g.4 might indeed include the full list of supported devices, simply because IIRC many of them require some quirks to attach and operate, the snd_hda was written with a goal to work on unknown hardware. The list of devices in the code in most cases is just for cosmetics and user convenience. That is why I would not like it to be listed as more than examples. We've actually had a list in the man page before, but I axed it out at some point.

[christos]

Seconding @mav's comment. Looking at the defined codecs in sys/dev/sound/pci/hda/hdac.c can be helpful, but also misleading.

[ziaee]

Thanks! This is great info. I'll reflect on proper wording to reflect that it's designed to work on potentially unknown hardware.

[ziaee]

tweaks

[christos]

share/man/man4/snd_hda.4

398

Would it be better to just say "...supports any PCI class 04h subclass 03h audio controllers...."? Although I do understand what you mean by "potentially unknown", I think it is somewhat non-obvious.

[ziaee]

Thanks christos! Is this better?