Date: Fri, 2 Apr 2004 02:27:26 +0100 From: Ceri Davies <ceri@FreeBSD.org> To: "Simon L. Nielsen" <simon@FreeBSD.org> Cc: eik@FreeBSD.org Subject: Re: docs/64144: [patch] document procedure to add a new ports category to Committer's Guide Message-ID: <20040402012725.GJ771@submonkey.net> In-Reply-To: <20040330223025.GF749@arthur.nitro.dk> References: <20040330201210.GA749@arthur.nitro.dk> <Pine.LNX.4.44.0403301414120.2870-100000@pancho> <20040330223025.GF749@arthur.nitro.dk>
next in thread | previous in thread | raw e-mail | index | archive | help
--XiX5sJQOWZsNRXst Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable [Note: dropped gnats from the cc: list] On Wed, Mar 31, 2004 at 12:30:26AM +0200, Simon L. Nielsen wrote: > On 2004.03.30 14:26:30 -0600, Mark Linimon wrote: > > On Tue, 30 Mar 2004, Simon L. Nielsen wrote: > > > + the <filename class=3D"directory">ports/</filename> directory,= run > >=20 > > OK, that's the first I've seen of this. >=20 > Well, it don't think we (doc people) have been aware that the class > existed for very long. Ceri has mentioned at least once, on some > mailing list. >=20 > It's not terribly important, as nothing actually uses it at the moment > and as you noted in another mail - a lot of existing docs doesn't use > it. For new content we might as well add it, since we might find some > use for it at some point. That's pretty much exactly what I said regarding this. It's just some markup that I noticed while reading the DocBook book on the train one day while planning the glossary (see below for some more thought on that) and I figured that while there's no point doing a sweep at the moment, we may as well add it in new content (or if working in the general area). Regarding the glossary, how does everyone think that's working out? I notice that it's been short of attention recently and wanted to check that people still think it's a nice idea before I do some work on it. My current thinking at the moment is to do away with the FreeBSD-specific aspect and make it more general, then fiddle the stylesheets to create links to the glossary term for firstterm and acronym elements (once I've worked my way through Teach Yourself Scheme in Fixnum Days [1]) and, perhaps, eventually one day it will be an error to add one of those elements without a matching glossary entry. Much as I love it when a plan comes together, this will probably take a while, and I want to check the water before I dive in. Ceri [1] http://www.ccs.neu.edu/home/dorai/t-y-scheme/t-y-scheme.html for those who may be interested. --=20 --XiX5sJQOWZsNRXst Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFAbMF9ocfcwTS3JF8RAkYXAJ9xqG/sPQNS/HmhCDwo9SH5XSNMdwCfX9YZ mlrdv8XhG3+D9tZuhikInTs= =3mlC -----END PGP SIGNATURE----- --XiX5sJQOWZsNRXst--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040402012725.GJ771>