- 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
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
Trim release documentation and errata. While here, put back
some conditional text in the errata that was removed during
5.0-RELEASE and never put back.
Note that the previous commit message for this file should have read:
"4.8-RELEASE is the latest release from the 4-STABLE branch." [1]
Pointed out by: Stijn Hoop <stijn@win.tue.nl> [1]
Approved by re (implicitly)
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.
the release notes compare 5.0-CURRENT to 4.0-RELEASE, but in at least
one place it is beneficial to mention the last stable release of
FreeBSD (4.5-RELEASE).
Reviewed by: bmah
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
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)).
version control information that is different from the rest of their
containing document (or at least other sections). For release notes
only, allow output of <sect1info><pubdate></pubdate></sect1info>
text, and add it to three sections of RELNOTESng where it's kind of
important ("What's New" in the release notes, "Supported Device" in
the arch-independent hardware list, and the processors section of the
alpha hardware list).
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).
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
