From owner-freebsd-doc Wed Apr 25 22: 7:41 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ruhr.de (in-ruhr4.ruhr.de [212.23.134.2]) by hub.freebsd.org (Postfix) with SMTP id D172837B424 for ; Wed, 25 Apr 2001 22:07:36 -0700 (PDT) (envelope-from ue@nathan.ruhr.de) Received: (qmail 7384 invoked by uid 10); 26 Apr 2001 05:07:35 -0000 Received: (from ue@localhost) by nathan.ruhr.de (8.11.3/8.11.2) id f3Q594h94072; Thu, 26 Apr 2001 07:09:04 +0200 (CEST) (envelope-from ue) Date: Thu, 26 Apr 2001 07:09:03 +0200 From: Udo Erdelhoff To: "Bruce A. Mah" Cc: Dima Dorfman , Nik Clayton , doc@FreeBSD.ORG Subject: Re: rel.current entity for www/en a la Handbook Message-ID: <20010426070903.I84165@nathan.ruhr.de> Mail-Followup-To: "Bruce A. Mah" , Dima Dorfman , Nik Clayton , doc@FreeBSD.ORG References: <20010426004544.EAD9F3E2A@bazooka.unixfreak.org> <200104260336.f3Q3al231164@bmah-freebsd-0.cisco.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="3eH4Qcq5fItR5cpy" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <200104260336.f3Q3al231164@bmah-freebsd-0.cisco.com>; from bmah@FreeBSD.ORG on Wed, Apr 25, 2001 at 08:36:47PM -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --3eH4Qcq5fItR5cpy Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi Bruce, On Wed, Apr 25, 2001 at 08:36:47PM -0700, Bruce A. Mah wrote: > At this point in time, there is only one FAQ, one Handbook, and so on. = =20 > So these documents have only a single notion of what &rel.current;=20 > should be (right now, it's 4.3-RELEASE). Yes and no. Several weeks or even months ago, Nik posted a set of patches to generate version-specific versions of the FAQ. He had similar issues there, a look into the patches (which I can't find right now) might yield an avenue of approach. Another idea is to use the model for the translations, especially the use and abuse of $LANGCODE. I've done some experiments with legalnotice.sgml in a checked-out copy of the German repository. This copy contains all the documents living in /usr/doc/de_DE.ISO_8859-1 and if I set LANGCODE to de_DE.ISO_8859-1, the makefileis will use the "official" version. If I wanted to use my copy of legalnotice.sgml I set LANGCODE to =2E./../home/ue/Sources/de-docproj and started make. Yes, I'm a pervert. The effect to changing LANGCODE is a change of the parameters for jade. If you generate the html version of an article, jade is called as: jade -c $DOCDIR/$LANGCODE/share/sgml/catalog . You should be able to use a similar mechanismn for the release notes. Slap all version-specific stuff into one sourcefile called defs.sgml. Create a set of directories, one per supported version of the release notes, add catalogs. And use an environment variable to switch directories at compile time, passing -c $RELNOTESROOT/$VERSION/catalog as the first -c argument to jade. > How's that? Just my $0.02. /s/Udo --=20 Ich bin root, ich darf das. --3eH4Qcq5fItR5cpy Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.4 (FreeBSD) Comment: For info see http://www.gnupg.org iQCVAwUBOuetb0Poh1XnT6hxAQEjTwQAm5YBdv1EH7Sn0lJuhY9Evcl1+kh7u9RM YiYA5QWqVY9iAnEJtOR2T423h76SR8ZbtvhOQrItXRVMdvdifc7P+SxJDEAzR3N+ O7A+8pl8qGnweQUnTqFGwHRCd+ZF0xzpF6H+XM+nqrtxXr9ZTapJpxX85GvIEsrV RKLImScxJE0= =cuGa -----END PGP SIGNATURE----- --3eH4Qcq5fItR5cpy-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message