From owner-freebsd-questions@FreeBSD.ORG Wed Mar 31 07:26:01 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 073B010656C3 for ; Wed, 31 Mar 2010 07:26:01 +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 700C58FC1C for ; Wed, 31 Mar 2010 07:26:00 +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 o2V7Pphm034848 (version=TLSv1/SSLv3 cipher=DHE-RSA-CAMELLIA256-SHA bits=256 verify=NO); Wed, 31 Mar 2010 08:25:52 +0100 (BST) (envelope-from m.seaman@infracaninophile.co.uk) Message-ID: <4BB2F8FF.7090707@infracaninophile.co.uk> Date: Wed, 31 Mar 2010 08:25:51 +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> In-Reply-To: <4BB2BABF.9070401@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 07:26:01 -0000 -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 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 - -- 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/ iEYEARECAAYFAkuy+P8ACgkQ8Mjk52CukIxcggCeLR3OcpdwZ/OZGZv623DawCC9 E+4AoJNMvoINM9xkL2CdYBwz/ozPnAgK =qVD0 -----END PGP SIGNATURE-----