From owner-freebsd-doc Wed Apr 25 17:45:48 2001 Delivered-To: freebsd-doc@freebsd.org Received: from bazooka.unixfreak.org (bazooka.unixfreak.org [63.198.170.138]) by hub.freebsd.org (Postfix) with ESMTP id B067537B42C; Wed, 25 Apr 2001 17:45:45 -0700 (PDT) (envelope-from dima@unixfreak.org) Received: from spike.unixfreak.org (spike [63.198.170.139]) by bazooka.unixfreak.org (Postfix) with ESMTP id EAD9F3E2A; Wed, 25 Apr 2001 17:45:44 -0700 (PDT) To: bmah@FreeBSD.ORG Cc: Nik Clayton , doc@FreeBSD.ORG Subject: Re: rel.current entity for www/en a la Handbook In-Reply-To: <200104251815.f3PIFKx56080@bmah-freebsd-0.cisco.com>; from bmah@FreeBSD.ORG on "Wed, 25 Apr 2001 11:15:20 -0700" Date: Wed, 25 Apr 2001 17:45:44 -0700 From: Dima Dorfman Message-Id: <20010426004544.EAD9F3E2A@bazooka.unixfreak.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org "Bruce A. Mah" writes: > If memory serves me right, Nik Clayton wrote: > > On Wed, Apr 25, 2001 at 01:03:56AM -0700, Dima Dorfman wrote: > > > In order to simplify trasitioning from one release to another, I think > > > the web site could use an entity similar to &rel.current; that the > > > Handbook uses. From looking at includes.sgml it looks like something > > > like this has been attempted (see a.latest.ann and a.latest.not > > > entities), but died off (the aforementioned entities still point to > > > 3.4!). > > Just for kicks, here's what RELNOTESng uses (see attachment), modulo > things like a $FreeBSD$ tag and some whitespace fixes. > > > I think we should standardise these across the doc/ and www/ trees. > > That sounds pretty reasonable. > > One thought I have is that RELNOTESng, which will live in src/, may need > to be kept separate because it's branched (in the CVS sense) and doc/ > and www/ are not. So I'd like to either use differently-named entities > or else have the ability to avoid including the file that defines the > release-related entities but still include some others (such as the > committers, manpages, etc.). How are you including the committers and manpages entities right now? Ideally, we would have something.ent which both relnotes and doc/ stuff would include; it'd contain things like rel.current, os, etc. This is a problem, however, because doc/ may not be accessable when relnotes are compiled. If the latter isn't true (i.e., the existence of doc/ is guaranteed), then having a generic entities file for this stuff would be nice. Dima Dorfman dima@unixfreak.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message