confusion.
Rationale: The ISO 8879 (SGML) specification defines this as
case-insensitive and it must always be treated as one in the upper case
when the SGML declaration does not include "NAMECASE GENERAL NO."
On the other hand, in the XML specification (REC-xml-20040204)
it is case-sensitive and no normalization with regard to the case
must not be performed by an XML parser. We use HTML 4.01 (SGML) DTD
in most of the files in the www tree and convert them into XHTML
1.0 (XML) DTD forcibly by using tidy. So, as long as we use both
SGML and XML DTD in this way it is better to use upper case only
for the id attribute to avoid the case sensitivity problem.
New test "releases" should have their version numbers bumped in
share/sgml/includes.release.*, and the whole thing is easily
turn-off-and-on-able via knobs in the same files.
Discussed with: re (scottl)
can be found, i.e., http://www.FreeBSD.org/cgi at the moment.
This allows for easier pre-commit testing of CGI scripts, and avoids
SNAFUs with an incorrect URL being committed, as has happened a couple
of times recently.
en/ should be fully converted with this commit; other languages need to
be updated, but are in mid merge molasses at present so I have not
touched them.
- add doc.common.mk, which defines variables, targets, and
dependencies commonly used in www/ and doc/.
- move www/<lang>/includes.xsl to the language independent
directory and split into several files.
- add transtable*.xsl and transtable.xml to support localized
mirror names.
- make doc/{en_US.ISO8859-1,ja_JP.eucJP}/books/handbook/ use
mirrors.xml (mirrors and eresources).
- make www/{en,ja}/index.xsl use mirrors.xml.
For details, please see doc/share/sgml/README.mirrors for the moment.
Reviewed by: simon and Alex Dupre <sysadmin@alexdupre.com>
