Writing man pages by hand is indeed something that makes you lose the will to live. For anything beyond the trivial case I just write Markdown and convert it to a man page using pandoc.