Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 20 Sep 2001 07:55:19 -0700
From:      bmah@freebsd.org (Bruce A. Mah)
To:        freebsd-doc@freebsd.org
Cc:        bmah@freebsd.org
Subject:   RFC:  Web site changes for multiple relnotes files
Message-ID:  <200109201455.f8KEtJX27060@c527597-a.cstvl1.sfba.home.com>

next in thread | raw e-mail | index | archive | help
--==_Exmh_-978236156P
Content-Type: text/plain; charset=us-ascii

Hi folks--

Could someone skim over this Web site patch?  I'd like to commit it 
later today (California time) if possible.

As has been (very correctly) pointed out to me, we should make available
the alpha architecture release notes for 4.4-RELEASE on the Web site.
There's a very little bit of XSL/SGML infrastructure changes needed to
support multiple release notes files (with some attempt at backward
compatability).  A patch for this is appended below, assuming
the following additional CVS operations to frob content files:

	cvs rm en/releases/4.4R/notes.sgml
	cvs add en/releases/4.4R/relnotes-alpha.html
	cvs add en/releases/4.4R/relnotes-i386.html

My test builds worked, but given my Neanderthal-level knowledge of XSL,
I'd feel more comfortable with another pair of eyes on the patch too.

Thanks!

Bruce.

Index: en/includes.sgml
===================================================================
RCS file: /home/ncvs/www/en/includes.sgml,v
retrieving revision 1.45
diff -u -r1.45 includes.sgml
--- en/includes.sgml	2001/09/19 18:14:43	1.45
+++ en/includes.sgml	2001/09/20 14:37:32
@@ -74,7 +74,10 @@
 <!ENTITY rel.current '4.4'>
 
 <!-- URLs to information on the latest release -->
-<!ENTITY u.rel.notes '&base;/releases/&rel.current;R/notes.html'>
+<!-- u.rel.notes is deprecated; use architecture-specific entities -->
+<!ENTITY u.rel.notes '&base;/releases/&rel.current;R/relnotes-i386.html'>
+<!ENTITY u.rel.relnotes.alpha '&base;/releases/&rel.current;R/relnotes-alpha.html'>
+<!ENTITY u.rel.relnotes.i386 '&base;/releases/&rel.current;R/relnotes-i386.html'>
 <!ENTITY u.rel.announce '&base;/releases/&rel.current;R/announce.html'>
 <!ENTITY u.rel.errata '&base;/releases/&rel.current;R/errata.html'>
 
Index: en/includes.xsl
===================================================================
RCS file: /home/ncvs/www/en/includes.xsl,v
retrieving revision 1.3
diff -u -r1.3 includes.xsl
--- en/includes.xsl	2001/09/19 19:07:58	1.3
+++ en/includes.xsl	2001/09/20 14:37:32
@@ -79,9 +79,14 @@
   </xsl:variable>
   
   <xsl:variable name="rel.current" select="4.4"/>
+
+  <!-- u.rel.notes is deprecated; use architecture-specific entities -->
   <xsl:variable name="u.rel.notes">
     <xsl:value-of select="$base"/>/releases/<xsl:value-of select="$rel.current"/>R/notes.html</xsl:variable>
-
+  <xsl:variable name="u.rel.relnotes.alpha">
+    <xsl:value-of select="$base"/>/releases/<xsl:value-of select="$rel.current"/>R/relnotes-alpha.html</xsl:variable>
+  <xsl:variable name="u.rel.relnotes.i386">
+    <xsl:value-of select="$base"/>/releases/<xsl:value-of select="$rel.current"/>R/relnotes-i386.html</xsl:variable>
   <xsl:variable name="u.rel.announce">
     <xsl:value-of select="$base"/>/releases/<xsl:value-of select="$rel.current"/>R/announce.html</xsl:variable>
   <xsl:variable name="u.rel.errata">
Index: en/index.xsl
===================================================================
RCS file: /home/ncvs/www/en/index.xsl,v
retrieving revision 1.6
diff -u -r1.6 index.xsl
--- en/index.xsl	2001/08/23 14:03:49	1.6
+++ en/index.xsl	2001/09/20 14:37:33
@@ -335,7 +335,7 @@
 			
 			    <small>&#183; <a href="{$u.rel.announce}">Announcement</a><br/>
 			      &#183; <a href="{$base}/doc/en_US.ISO8859-1/books/handbook/install.html">Installation Guide</a><br/>
-			      &#183; <a href="{$u.rel.notes}">Release Notes</a><br/>
+			      &#183; Release Notes (<a href="{$u.rel.relnotes.alpha}">alpha</a>, <a href="{$u.rel.relnotes.i386}">i386</a>)<br/>
 			      &#183; <a href="{$u.rel.errata}">Errata</a></small></p>
 
 			  <p><font size="+1" color="#990000"><b>Project News</b></font><br/>
Index: en/releases/index.sgml
===================================================================
RCS file: /home/ncvs/www/en/releases/index.sgml,v
retrieving revision 1.62
diff -u -r1.62 index.sgml
--- en/releases/index.sgml	2001/09/19 18:14:43	1.62
+++ en/releases/index.sgml	2001/09/20 14:37:35
@@ -19,7 +19,8 @@
 <p><b>Release &rel.current;</b> (September 2001)
 <em>
 <a href="&u.rel.announce;">Announcement</a> :
-<a href="&u.rel.notes;">Release Notes</a> :
+Release Notes (<a href="&u.rel.relnotes.alpha;">alpha</a> :
+<a href="&u.rel.relnotes.i386;">i386</a>) :
 <a href="&u.rel.errata;">Errata</a>
 </em></p>
 
Index: en/releases/4.4R/Makefile
===================================================================
RCS file: /home/ncvs/www/en/releases/4.4R/Makefile,v
retrieving revision 1.3
diff -u -r1.3 Makefile
--- en/releases/4.4R/Makefile	2001/09/20 00:15:00	1.3
+++ en/releases/4.4R/Makefile	2001/09/20 14:37:36
@@ -7,9 +7,11 @@
 .include "../Makefile.inc"
 .endif
 
-DOCS=	announce.sgml notes.sgml
+DOCS=	announce.sgml
 
 DATA=	docbook.css
 DATA+=	errata.html
+DATA+=	relnotes-alpha.html
+DATA+=	relnotes-i386.html
 
 .include "${WEB_PREFIX}/share/mk/web.site.mk"





--==_Exmh_-978236156P
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (FreeBSD)
Comment: Exmh version 2.3.1+ 05/14/2001

iD8DBQE7qgNX2MoxcVugUsMRAoN8AKDkq5ebtNI9UkoMy02im76DtFDJXgCeLSNY
M/4JaBLaxPF0ATaUF5O8sgM=
=zWIQ
-----END PGP SIGNATURE-----

--==_Exmh_-978236156P--

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?200109201455.f8KEtJX27060>