I wrote a quick tutorial on writing manual pages: http://liw.fi/manpages/, so I can point people at one I like when I get into my next argument on whether manual pages are impossible to write by hand or not.