Date: Mon, 9 Aug 2004 17:53:34 +0300 From: Peter Pentchev <roam@ringlet.net> To: Marc Fonvieille <blackend@freebsd.org> Cc: freebsd-doc@freebsd.org Subject: Re: Lowercase attribute names [Was: Re: small fix in the new-users article] Message-ID: <20040809145334.GD2150@straylight.m.ringlet.net> In-Reply-To: <20040809141954.GA78399@abigail.blackend.org> References: <20040806110848.GC704@vaio.lab> <20040809134320.GC2150@straylight.m.ringlet.net> <20040809141954.GA78399@abigail.blackend.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--VywGB/WGlW4DM4P8 Content-Type: text/plain; charset=windows-1251 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Aug 09, 2004 at 04:19:54PM +0200, Marc Fonvieille wrote: > On Mon, Aug 09, 2004 at 04:43:20PM +0300, Peter Pentchev wrote: > > On Fri, Aug 06, 2004 at 01:08:48PM +0200, Marco Trentini wrote: > > >=20 > > > In the last commit I've noted URL in upper case. > >=20 > > It seems that both <ulink url=3D".."> and <ulink URL=3D".."> are valid, > > and both of them are used quite often throughout the whole articles/ > > and books/ directories. According to "DocBook: The Definitive Guide", > > in SGML DocBook all element and attribute names are case-insensitive, so > > it's okay to keep them that way. > > >=20 > Always read the FDP first :) > All attribute examples use lower cases; the lowercase need is not > mentioned but examples can be used as information regarding the "right > way." Nowadays, "quite all" *ML things use lowercase for attributes. > > > However, Norman Walsch does warn that lowercase names should be used for > > XML DocBook. I'm not sure what the FreeBSD Documentation Project's > > stance is on XML compatibility and on eventually moving to XML DocBook; > > if this is the goal, then at some point we should do a search-and-repla= ce > > over most of the project's documents, since there are quite a few > > URL=3D".." attributes all over the place. What do people think about t= hat? >=20 > Well we should be consistent in our code, just to prevent someone to > think uppercase is what to use. Since there are few "guilty" attributes,= it > should be fixed. I think I may have misphrased my e-mail a bit :) IMHO, all elements and attributes should be lowercase, be it for standards compliance or simply for readability. Still, I wondered if there was some reason for the fact that nobody has changed the uppercase URL attributes to lowercase - either nobody had noticed (apparently that seems to be the case), or they were indeed acceptable and there was no need to change them. So... it would be okay for me to sweep the docs tree and change all element and attribute names (mostly ulink URL) to lowercase? G'luck, Peter --=20 Peter Pentchev roam@ringlet.net roam@cnsys.bg roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 I am jealous of the first word in this sentence. --VywGB/WGlW4DM4P8 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQFBF4/u7Ri2jRYZRVMRAkkiAJ4o383qbJDHPSCRsr4I77EbS7PGjwCbBKYT 8y3vvcooBkQlVICf9V/S9OU= =xHdO -----END PGP SIGNATURE----- --VywGB/WGlW4DM4P8--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040809145334.GD2150>