From owner-freebsd-questions@FreeBSD.ORG Wed Mar 31 09:20:53 2010 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6B5F1106566B for ; Wed, 31 Mar 2010 09:20:53 +0000 (UTC) (envelope-from m.seaman@infracaninophile.co.uk) Received: from smtp.infracaninophile.co.uk (gate6.infracaninophile.co.uk [IPv6:2001:8b0:151:1::1]) by mx1.freebsd.org (Postfix) with ESMTP id D31808FC1F for ; Wed, 31 Mar 2010 09:20:52 +0000 (UTC) Received: from seedling.black-earth.co.uk (seedling.black-earth.co.uk [81.187.76.163]) (authenticated bits=0) by smtp.infracaninophile.co.uk (8.14.4/8.14.4) with ESMTP id o2V9KjmN035993 (version=TLSv1/SSLv3 cipher=DHE-RSA-CAMELLIA256-SHA bits=256 verify=NO); Wed, 31 Mar 2010 10:20:46 +0100 (BST) (envelope-from m.seaman@infracaninophile.co.uk) Message-ID: <4BB313ED.7030506@infracaninophile.co.uk> Date: Wed, 31 Mar 2010 10:20:45 +0100 From: Matthew Seaman Organization: Infracaninophile User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-GB; rv:1.9.1.8) Gecko/20100227 Thunderbird/3.0.3 MIME-Version: 1.0 To: Fbsd1 References: <4BB2BABF.9070401@a1poweruser.com> <4BB2F8FF.7090707@infracaninophile.co.uk> <4BB2FFB1.4020500@a1poweruser.com> In-Reply-To: <4BB2FFB1.4020500@a1poweruser.com> X-Enigmail-Version: 1.0.1 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.95.3 at happy-idiot-talk.infracaninophile.co.uk X-Virus-Status: Clean X-Spam-Status: No, score=-1.1 required=5.0 tests=BAYES_00,DKIM_ADSP_ALL, SPF_FAIL autolearn=no version=3.3.0 X-Spam-Checker-Version: SpamAssassin 3.3.0 (2010-01-18) on happy-idiot-talk.infracaninophile.co.uk Cc: FreeBSD Questions Subject: Re: How to make "man" pages X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Mar 2010 09:20:53 -0000 -----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-----