- Move includes.nav*.sgml to share/sgml/navibar.ent and
<lang>/share/sgml/nabibar.l10n.ent.
- Move includes.sgml and includes.xsl to
share/sgml/common.ent, share/sgml/header.ent, <lang>/share/sgml/l10n.ent,
and <lang>?share/sgml/header.l10n.ent.
- Move most of XSLT libraries to share/sgml/*.xsl and
<lang>/share/sgml/*.xsl.
- Move news.xml and other *.xml files for the similar purpose
to share/sgml/*.xml and <lang>/share/sgml/*.xml.
- Switch to use a custom DTD for HTML document. Now we use
"-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension", which is
HTML 4.01 + some entities previously pulled via
"<!ENTITY % includes SYSTEM "includes.sgml"> %includes;" line.
The location of entity file will be resolved by using catalog file.
- Add DOCTYPE declearation to XML documents. This makes the followings
possible:
* Use of &foo; entities for SGML in an XML file instead of defining
{$foo} as the same content.
* &symbolic; entities for Latin characters.
- Duplicated information between SGML and XML, or English and
translated doc, has been removed as much as possible.
one in a comment; since the former is clearly visible from the top of
the file, the latter's only purpose was to bloat the repository a
little more.
No objections by: -doc, -www
server's directory index configuration to DTRT (i.e., link to
"ports/index.html" rather than "ports/"). This also makes it easier
for people without the desire to set up a web server to test changes
to the web site.
PR: 23230
Reviewed by: nik
HTML files (not all of them, just some of them).
Fix up the broken references to point to the correct files.
This has not touched the release notes in releases/*/*. I'm not sure
whether they should remain as historical record of what was shipped or
not. About 5 of them now have a couple of broken links each, which will
be trivial to fix.
docproj.sgml, and added a new 'docproj' directory which contains other
project related .sgml files (and a Makefile). Updated the main Makefile to
include this new directory.
Reviewed by the various members of the -doc mailing list (including
John Fieber) over the past week or so.
