From owner-freebsd-questions@FreeBSD.ORG Thu Apr 1 08:42:07 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 C65EA106564A for ; Thu, 1 Apr 2010 08:42:07 +0000 (UTC) (envelope-from fbsd1@a1poweruser.com) Received: from mail-03.name-services.com (mail-03.name-services.com [69.64.155.195]) by mx1.freebsd.org (Postfix) with ESMTP id B0C388FC1D for ; Thu, 1 Apr 2010 08:42:07 +0000 (UTC) Received: from [10.0.10.3] ([202.69.173.253]) by mail-03.name-services.com with Microsoft SMTPSVC(6.0.3790.3959); Thu, 1 Apr 2010 01:42:07 -0700 Message-ID: <4BB45C57.2040104@a1poweruser.com> Date: Thu, 01 Apr 2010 16:41:59 +0800 From: Fbsd1 User-Agent: Thunderbird 2.0.0.17 (Windows/20080914) MIME-Version: 1.0 To: Matthew Seaman References: <4BB2BABF.9070401@a1poweruser.com> <4BB2F8FF.7090707@infracaninophile.co.uk> <4BB2FFB1.4020500@a1poweruser.com> <4BB313ED.7030506@infracaninophile.co.uk> In-Reply-To: <4BB313ED.7030506@infracaninophile.co.uk> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-OriginalArrivalTime: 01 Apr 2010 08:42:08.0153 (UTC) FILETIME=[36A44890:01CAD177] X-Sender: fbsd1@a1poweruser.com 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: Thu, 01 Apr 2010 08:42:07 -0000 Matthew Seaman wrote: > -----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. > > > Getting closer but not there yet. Selected man jail to be my example of macro commands used. Did [gunzip jail.8.gz] and now I have jail.8 file. How to I convert this file to native macro file that I can edit with ee? After editing the macro file how to I convert it to format ready to compress? I want to test it with the man command. When I do groff -mdoc -Tascii jail.8 | less I get loads of this message "mdoc warning: Empty input line #xxx. If I look at man jail screen output I see each message corresponds to a blank line in the man page. Is this suppose to happen?