DESTDIR. This avoids redundant information in the path when DOCDIR
points to some directory that already implies (or specifies) a certain
language. This is the case with the web site, where the release notes
are already installed under a language-specific directory. This
behavior is not being made mandatory because it might still be useful
to install all the translations in one directory, such as during
testing, or in a hypothetical release notes archive. Furthermore, it
is not being made the default because that breaks consistency with
stuff under doc/.
Reviewed by: bmah
1. Bring floppies.sgml section in-line into install.sgml, where it
makes more sense.
2. Slightly reorganize some sections of Installation section and
do some wordsmithing.
3. Update distribution layout to reflect RELNOTESng and new compat
distributions.
4. Update upgrade file list from 4-STABLE.
5. It's been a long time since 2.2.X; get rid of instructions dealing
with "new" handling of compatability slices and fix up other references
in the text.
6. Hunt down and kill emoticons with extreme prejudice. Try to
tone down the use of exclamation points.
7. Cross-reference new and improved Installation chapter in
Handbook.
8. Add a proper abstract for this document.
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)).
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
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
