Date: Wed, 26 Sep 2001 12:19:08 +0300 From: Giorgos Keramidas <charon@labs.gr> To: doc@freebsd.org Subject: RFC: <filename> tags and use of class="directory" attribute Message-ID: <20010926121908.A23272@hades.hell.gr>
index | next in thread | raw e-mail
[-- Attachment #1 --]
[ A few bits of DocBook anal-retentiveness. ]
I noticed that there are places (very few, this is true) in the english
documentation that use the <filename> tag with it's class="" attribute.
A little search in the DocBook DTD's showed that <filename> supports the
following classes: headerfile, devicefile, directory, libraryfile, symlink and
path.
The en_US.ISO8859-1 docs use class="" in very few places though (lines wrapped
for readability):
# lines `cut' at 78 characters, to avoid messy output on narrow terminals
$ cd ~/freebsd/doc/en_US.ISO8859-1
$ find . -type f -name \*.sgml |\
> xargs grep 'class="' /dev/null |\
> grep -v 'literallayout' |\
> grep -v '<tr'
./articles/dialup-firewall/article.sgml: class="directory">/etc/fire
./books/developers-handbook/introduction/chapter.sgml: <filename cl
./books/developers-handbook/x86/chapter.sgml: db '<div class=
./books/developers-handbook/x86/chapter.sgml: db 'cellspacing="0"
./books/developers-handbook/x86/chapter.sgml: db '<td class="n
./books/developers-handbook/x86/chapter.sgml: db '<td class="v
Is this done because it's preferred to avoid cluttering the SGML source with
too much markup (or some other equally important reason)? (in which case, those
few places that *do* use class="" 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?
-giorgos
[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (FreeBSD)
iD8DBQE7sZ2M1g+UGjGGA7YRAn/TAKC6ewv2/44G1+hH9qycoN45uRaNvwCcCdCd
Hi/n+ZcW2Mib+TfBRadi34g=
=lHnE
-----END PGP SIGNATURE-----
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010926121908.A23272>