- 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.
kind of decision so we can help on this part. [1]
- We no longer suggest to send attach in mailing list, because the list
usually like to strip it. Change the suggest with different choices to:
*Put your attach in website.
*copy-n-paste in http://freebsd-gnome.pastebin.com/
*send-pr with attach
Modify the FreeBSD GNOME FAQ and bug report are on the way too.
Discussed with: marcus
Written by: marcus [1]
new fancypants FreeBSD/GNOME-specific one.
Note that the index.html and newsflash.html pages haven't been updated
because I can't figure out the magic XSL incantation to make them read
in the new includes.navgnome.sgml.
- use <h2> instead of <h3> for section headers to be consistent with
docs/porting.sgml;
- wrap list entries into <p>...</p>, so that there is a line break
between them;
- reword in some places.
