Date: Tue, 21 Jan 2003 08:51:09 -0800 From: "Bruce A. Mah" <bmah@FreeBSD.ORG> To: Udo Erdelhoff <ue@nathan.ruhr.de> Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Adding a publication date to the installation instructions Message-ID: <200301211651.h0LGp9nS001708@intruder.bmah.org> In-Reply-To: <20030120205441.GC173@nathan.ruhr.de> References: <20030120205441.GC173@nathan.ruhr.de>
next in thread | previous in thread | raw e-mail | index | archive | help
--==_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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200301211651.h0LGp9nS001708>