Date: Thu, 20 Jun 2002 14:35:17 -0700 From: "Bruce A. Mah" <bmah@FreeBSD.org> To: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Cc: "Bruce A. Mah" <bmah@FreeBSD.org> Subject: Re: cvs commit: src/release/doc/en_US.ISO8859-1/relnotes/common new.sgml relnotes.ent src/release/doc/share/mk doc.relnotes.mk src/release/doc/share/sgml release.dsl release.ent Message-ID: <200206202135.g5KLZHTA009392@intruder.bmah.org> In-Reply-To: <200206202119.g5KLJo476530@freefall.freebsd.org> References: <200206202119.g5KLJo476530@freefall.freebsd.org>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --]
If memory serves me right, "Bruce A. Mah" wrote:
> bmah 2002/06/20 14:19:49 PDT
>
> Modified files:
> release/doc/en_US.ISO8859-1/relnotes/common new.sgml
> relnotes.ent
> release/doc/share/mk doc.relnotes.mk
> release/doc/share/sgml release.dsl release.ent
> Log:
> 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.
The idea here is that something that was MFC-ed a couple years ago
(remember when we got rid of RSAREF?) will be taken for granted by most
relnotes consumers and probably doesn't need to show up in the
5.0-RELEASE documentation. But if someone really wants to see the whole
list, they have to option to do this.
After this commit, the PDF file for the 5-CURRENT i386 release notes
goes from 39 pages down to 17 pages, which is a length that somebody
might actually be willing to read.
In most cases, any relnotes item MFC-ed before 4.6-RELEASE is marked
as "historic".
I also forgot to mention that this idea came out of a discussion with
some of the doc/ committers, most of whom are actively involved in
translating the release documentation.
Cheers,
Bruce.
[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (FreeBSD)
Comment: Exmh version 2.5+ 20020506
iD8DBQE9EkqV2MoxcVugUsMRAm1FAKDO0VGWqeIKUsY1Z4TQNDP4/lDlsACcDxL0
2jZhmSJHKxiQjnIaVNuywxw=
=GrLM
-----END PGP SIGNATURE-----
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200206202135.g5KLZHTA009392>