From owner-freebsd-questions@FreeBSD.ORG  Wed Mar 31 07:54:32 2010
Return-Path: <owner-freebsd-questions@FreeBSD.ORG>
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 052091065741
	for <freebsd-questions@freebsd.org>;
	Wed, 31 Mar 2010 07:54:32 +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 E47F98FC12
	for <freebsd-questions@freebsd.org>;
	Wed, 31 Mar 2010 07:54:31 +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); 
	Wed, 31 Mar 2010 00:54:32 -0700
Message-ID: <4BB2FFB1.4020500@a1poweruser.com>
Date: Wed, 31 Mar 2010 15:54:25 +0800
From: Fbsd1 <fbsd1@a1poweruser.com>
User-Agent: Thunderbird 2.0.0.17 (Windows/20080914)
MIME-Version: 1.0
To: Matthew Seaman <m.seaman@infracaninophile.co.uk>
References: <4BB2BABF.9070401@a1poweruser.com>
	<4BB2F8FF.7090707@infracaninophile.co.uk>
In-Reply-To: <4BB2F8FF.7090707@infracaninophile.co.uk>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
X-OriginalArrivalTime: 31 Mar 2010 07:54:32.0504 (UTC)
	FILETIME=[66211380:01CAD0A7]
X-Sender: fbsd1@a1poweruser.com
Cc: FreeBSD Questions <freebsd-questions@freebsd.org>
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 <freebsd-questions.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 31 Mar 2010 07:54:32 -0000


>> 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?