From owner-freebsd-questions@FreeBSD.ORG Wed Mar 31 09:34:16 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 D5FD5106564A for ; Wed, 31 Mar 2010 09:34:16 +0000 (UTC) (envelope-from freebsd.user@seibercom.net) Received: from mail-qy0-f181.google.com (mail-qy0-f181.google.com [209.85.221.181]) by mx1.freebsd.org (Postfix) with ESMTP id 869DF8FC14 for ; Wed, 31 Mar 2010 09:34:16 +0000 (UTC) Received: by qyk11 with SMTP id 11so458859qyk.13 for ; Wed, 31 Mar 2010 02:34:15 -0700 (PDT) Received: by 10.224.71.168 with SMTP id h40mr2527840qaj.34.1270028055179; Wed, 31 Mar 2010 02:34:15 -0700 (PDT) Received: from scorpio.seibercom.net (c-67-189-160-65.hsd1.ny.comcast.net [67.189.160.65]) by mx.google.com with ESMTPS id 20sm3068578qyk.4.2010.03.31.02.34.13 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 31 Mar 2010 02:34:14 -0700 (PDT) Received: from scorpio.seibercom.net (localhost [127.0.0.1]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: freebsd.user@scorpio.seibercom.net) by scorpio.seibercom.net (Postfix) with ESMTPSA id 880082283C for ; Wed, 31 Mar 2010 05:34:12 -0400 (EDT) Date: Wed, 31 Mar 2010 05:34:11 -0400 From: Jerry To: freebsd-questions@freebsd.org Message-ID: <20100331053411.3e3f3c56@scorpio.seibercom.net> In-Reply-To: <4BB2FFB1.4020500@a1poweruser.com> References: <4BB2BABF.9070401@a1poweruser.com> <4BB2F8FF.7090707@infracaninophile.co.uk> <4BB2FFB1.4020500@a1poweruser.com> Organization: seibercom.net X-Mailer: Claws Mail 3.7.5 (GTK+ 2.18.7; i386-portbld-freebsd7.3) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAGFBMVEX+/v7++v6YOTrq8PCcuIX989UvOSj++v0BNCbpAAAAB3RJTUUHsQwfFzs7RBhzUQAAAhJJREFUOI1dU8GOqzAMNKIoV1bvwD1i0ysqrHplIdBrVSX7ATSbd03VVvn9tQNtQy0hjAdn7LED4AAcPtWm9RV+MPSfxhBLx9ajd6X/ngB6/mTwnRSZua7i7Ca+0ctZKo4Qmz+JY13X6I3nFZBxIYW1PbgfQ5RP8g0XlltEWGf3cV03joYpRnFbvYDKbXjZlXyyhEZA4lI+cN3NaVXE4VKjSwTExO10eTEkkJVqIAD5z0nUBQJluQDRSQjcrBiHAJxZlAH5CUMBMC7OcJ4LMQNnxhZ1HYPscMc6J4UlWRMNwzOpCcAHKSICd1EDn83abdREIbXsHkD1OinP1aCUCOEVRaa1lMcvywUWdYgk13JQUpYNKmvXQ8Kw5ML9YI5h8SakctBc7E/IYuLhYd/zZIk+1gM1vNweQBvHE0j+oYah3sMqAytQYlZk6+ANaaawJdu3OFzYGMZ3iGpa3qMlq9ZH0VZTgrCtw/ngdYkEIIpSbP1bWQAdFdX9vocBdkH2qVjVmuMu3gI5rjs814EUdrCZgWlPaxZZ3RiLFUtr+ud0PXwp2dnQSNXgePt6AZpBj6UMJ7VQkzN4utVeaSW1Dhn/kblGrKeMvNGnzwX4zuEDarYz1KdPtR60Gul0Gued+515SJXhCsl+Tx/3kY/UDvicPll9mfu50t3tvQ/thZpJYgeuwdSKNJ6tCD98MCgoxLDaPxbwqqwPWaWiAAAAAElFTkSuQmCC X-Face: "\j?x](l|]4p?-1Bf@!wN<&p=$.}^k-HgL}cJKbQZ3r#Ar]\%U(#6}'?<3s7%(%(gxJxxcR Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Subject: Re: How to make "man" pages X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: freebsd-questions@freebsd.org List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Mar 2010 09:34:17 -0000 On Wed, 31 Mar 2010 15:54:25 +0800, Fbsd1 articulated: > > >> 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? If you visit this URL: you will see links to various scripts. One of them is for creating 'man' pages: You might want to investigate its usefulness for your project. -- Jerry FreeBSD.user@seibercom.net Disclaimer: off-list followups get on-list replies or get ignored. Please do not ignore the Reply-To header. __________________________________________________________________ FORTUNE REMEMBERS THE GREAT MOTHERS: #5 "And, and, and, and, but, but, but, but!" Mrs. Janice Markowsky, April 8, 1965