From owner-freebsd-doc Wed Sep 26 4:52:25 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140]) by hub.freebsd.org (Postfix) with ESMTP id 75F3037B40F for ; Wed, 26 Sep 2001 04:52:20 -0700 (PDT) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id f8QBeTR57928; Wed, 26 Sep 2001 12:40:29 +0100 (BST) (envelope-from nik) Date: Wed, 26 Sep 2001 12:40:29 +0100 From: Nik Clayton To: Giorgos Keramidas Cc: doc@freebsd.org Subject: Re: RFC: tags and use of class="directory" attribute Message-ID: <20010926124029.R31744@clan.nothing-going-on.org> References: <20010926121908.A23272@hades.hell.gr> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="dFvuq/4WPi1dbS7Q" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010926121908.A23272@hades.hell.gr>; from charon@labs.gr on Wed, Sep 26, 2001 at 12:19:08PM +0300 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --dFvuq/4WPi1dbS7Q Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Sep 26, 2001 at 12:19:08PM +0300, Giorgos Keramidas wrote: > [ A few bits of DocBook anal-retentiveness. ] >=20 > I noticed that there are places (very few, this is true) in the english > documentation that use the tag with it's class=3D"" attribute. > A little search in the DocBook DTD's showed that supports the > following classes: headerfile, devicefile, directory, libraryfile, symlin= k and > path. [...] > Is this done because it's preferred to avoid cluttering the SGML source w= ith > too much markup (or some other equally important reason)? (in which case,= those > few places that *do* use class=3D"" are better removed) If not, should I= go > through the docs and add proper class attributes to those tags= that > do not have them? In all honesty it's probably not worth the effort. falls in to roughly the same category as things like or . It's nice if people make the effort to use them, but we're not going to lose sleep if they're ommitted. If you've got the spare time and are looking for a nice simple project then by all means go and do it, the patch certainly won't be turned down. But it's not something I'd consider to be top priority. [ Just my opinion, of course ] N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ FreeBSD Documentation Project http://www.freebsd.org/docproj/ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- --dFvuq/4WPi1dbS7Q Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjuxvq0ACgkQk6gHZCw343XUxACfR+SFTa3ka3m6V1A3oagj4gt9 IzYAn1JUBcSKLe6IhHhcTR2nqjykeQIs =UGKq -----END PGP SIGNATURE----- --dFvuq/4WPi1dbS7Q-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message