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>
next in thread | previous in thread | raw e-mail | index | archive | help
--==_Exmh_-1922430465P Content-Type: text/plain; charset=us-ascii 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. --==_Exmh_-1922430465P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.7 (FreeBSD) Comment: Exmh version 2.5+ 20020506 iD8DBQE9EkqV2MoxcVugUsMRAm1FAKDO0VGWqeIKUsY1Z4TQNDP4/lDlsACcDxL0 2jZhmSJHKxiQjnIaVNuywxw= =GrLM -----END PGP SIGNATURE----- --==_Exmh_-1922430465P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200206202135.g5KLZHTA009392>