Have you created a program, such as a parser or a tokenizer or a tagger, that you would like to distribute? Create manpages to make them more user friendly!
This article contains instructions for doing so. However, I found I had to do a few things to make it work:
The instructions have you type up a sample manpage including lines such as:
.SH HEADING .PP And this is the text that follows.
Following instructions, I used groff to format my page, but I could not get everything to work right, so instead, I just deleted ".PP", and then I separated "HEADING" from "And this..." with a newline instead of doing the groff part.
Basically, once you create a file, gzip it, and move it to /usr/share/man/manx, then look at it using man, you will see what else you need to delete and what formatting changes you need to make. If I get the groff issue worked out, which I suspect should do this for you so you really could type in exactly what it says in this tutorial, I will update this page.
Anyway, the way I did it, my manpage looked great, and I just want to say that I'll never create a utility without a manpage again!!!