Date: Wed, 31 Mar 2010 10:20:45 +0100 From: Matthew Seaman <m.seaman@infracaninophile.co.uk> To: Fbsd1 <fbsd1@a1poweruser.com> Cc: FreeBSD Questions <freebsd-questions@freebsd.org> Subject: Re: How to make "man" pages Message-ID: <4BB313ED.7030506@infracaninophile.co.uk> In-Reply-To: <4BB2FFB1.4020500@a1poweruser.com> References: <4BB2BABF.9070401@a1poweruser.com> <4BB2F8FF.7090707@infracaninophile.co.uk> <4BB2FFB1.4020500@a1poweruser.com>
next in thread | previous in thread | raw e-mail | index | archive | help
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
On 31/03/2010 08:54:25, Fbsd1 wrote:
> 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?
% cp /usr/share/man/man2/jail.2.gz .
% gunzip jail.2.gz
% mv jail.2 myname.2
% ee myname.2
> And how do
> I turn the edited text file back in to a man page .gz file?
To compress the groff source:
% gzip myname.2
To render the groff source as ascii text (what the man(1) command does):
% groff -mdoc -Tascii myname.2 | less
or
% gzcat myname.2.gz | groff -mdoc -Tascii | less
In general though, you should keep the man page source uncompressed
while you're working on it and within the port; install it uncompressed
and leave it to the ports machinery to compress it after installation.
Cheers,
Matthew
- --
Dr Matthew J Seaman MA, D.Phil. 7 Priory Courtyard
Flat 3
PGP: http://www.infracaninophile.co.uk/pgpkey Ramsgate
Kent, CT11 9PW
-----BEGIN PGP SIGNATURE-----
Version: GnuPG/MacGPG2 v2.0.14 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
iEYEARECAAYFAkuzE+0ACgkQ8Mjk52CukIx6VgCfV9R1LOrqcjzlnwSEMNHAT/Ys
iOEAniohL9mC7ehGZXKub+9RHKmI87px
=fhC7
-----END PGP SIGNATURE-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4BB313ED.7030506>