From owner-freebsd-doc@FreeBSD.ORG Fri May 2 14:53:00 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 10EBD37B401; Fri, 2 May 2003 14:53:00 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id B3FD843FBF; Fri, 2 May 2003 14:52:58 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 269CB10BF86; Fri, 2 May 2003 23:52:57 +0200 (CEST) Date: Fri, 2 May 2003 23:52:57 +0200 From: "Simon L. Nielsen" To: Tom Rhodes Message-ID: <20030502215256.GE389@nitro.dk> References: <20030424233703.GB48527@nitro.dk> <20030425202427.GC28920@sunbay.com> <20030426103416.GA407@nitro.dk> <20030426113227.GC9189@sunbay.com> <20030428232915.67cccaa8.trhodes@FreeBSD.org> <20030429173317.GA56779@sunbay.com> <20030429013235.1743a16a.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="mYCpIKhGyMATD0i+" Content-Disposition: inline In-Reply-To: <20030429013235.1743a16a.trhodes@FreeBSD.org> User-Agent: Mutt/1.5.4i cc: freebsd-doc@FreeBSD.org cc: Ruslan Ermilov Subject: Re: .Xr references to ports in man pages X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 May 2003 21:53:00 -0000 --mYCpIKhGyMATD0i+ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.04.29 01:32:35 -0400, Tom Rhodes wrote: > On Tue, 29 Apr 2003 20:33:17 +0300 > Ruslan Ermilov wrote: >=20 > > On Mon, Apr 28, 2003 at 11:29:15PM -0400, Tom Rhodes wrote: > > >=20 > > > So, are we going to work on this? > > >=20 > > We already do. The only thing I miss is how people would like > > it to be rendered, and I just need more opinions (more voices). > > I hoped that ports@ and doc@ (not necessarily committers) > > developers would suggest something, or agree on the proposed > > one. >=20 > With every hat I can fit on my head (wow, don't I look funny) I You should make a picture of that ;-) > want to say we should do it in a similar fasion to how we do it > in the doc project. Use things like: >=20 > .Xr net/cvsup I would guess (not sure) that it is somewhat harder to parse this in groff, and check the category, compared to seperating port category and name with a space since that is the way Ruslan originally did it. > and render accordingly. Then we can parse the the MOVED file in > the ports collection and boom. While it sounds much simpler than > doing, I think it should be moved forward. :) Parsing of man pages is actually very straight forward so actually it is simple - as long as it doesn't happen run time but rather in some kind of tinderbox (and IMO there is no reason to do these check runtime). --=20 Simon L. Nielsen --mYCpIKhGyMATD0i+ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+sui48kocFXgPTRwRAva0AJ9KsSGxNWsEq/1Dm2Syq86tkkfAFQCcD9sG VZZ5L2baAY8AorW46O0xcto= =F2id -----END PGP SIGNATURE----- --mYCpIKhGyMATD0i+--