I realise that with GNU 'info' a lot of developers become, dare I say
it, quite lazy when it comes to providing a well written man page -
and some argue they're not needed at all. But I find, in the products
that I develop, that man pages are used more often for quick
reference, and therefore the quality and usability of a product can be
improved by providing well written man pages.
To that end, and because I've been writing man pages myself for over
10 years, I've decided to provide some notes for beginners on how to
write your own man page. I hope this article is of help to the wider
developer community:
http://technicalprose.blogspot.com/2011/06/how-to-write-unix-man-page.html
Best regards,
Mark.