How to make "man" pages

Jerry freebsd.user at
Wed Mar 31 09:34:17 UTC 2010

On Wed, 31 Mar 2010 15:54:25 +0800, Fbsd1 <fbsd1 at>

> >> On 31/03/2010 04:00:15, Fbsd1 wrote:
> >> Where can I find documentation on the procedure to create "man"
> >> pages for a port?
> > 
> > If you want to write a man page from scratch, probably the best way
> > to get started is to just copy a man page from the base system and
> > edit it to taste.  See groff(1) for documentation on the command
> > used to format man pages from source, and groff_mdoc(7) for details
> > on the groff macro syntax.  groff+mdoc might be a markup language,
> > but it's nothing at all like HTML.
> > 
> > If you're after how to install man pages for a port, then look at:
> > 
> >
> > 
> > Note that the MANX and other ports Macros only affect the pkg-list
> > and compressing the man pages /after/ installation. You'll still
> > have to put in some code to copy your self-written man page into
> > place.
> > 
> > 	Cheers,
> > 
> > 	Matthew
> > 
> OK i want to write a man page from scratch. So lets say i want to use
> /usr/share/man/man2/jail.2.gz as my starting sample. How do I convert 
> this .gz file to a plain text file so I can edit it with ee? And how
> do I turn the edited text file back in to a man page .gz file?

If you visit this URL:
<> you will see
links to various scripts. One of them is for creating 'man' pages:

You might want to investigate its usefulness for your project.

FreeBSD.user at

Disclaimer: off-list followups get on-list replies or get ignored.
Please do not ignore the Reply-To header.


	"And, and, and, and, but, but, but, but!"

	Mrs. Janice Markowsky, April 8, 1965

More information about the freebsd-questions mailing list