- 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.
- Correct path to the FAQ.
- Add &base; to a few links.
- Change a link to the tutorials page, to the general documentation page,
since the tutorials page just redirects to the documentation page. [1]
Submitted by: Josef El-Rayes <j.el-rayes@daemon.li> [1]
PR: www/57032 [1]
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
out, and spot inconsistencies.
By God that was painful. And I'm not finished yet -- this commit just gets
the files into a semblence of order. Now I have to go through them
excising all the dodgy HTML practices, and doing a consistency check.
Argh!
Translators, you can ignore this commit.
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.
referencing the -doc list in an attempt to encourage people to
send -questions to -questions.
Remove the reference to freebsd-info@FreeBSD.ORG until it actually
does something.
PR: docs/6597
Submitted by: Sue Blake <sue@welearn.com.au> (in excellent diff(1) form! :)
that were revealed. Note: I didn't go through all of
the tutorials, so there is still some work to be
done here.
Made mailing addresses consistent with the handbook.
E.g:
freebsd-questions@FreeBSD.ORG
instead of:
questions@freebsd.org
Yes, this is supposed to be a new top level in the repository.
For the moment any changes to this area must be cleared by myself
or Jordan. Once the kinks are worked out, the policy will probably
be relaxed.