Date: Sat, 26 Apr 2003 14:32:27 +0300 From: Ruslan Ermilov <ru@freebsd.org> To: "Simon L. Nielsen" <simon@nitro.dk> Cc: freebsd-doc@freebsd.org Subject: Re: .Xr references to ports in man pages Message-ID: <20030426113227.GC9189@sunbay.com> In-Reply-To: <20030426103416.GA407@nitro.dk> References: <20030424233703.GB48527@nitro.dk> <ien0ie9z21.0ie@localhost.localdomain> <20030425202427.GC28920@sunbay.com> <t2ist29m45.st2@localhost.localdomain> <20030426103416.GA407@nitro.dk>
next in thread | previous in thread | raw e-mail | index | archive | help
--GPJrCs/72TxItFYR Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Apr 26, 2003 at 12:34:17PM +0200, Simon L. Nielsen wrote: > On 2003.04.25 16:46:18 -0700, Gary W. Swearingen wrote: >=20 > > 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. >=20 > 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. >=20 > If the category is not there it would also make it harder to make links > to the port e.g. in man.cgi. >=20 > 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 Not, it's not OK with others. Writing a simple script that finds all port references and checks this with the fresh ports/ tree is not that hard. I've been planning on setting the manpages tinder box; adding this feature to it would be trivial. Cheers, --=20 Ruslan Ermilov Sysadmin and DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age --GPJrCs/72TxItFYR Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+qm5KUkv4P6juNwoRAkkzAJ92eFhPKSDgPOMf1F12E7t40OwX/wCfV784 UHC9LjroIcoVuCDyvRBoNXs= =ereY -----END PGP SIGNATURE----- --GPJrCs/72TxItFYR--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030426113227.GC9189>