handbook to allow it to be incorporated in the build. This is not on by
default at the moment, and users who want it will need to set WITH_GLOSSARY
to a non-empty string when building ("make WITH_GLOSSARY=yes" being the
common case).
It is expected that committers will help to flesh out the glossary before
it is connected to the build by default; the current entries have been chosen
to illustrate the way that DocBook allows for "See also" and "See" in the
glossary elements.
This commit also takes the index out of the appendices in the handbook, as
this is not the usual place for an index to sit in a book, and moves it to
the end of the book.
- Add trademark attributions.
- Don't join trademarks with other words, e.g. using hyphens.
- Don't use trademarks as nouns (e.g. don't use "Windows NT's").
required symbols, by setting the make variable
WITH_ALL_TRADEMARK_SYMBOLS, to any non empty value.
This feature is mainly useful for document writers, to make sure all
trademarks are marked up correctly.
- 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.
- Various punctuation fixes
- Use of application, literal, acronym tags where needed
- s/I/We
- s/id/ID to be consistent with the rest of docs
- Some "little rewordings".
o Adds <application>, <acronym>, and other tags as required.
o Uses the &os; entity.
o Cleans up the introduction by pointing out what
version of Kerberos is in what FreeBSD Release.
o Modifies <indexterm> and titles to help seperate
KerberosIV and Kerberos5.
Reviewed by: -doc, make lint
an unnecessary colon.
o If X is the chief weakness of something, then it actually is the most
important one. Remove some confusing text from a sentence.
I have not replaced them with anything, as there is an appendix on configuring
CVSup already, with links to it appearing directly above the deleted text.
- Remove a para about "troubles" with 4.3-STABLE, this is outdated and
confusing.
- Remove the version number of linux_base port.
- Rename "Linux Development" to "Linux Development Environment"
- Add a link to Oracle installation
- make install distclean is a better choice than make package to install
a port
- Some rewordings, application tags addition, and other tags and manual
page entities fixes.
