Date: Wed, 31 Mar 2010 15:54:25 +0800 From: Fbsd1 <fbsd1@a1poweruser.com> To: Matthew Seaman <m.seaman@infracaninophile.co.uk> Cc: FreeBSD Questions <freebsd-questions@freebsd.org> Subject: Re: How to make "man" pages Message-ID: <4BB2FFB1.4020500@a1poweruser.com> In-Reply-To: <4BB2F8FF.7090707@infracaninophile.co.uk> References: <4BB2BABF.9070401@a1poweruser.com> <4BB2F8FF.7090707@infracaninophile.co.uk>
next in thread | previous in thread | raw e-mail | index | archive | help
>> 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: > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-manpages.html > > 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?
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4BB2FFB1.4020500>