Date: Wed, 26 Sep 2001 12:40:29 +0100 From: Nik Clayton <nik@freebsd.org> To: Giorgos Keramidas <charon@labs.gr> Cc: doc@freebsd.org Subject: Re: RFC: <filename> tags and use of class="directory" attribute Message-ID: <20010926124029.R31744@clan.nothing-going-on.org> In-Reply-To: <20010926121908.A23272@hades.hell.gr>; from charon@labs.gr on Wed, Sep 26, 2001 at 12:19:08PM %2B0300 References: <20010926121908.A23272@hades.hell.gr>
next in thread | previous in thread | raw e-mail | index | archive | help
--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 <filename> tag with it's class=3D"" attribute. > A little search in the DocBook DTD's showed that <filename> 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 <filename> tags= that > do not have them? In all honesty it's probably not worth the effort. <filename class=3D"foo"> falls in to roughly the same category as things like <acronym> or <abbrev>. 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010926124029.R31744>