From owner-freebsd-doc Tue Jan 21 8:51:15 2003 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1B96637B401 for ; Tue, 21 Jan 2003 08:51:14 -0800 (PST) Received: from sccrmhc02.attbi.com (sccrmhc02.attbi.com [204.127.202.62]) by mx1.FreeBSD.org (Postfix) with ESMTP id C95E243EB2 for ; Tue, 21 Jan 2003 08:51:11 -0800 (PST) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by sccrmhc02.attbi.com (sccrmhc02) with ESMTP id <2003012116511000200mkkmue>; Tue, 21 Jan 2003 16:51:11 +0000 Received: from intruder.bmah.org (localhost [IPv6:::1]) by bmah.dyndns.org (8.12.6/8.12.6) with ESMTP id h0LGp9A8001709; Tue, 21 Jan 2003 08:51:09 -0800 (PST) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.6/8.12.6/Submit) id h0LGp9nS001708; Tue, 21 Jan 2003 08:51:09 -0800 (PST) Message-Id: <200301211651.h0LGp9nS001708@intruder.bmah.org> X-Mailer: exmh version 2.5+ 20021120 with nmh-1.0.4 To: Udo Erdelhoff Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Adding a publication date to the installation instructions In-Reply-To: <20030120205441.GC173@nathan.ruhr.de> References: <20030120205441.GC173@nathan.ruhr.de> Comments: In-reply-to Udo Erdelhoff message dated "Mon, 20 Jan 2003 21:54:42 +0100." 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_2077230273P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Tue, 21 Jan 2003 08:51:09 -0800 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_2077230273P Content-Type: text/plain; charset=us-ascii If memory serves me right, Udo Erdelhoff wrote: > I just noticed that the installation instructions do not carry their > publication date (read: $FreeBSD$) inside them. This makes it rather > hard to check if the rendered version for the web site is still up > to date (comapred to the SGML version, that is). Proposed fix: Hi Udo-- This works well in the case that the content is contained in one file (such as for the readme, errata, or early adopter's guide). The problem with the installation instructions is that the content is scattered throughout several files and there is not any single $FreeBSD$ tag you (or anybody) can use to give the latest revision date for the document as a whole. One possibility might be to reorganize the content into a single file, *then* you can use the $FreeBSD$ tag in a meaningful way. I did this for the release notes some months ago. I *think* you can do this for the installation guide as well, and I wouldn't object to somebody doing this if it can be made to work. It can't be done for the hardware notes, because there are some MD files. Cheers, Bruce. PS. The installation guide is a bloody mess. At one point I thought it'd be cool to fold all of the MD content into the Handbook (so it could cover all architectures), and then somehow build the install chapter from the Handbook as a part of the release documentation set. I gave up, but that shouldn't prevent someone else from taking a shot at it. --==_Exmh_2077230273P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.0 (FreeBSD) Comment: Exmh version 2.5+ 20020506 iD8DBQE+LXp92MoxcVugUsMRAgvoAJ9I/wjGjRvnFsd5/7Jds+bUJKm3UQCg33bt /LiihtK1AFt4MweRA4Y3ttw= =0erH -----END PGP SIGNATURE----- --==_Exmh_2077230273P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message