From owner-freebsd-ports@FreeBSD.ORG  Mon Dec 11 03:53:56 2006
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
X-Original-To: freebsd-ports@freebsd.org
Delivered-To: freebsd-ports@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id EF7B216A407;
	Mon, 11 Dec 2006 03:53:56 +0000 (UTC)
	(envelope-from freebsd@alaskaparadise.com)
Received: from stargate.alaskaparadise.com (114-103-74-65.gci.net
	[65.74.103.114])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 5294C43C9F;
	Mon, 11 Dec 2006 03:52:42 +0000 (GMT)
	(envelope-from freebsd@alaskaparadise.com)
Received: by stargate.alaskaparadise.com (Postfix, from userid 0)
	id 3380545F8; Sun, 10 Dec 2006 18:53:55 -0900 (AKST)
From: Beech Rintoul <freebsd@alaskaparadise.com>
Organization: NorthWind Communications
To: freebsd-ports@freebsd.org
Date: Sun, 10 Dec 2006 18:53:23 -0900
User-Agent: KMail/1.9.4
References: <200612101804.47366.freebsd@alaskaparadise.com>
	<20061211034252.GJ34082@wantadilla.lemis.com>
In-Reply-To: <20061211034252.GJ34082@wantadilla.lemis.com>
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="nextPart2979148.6lC046gSn3";
	protocol="application/pgp-signature"; micalg=pgp-sha1
Content-Transfer-Encoding: 7bit
Message-Id: <200612101853.50325.freebsd@alaskaparadise.com>
Cc: Greg 'groggy' Lehey <grog@freebsd.org>
Subject: Re: Using groff
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 11 Dec 2006 03:53:57 -0000

--nextPart2979148.6lC046gSn3
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline

On Sunday 10 December 2006 18:42, Greg 'groggy' Lehey wrote:
> On Sunday, 10 December 2006 at 18:04:26 -0900, Beech Rintoul wrote:
> > I need to write a man page for a port I just adopted. I have absolutely
> > no experience dealing with man pages or groff. Would one of you gurus
> > point me at a good tutorial. The man page for groff is pretty
> > overwhelming. I googled, but didn't find much that wasn't in the man
> > page. Is there a tutorial specific to man pages? I can copy the style
> > from other pages, but I have no clue where to begin.
>
> RTFM :-)  In this case, the man page to read is mdoc(7).  It contains
> a fair amount of information not only on the syntax needed, but also
> the sometimes idiosyncratic structure (for example, a section entitled
> AUTHORS even if there's only one author).
>
> If you forget the name of the man page, man man.  It's mentioned in
> the SEE ALSO section at the bottom.
>
> Greg

Thanks Greg, looks like I have some homework to do. :-)
=2D-=20
=2D------------------------------------------------------------------------=
=2D-------------
Beech Rintoul - Sys. Administrator - beech@alaskaparadise.com
/"\   ASCII Ribbon Campaign  | Alaska Paradise Travel
\ / - NO HTML/RTF in e-mail  | 201 East 9Th Avenue Ste.310
 X  - NO Word docs in e-mail | Anchorage, AK 99501
/ \  - Please visit Alaska Paradise - http://www.alaskaparadise.com
=2D------------------------------------------------------------------------=
=2D-------------












--nextPart2979148.6lC046gSn3
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (FreeBSD)

iD8DBQBFfNZOR5sEeCt9j00RAkt3AJ44Y/WUXR3goiQ39S3b0rpX5r07kgCglzCz
kZRYXv/DuW518mun8QbPhTo=
=En7V
-----END PGP SIGNATURE-----

--nextPart2979148.6lC046gSn3--