- 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.
We haven't announced the release yet but the content is already
on the Web site, so adding a pointer to this won't really hurt.
Also it's one less thing to do when the time comes...
Not the release engineering team is responsible for
creating high quality packages but the ports management
team.
PR: www/94099
Submitted by: Kovesdan Gabor <gabor dot kovesdan at t-hosting dot hu>
Verified by: scotll
same naming scheme as that used by the doc/ repo.
Update docs.sgml to point to the documentation in this canonical location.
Update the FAQ/ and handbook/ directories to use symlinks to point to
the real documentation under doc/en_US.ISO_8859-1/. This means that local
testing of the site (and mirrors) will still work as expected using the
legacy URLs. Mirrors that expect to see a lot of traffic are advised to
alter their web server configuration so that $WEBROOT/FAQ and $WEBROOT/handbook
are redirected to $WEBROOT/doc/en_US.ISO_8859-1/books/{faq,handbook},
instead of relying on the symlinks.
Discussed on: doc, www
