It is the same macro with additional output, that can simplify hardware.adoc processing.
- fixes mandoc generation of left bracket (the same as \_ before)
- adds messages to the screen, when HARDWARE section is absent or empty (before they skipped silently)
- writes hwlist macro into hardware.adoc for next cycles.
It allows to run make again with the same file and update information about drivers as soon as
- new man pages added
- HARDWARE section is added to a man page.
- The line with hwlist macro has warning message text in the same line (4 spaces to the rigth) - to search
in the hardware.adoc and make actions based on error message.
How it works:
With this version of the script we need to copy hardware.adoc from template
first and only one time in the begining of the release cycle,
and run make generate-hardware-notes as many times as needed.
If that specific release does not support some drivers, these lines can be removed in any moment
from hardware.adoc. In day before release date all unsupported drivers must be removed finally.