From owner-freebsd-doc Mon Sep 24 15:33:23 2001 Delivered-To: freebsd-doc@freebsd.org Received: from c527597-a.cstvl1.sfba.home.com (c527597-a.cstvl1.sfba.home.com [24.176.204.87]) by hub.freebsd.org (Postfix) with ESMTP id 1964137B429; Mon, 24 Sep 2001 15:33:14 -0700 (PDT) Received: (from bmah@localhost) by c527597-a.cstvl1.sfba.home.com (8.11.6/8.11.6) id f8OMXC093762; Mon, 24 Sep 2001 15:33:12 -0700 (PDT) (envelope-from bmah) Message-Id: <200109242233.f8OMXC093762@c527597-a.cstvl1.sfba.home.com> X-Mailer: exmh version 2.5 07/13/2001 with nmh-1.0.4 To: Stephane.Legrand@bigfoot.com Cc: doc@FreeBSD.ORG, www@FreeBSD.ORG Subject: Re: About the new HTML files in www/en/releases/4.4R/ In-Reply-To: <20010925000748.E448@sequoia.mondomaineamoi.megalo> References: <20010925000748.E448@sequoia.mondomaineamoi.megalo> Comments: In-reply-to Stephane Legrand message dated "Tue, 25 Sep 2001 00:07:49 +0200." 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_1637110816P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Mon, 24 Sep 2001 15:33:12 -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --==_Exmh_1637110816P Content-Type: text/plain; charset=us-ascii If memory serves me right, Stephane Legrand wrote: > Some remarks about these new files : > > - the version numbers are different from the usual ones. > For instance, in errata.html, it is : > > "$FreeBSD: src/release/doc/en_US.ISO8859-1/errata/article.sgml,v 1.1.2.27 > 2001/09/23 22:57:48 bmah Exp $" > > instead of something like > > "$FreeBSD: www/en/releases/4.4R/errata.html,v 1.2 > 2001/09/23 22:57:48 bmah Exp $" > > Why ?? I turned off keyword substitution for these files in CVS. The html files in www/en/ releases/4.4R/ were generated from SGML files, and I thought it best to leave the ID strings intact so that people can see where the content came from (and what revision). Otherwise this information gets spammed with the date the generated HTML file was updated in the repository. Although the dates will bear a strong resemblance, the version numbers don't, and I bet I'd get a bunch of questions as to why the version numbers on the Web site don't match those in the RELNOTESng snapshots. > - the fact that the HTML files are no more generated makes difficult > any design changes. For instance, i can't add a navigation bar in > these pages without directly modifying the files. With SGML, the > &header; entity allows this without any change in the original > file. Any chance to revert to SGML format ? I found the old method (drop ASCII text in the middle of SGML) to be extremely inconvenient for updating the errata. I'm open to alternatives that don't make me do this. My goal for the release documents was to provide, verbatim, the same files that live in the distribution, in order to minimize confusion when people happen to see copies of the same document coming from multiple sources. Bruce. --==_Exmh_1637110816P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: Exmh version 2.3.1+ 05/14/2001 iD8DBQE7r7Sn2MoxcVugUsMRApASAKD+Q9amcIjn2y6m6MlrwsLPk4P6KQCdEufd 2Qfzxf5bz5+fmmlxlTWtffo= =vfHE -----END PGP SIGNATURE----- --==_Exmh_1637110816P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message