b0rk, 
this guidance on man pages for the GNU project is wild https://www.gnu.org/prep/standards/html_node/Man-Pages.html
(they seem to think everyone should use info pages instead, which I personally have never used despite having used GNU tools for 20 years)
