Currently we have articles.ent and books.ent, and
for example, articles.ent can be used by putting the
following lines in the doctype declaration:
<!ENTITY % articles.ent PUBLIC
"-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
%articles.ent;
This pulls all of the necessary entities via share/sgml/articles.ent.
The translation teams can customize these entities by redefining
the articles.ent file in <langcode>/share/sgml. See
ja_JP.eucJP/share/sgml for example.
. Use better visible name for Using CVSup section
. Use 1.3.1-patchset9 as referencing patchset
. Use linux-sun-jdk1.3.1's build 10 for references.
. Use tomcat 4.0.6 for references
. Do not mention hand handling dependencies for gtar, bzip2, etc.
These are handled automatically these days.
XXX: article need to be updated to cover least following things:
. enable linux emulation via kernel module loading
. notice possiblities to build jdk13 without plugin, etc. This
is useful in server only environment.
. it should mention jdk14 as one of choices
- Use trademark entities
- Add trademark attributions.
- Always use correct case for trademarks.
- Don't join trademarks with other words, e.g. using hyphens.
trademark.ent:
- Add entities for more trademarks / companies.
- Sort the Sun trademark attribution entity.
enable it in en_US.ISO8859-1/ and ja_JP.eucJP/.
- Add PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN"
and l10n.ent for entity localization.
- Use share/misc/docbook.css for indentiation of <programlisting>
and <screen>.
- Add some missing $FreeBSD$.
translators can ignore them.
In the future, please use tabs for 8 spaces and two spaces after a
period. This should be in the FDP Primer if it's not already (it's
been beaten to death on -doc a few times over the years).
