From owner-freebsd-doc@FreeBSD.ORG Sat Apr 26 03:34:21 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 B65AD37B401; Sat, 26 Apr 2003 03:34:19 -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 ED29F43FB1; Sat, 26 Apr 2003 03:34:18 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 7E86210BF82; Sat, 26 Apr 2003 12:34:17 +0200 (CEST) Date: Sat, 26 Apr 2003 12:34:17 +0200 From: "Simon L. Nielsen" To: "Gary W. Swearingen" Message-ID: <20030426103416.GA407@nitro.dk> References: <20030424233703.GB48527@nitro.dk> <20030425202427.GC28920@sunbay.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="fdj2RfSjLxBAspz7" Content-Disposition: inline In-Reply-To: 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: Sat, 26 Apr 2003 10:34:21 -0000 --fdj2RfSjLxBAspz7 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.04.25 16:46:18 -0700, Gary W. Swearingen wrote: > To avoid having erroneous information in the manpages before someone > discovers that the category has been changed without the changer > remembering and/or bothering to search all the manpages and fix all the > unnecessary category references which have gone bad. That's too much to > expect to happen, methinks. Also, to avoid the need to handle the > PRs that will then be (eventually) written after nearly every change. >=20 > As for the SGML, the same thing applies, but I suspect it's too hard to > fix in the SGML processing, but I recommend easing SGML maintenance by > omitting the "CATEGORY/". There's too much more useful stuff to > maintain, as it is, and "whereis" easily gives the category to anyone > who can't guess it. Is this really a big problem? I't not that often ports get moved and since there is ports/MOVED it is very easy to use a script to once in a while automatically go through the references in the documentation and fix the references. If the category is not there it would also make it harder to make links to the port e.g. in man.cgi. That being said if others feel it is better to not specify ports it OK with me. I mainly want to get rid of "bad" references. --=20 Simon L. Nielsen --fdj2RfSjLxBAspz7 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+qmCo8kocFXgPTRwRAoLrAKCOW47hsrF7AdCujzZgu2TXiWeRXwCdFVT1 Iv1Ykgf281KHosJBavFd6zc= =auOf -----END PGP SIGNATURE----- --fdj2RfSjLxBAspz7--