Date: Sat, 26 Apr 2003 12:34:17 +0200 From: "Simon L. Nielsen" <simon@nitro.dk> To: "Gary W. Swearingen" <swear@attbi.com> Cc: Ruslan Ermilov <ru@freebsd.org> Subject: Re: .Xr references to ports in man pages Message-ID: <20030426103416.GA407@nitro.dk> In-Reply-To: <t2ist29m45.st2@localhost.localdomain> References: <20030424233703.GB48527@nitro.dk> <ien0ie9z21.0ie@localhost.localdomain> <20030425202427.GC28920@sunbay.com> <t2ist29m45.st2@localhost.localdomain>
next in thread | previous in thread | raw e-mail | index | archive | help
--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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030426103416.GA407>