From owner-cvs-all Thu Jun 20 14:35:41 2002 Delivered-To: cvs-all@freebsd.org Received: from sccrmhc01.attbi.com (sccrmhc01.attbi.com [204.127.202.61]) by hub.freebsd.org (Postfix) with ESMTP id 971F437B43C; Thu, 20 Jun 2002 14:35:18 -0700 (PDT) Received: from bmah.dyndns.org ([12.233.149.189]) by sccrmhc01.attbi.com (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20020620213517.QZIM1024.sccrmhc01.attbi.com@bmah.dyndns.org>; Thu, 20 Jun 2002 21:35:17 +0000 Received: from intruder.bmah.org (localhost [IPv6:::1]) by bmah.dyndns.org (8.12.3/8.12.3) with ESMTP id g5KLZHkR009393; Thu, 20 Jun 2002 14:35:17 -0700 (PDT) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.3/8.12.3/Submit) id g5KLZHTA009392; Thu, 20 Jun 2002 14:35:17 -0700 (PDT) (envelope-from bmah) Message-Id: <200206202135.g5KLZHTA009392@intruder.bmah.org> X-Mailer: exmh version 2.5+ 20020506 with nmh-1.0.4 To: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Cc: "Bruce A. Mah" 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 In-Reply-To: <200206202119.g5KLJo476530@freefall.freebsd.org> References: <200206202119.g5KLJo476530@freefall.freebsd.org> Comments: In-reply-to "Bruce A. Mah" message dated "Thu, 20 Jun 2002 14:19:49 -0700." From: "Bruce A. Mah" Reply-To: bmah@FreeBSD.org X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_-1922430465P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Thu, 20 Jun 2002 14:35:17 -0700 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --==_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