Learning about how to write a well written manual page, just want to
point out the examples provided by the
FreeBSD Project, located under the base
system in /usr/share/examples/mdoc.
For those who are not (yet!) under FreeBSD Operating System, you can browse the publicly available CVS repository via the web interface.
If not already in the system man path or the environmental variable ${MANPATH}, you can display your new manual page using:
$ tbl example.1 | groff -S -Wall -mtty-char -man -Tlatin1 | col | more
Or:
$ zcat example.1.gz | tbl | groff -S -Wall -mtty-char -man -Tlatin1 | col | more