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