From owner-freebsd-doc Wed Apr 25 2:44:46 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-141-hy.blueyonder.co.uk [62.31.42.141]) by hub.freebsd.org (Postfix) with ESMTP id 09CE637B43C; Wed, 25 Apr 2001 02:44:35 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id f3P9i1c81381; Wed, 25 Apr 2001 10:44:01 +0100 (BST) (envelope-from nik) Date: Wed, 25 Apr 2001 10:44:00 +0100 From: Nik Clayton To: www@freebsd.org, dd@freebsd.org Cc: doc@freebsd.org Subject: Re: rel.current entity for www/en a la Handbook Message-ID: <20010425104400.A81151@canyon.nothing-going-on.org> References: <20010425080356.D33653E2C@bazooka.unixfreak.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="dDRMvlgZJXvWKvBx" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010425080356.D33653E2C@bazooka.unixfreak.org>; from dima@unixfreak.org on Wed, Apr 25, 2001 at 01:03:56AM -0700 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --dDRMvlgZJXvWKvBx Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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!). Makes sense. > Any objections to me committing this some time this week? A couple of comments on the patch; > + > + > + > > -'> > -'> > +'> > +'> > +'> I think we should standardise these across the doc/ and www/ trees. As it stands, I'm not happy with a.latest.not and a.latest.ann, those should be spelled out in full (a.latest.notes, a.latest.announce). There's a "problem" with your entity definitions. You haven't included the ';' at the end of "&base". This won't generate an error, because the SGML parser 'knows' that '/' is not a valid character in an entity name, so it closes it for you, but it's questionable practice, and may confuse people who know less about SGML wondering why we use ';' in some cases and not in others. Best to be completely consistent. Rather than being anchors, perhaps they should just be URLs, so the lines become something like ... Perhaps "u.release." would be a better 'root' for the entity names? > =20 > Index: index.sgml > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > RCS file: /st/src/FreeBSD/www/en/index.sgml,v > retrieving revision 1.110 > diff -u -r1.110 index.sgml > --- index.sgml 2001/04/22 05:22:04 1.110 > +++ index.sgml 2001/04/25 02:45:01 > @@ -131,13 +131,13 @@ > > > > - > + Guide · &a.latest.errata;Errata > + > + > >
Current Release: 4.3 > - - href=3D"&base;/releases/4.3R/announce.html">An= nouncement > + Current Release: &rel.curr= ent;
> + &a.latest.ann;Announcement That line would become Announcement and similarly for the others. > · href=3D"&base;/handbook/install.html">Instal= lation > - Guide · - href=3D"&base;/releases/4.3R/errata.html">Er= rata
> > Index: releases/index.sgml > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > RCS file: /st/src/FreeBSD/www/en/releases/index.sgml,v > retrieving revision 1.53 > diff -u -r1.53 index.sgml > --- releases/index.sgml 2001/04/22 17:49:53 1.53 > +++ releases/index.sgml 2001/04/25 02:45:02 > @@ -16,11 +16,11 @@ > >

Current Release(s)

> =20 > -

Release 4.3 (April, 2001) > +

Release &rel.current; (April 2001) > > -Announcement : > -Release Notes : > -Errata > +Announcement : > +Release Notes : > +Errata And this would change similarly. N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ FreeBSD Documentation Project http://www.freebsd.org/docproj/ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- --dDRMvlgZJXvWKvBx 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 iEYEARECAAYFAjrmnGAACgkQk6gHZCw343U/jQCePLpYTQcpY7ELRscQMedUSwA/ 1HQAn2Tsq3qLoOB2YttY/BpoDG5Xzur/ =J/VY -----END PGP SIGNATURE----- --dDRMvlgZJXvWKvBx-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message