Copy stable/9 to releng/9.3 as part of the 9.3-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

MFC r260653 (partial), r260655:

r260653 (hrs):
Add missing footer due to DSSSL->XSLT migration and use XML
catalog to resolve URI

r260655 (hrs):
Add missing arch= and revision= support.

Sponsored by: The FreeBSD Foundation

MFC r250746 and r250805:

- Update the release notes to DocBook 4.5 XML to build with the
updated documentation tree
- Fix build after doc/projects/xml-tools integration.

MFC r241096:
- Rename .sgml files to .xml to track the recent doc changes

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by: re (implicit)

Bump version numbers and update descriptions for the 9-CURRENT
world. The %[no]include.historic knobs are removed because they
are not used for a long time.

Add support for auto-generating hardware notes entries in a
manner consistent with the new MI-style hardware notes document.

man2hwnotes.pl now defaults to generating entities for the MI-style
hardware notes (i.e. hardware/article.sgml). A new -c
option causes it to generate entities for the older MD-style
hardware notes (i.e. hardware/common/dev.sgml).

The Makefile infrastructure supplies the -c option to man2hwnotes.pl
now unless the HWNOTES_MI Makefile variable is defined, so
compatiblity is preserved for hardware notes translations that
aren't converted to the new organization yet. As translations
convert, they should define HWNOTES_MI in their hardware/Makefile.
When all the relevant translations catch up, the compatibility goop
in share/mk/doc.relnotes.mk and share/sgml/Makefile can be removed.

Thanks go to simon@ for help with the backwards compatiblity
mechanism.

Tested with: en_US.ISO8859-1, zh_CN.GB2312

- Add an -o option to specify the output file.
- Make "die()" more verbose.
- Do not put extra blank lines into the output file.
- Normalize text by using numeric entities because
some characters such as "'" can break the generated SGML.

Reviewed by: simon

Auto generate the device listings in the Hardware Notes based on
manual pages, to avoid duplicating work between the Hardware Notes and
manual pages.

Each text line in the output from the manual page parser is generated
as a SGML entity, making it possible for translators to only translate
lines which actually contains English text (this neat idea came from
hrs).

To determine which drivers are usable on which architectures the
dev.archlist.txt file is used to explicitly list this. It it an
imperfect solution, but the best I have been able to come up with for
now.

This commit converts most of the devices which has a section 4 manual
page with a HARDWARE section to be the new auto generated format.

Reviewed in principle by: ru, hrs, trhodes
Good ideas for improvements: hrs
No objections: -doc, re

Provide a way to keep out old ("historic") release notes from bloating
the size of the rendered release notes. By default, any element with
a role="historic" attribute won't get rendered in the output unless
the INCLUDE_HISTORIC Makefile variable is defined.

Language-dependent catalogs for RELNOTESng should override
the language-independent catalog.

Tested by: Alex Kapranoff <kapr@acm.org>

Better support for multi-lingual release documentation. We now support
language-dependant SGML catalogs (in ${LANG_CODE}/share/sgml) and also
use a default.dsl stylesheet similar to what the rest of the DocProj
documents use.

Requested by: hrs, Alex Kapranoff <kapr@acm.org>
Reviewed by: hrs, dd
MFC after: 2 days

Back out 1.6->1.7 change; this wasn't supposed to get committed.

New release notes: lpd(8) -c and -w, lpc(8) tclean, whois(1) recursive
lookups, moused(8) -a, binutils 2.11.2.

MFCs noted: IPv6 update.

Change the way the value of DESTDIR is determined for the release
notes build. Instead of having doc.relnotes.mk make a guess, hardcode
quite a bit (but as little as possible) in Makefile.inc's sprinkled
strategicly throughout the tree. This has the advantage of actually
working properly (which is a Good Thing(tm)), and the disadvantages of
more files in the repository and more hardcoded paths (which are both
Bad Things(tm)).

Don't hardcode in "/release/doc/"; instead, make it the default of a
new RELN_ANCHOR variable. It may be necessary to override this if the
path to the checked out release notes tree doesn't end with
"release/doc".

ISO_* -> ISO* rename

More RELNOTESng infrastructure fixup: The directory layout of
stylesheets (particularly with respect to translations) is now similar
to that of the doc/ tree. Added a customization for HTML page footers
(this is the only reader-visible change).

RELNOTESng infrastructure fixes:

1. There is now only one RELNOTESng stylesheet; the architecture-specific
stylesheets (to handle different values of the arch= attribute) are gone.

2. Several Makefile variable definitions were factored into
doc.relnotes.mk.

Submitted by: dd

Build system:
o Define a RELN_ROOT variable which points to the root of the relnotes
tree (i.e., src/release/doc).
o By default, define DOC_PREFIX in terms of RELN_ROOT; this gives a
bigger chance of finding the doc/ tree without help in the form of
setting DOC_PREFIX on the command line.
o Respect DOCDIR; `make install` works now.

Approved by: bmah