src/release/doc/share/mk/doc.relnotes.mk, branch release/7.0.0_cvs

This commit was manufactured by cvs2svn to create tag

2008-02-24T05:45:17+00:00

'RELENG_7_0_0_RELEASE'.

This commit was manufactured to restore the state of the 7.0-RELEASE image.

Add support for auto-generating hardware notes entries in a

2007-02-16T02:10:12+00:00

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.

2004-08-08T09:23:49+00:00

- 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

2004-08-03T22:12:45+00:00

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

2002-06-20T21:19:49+00:00

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

2001-07-17T00:46:10+00:00

the language-independent catalog.

Tested by:	Alex Kapranoff

Better support for multi-lingual release documentation. We now support

2001-07-09T16:01:38+00:00

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 
Reviewed by:	hrs, dd
MFC after:	2 days

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

2001-07-04T17:53:48+00:00

New release notes: lpd(8) -c and -w, lpc(8) tclean, whois(1) recursive

2001-07-04T17:52:46+00:00

lookups, moused(8) -a, binutils 2.11.2.

MFCs noted:  IPv6 update.

Change the way the value of DESTDIR is determined for the release

2001-06-21T20:43:43+00:00

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)).