Date: Wed, 25 Apr 2001 01:03:56 -0700 From: Dima Dorfman <dima@unixfreak.org> To: www@freebsd.org, doc@freebsd.org Subject: rel.current entity for www/en a la Handbook Message-ID: <20010425080356.D33653E2C@bazooka.unixfreak.org>
next in thread | raw e-mail | index | archive | help
[ replies to -www, please, but keep me on the cc list ]
Greetings,
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!).
Attached is a patch to resurrect this idea. It goes further by making
a rel.current entity and defining a.latest.ann, a.latest.not, and
a.latest.errata in terms of it. It also changes various files that
refer to 4.3 explicitly to use the new entity. I think doing it this
way will ease the work for whoever is updating everything when a new
release comes out (probably jkh). It's still not as simple as
changing the numbers in the entity definition--particularly,
releases/index.sgml will still need to be updated manually--but I
think it goes a long way. At the very least it will avoid horribly
stale links (as I said, a.latest.ann points to 3.4 right now, and it
*is* used).
Any objections to me committing this some time this week?
Thanks,
Dima Dorfman
dima@unixfreak.org
Index: includes.sgml
===================================================================
RCS file: /st/src/FreeBSD/www/en/includes.sgml,v
retrieving revision 1.38
diff -u -r1.38 includes.sgml
--- includes.sgml 2001/04/21 21:03:23 1.38
+++ includes.sgml 2001/04/25 02:45:01
@@ -53,9 +53,16 @@
<!ENTITY footer '<HR NOSHADE>
<address>&author;<br>&date;</address>'>
+<!-- The currently released version of FreeBSD. This value is used to
+ create some links on web sites and such, so do NOT change it until
+ it's really release time, and don't forget to update a similar
+ definition in the Handbook. -->
+<!ENTITY rel.current '4.3'>
+
<!-- Short names for various anchor points -->
-<!ENTITY a.latest.not '<a href="&base/releases/3.4R/notes.html">'>
-<!ENTITY a.latest.ann '<a href="&base/releases/3.4R/announce.html">'>
+<!ENTITY a.latest.not '<a href="&base/releases/&rel.current;R/notes.html">'>
+<!ENTITY a.latest.ann '<a href="&base/releases/&rel.current;R/announce.html">'>
+<!ENTITY a.latest.errata '<a href="&base/releases/&rel.current;R/errata.html">'>
<!-- macro for webbuild paper -->
Index: index.sgml
===================================================================
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 @@
<td>
<table width="100%" cellpadding=2 cellspacing=0 border=0 bgcolor="#ffcc66">
<tr>
- <td align="center"><b>Current Release: 4.3</b><br>
- <small><a
- href="&base;/releases/4.3R/announce.html">Announcement</a>
+ <td align="center"><b>Current Release: &rel.current;</b><br>
+ <small>&a.latest.ann;Announcement</a>
· <a
href="&base;/handbook/install.html">Installation
- Guide</a> · <a
- href="&base;/releases/4.3R/errata.html">Errata</a></small></td>
+ Guide</a> · &a.latest.errata;Errata</a>
+ </small>
+ </td>
</tr>
</table>
</td>
Index: where.sgml
===================================================================
RCS file: /st/src/FreeBSD/www/en/where.sgml,v
retrieving revision 1.48
diff -u -r1.48 where.sgml
--- where.sgml 2001/04/22 05:50:59 1.48
+++ where.sgml 2001/04/25 02:45:01
@@ -38,8 +38,8 @@
href="ftp://ftp.FreeBSD.org/pub/FreeBSD">ftp://ftp.FreeBSD.org/pub/FreeBSD</a>:
<ul>
- <li><a href="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/alpha/4.3-RELEASE">FreeBSD 4.3-RELEASE/alpha</a></li>
- <li><a href="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/4.3-RELEASE">FreeBSD 4.3-RELEASE/i386</a></li>
+ <li><a href="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/alpha/&rel.current;-RELEASE">FreeBSD &rel.current;-RELEASE/alpha</a></li>
+ <li><a href="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/&rel.current;-RELEASE">FreeBSD &rel.current;-RELEASE/i386</a></li>
<li><a href="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/ISO-IMAGES/">FreeBSD ISO-IMAGES/i386</a></li>
<li><a href="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/alpha/ISO-IMAGES/">FreeBSD ISO-IMAGES/alpha</a></li>
</ul>
Index: releases/index.sgml
===================================================================
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 @@
<a name="current"></A>
<h2>Current Release(s)</h2>
-<p><b>Release 4.3</b> (April, 2001)
+<p><b>Release &rel.current;</b> (April 2001)
<em>
-<A HREF="./4.3R/announce.html">Announcement</A> :
-<A HREF="./4.3R/notes.html">Release Notes</A> :
-<A HREF="./4.3R/errata.html">Errata</A>
+<A HREF="./&rel.current;R/announce.html">Announcement</A> :
+<A HREF="./&rel.current;R/notes.html">Release Notes</A> :
+<A HREF="./&rel.current;R/errata.html">Errata</A>
</em></p>
<p>The latest daily release from our <A
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?20010425080356.D33653E2C>