Index: openacs-4/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml,v
diff -u -N -r1.20 -r1.21
--- openacs-4/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml	4 Jun 2006 00:45:37 -0000	1.20
+++ openacs-4/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml	17 Jul 2006 05:38:37 -0000	1.21
@@ -1,6 +1,6 @@
 <?xml version='1.0' ?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
-               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+               "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
 
 <!ENTITY % myvars SYSTEM "../variables.ent">
 %myvars;
@@ -33,7 +33,9 @@
   </sect2>
 END OF TEMPLATE -->
 
-<para>The ChangeLogs include an annotated list of changes <link linkend="changelog-latest">since the last release</link> and <link linkend="changelog">in the entire &majorversion;.&minorversion; release sequence.</link></para>
+<para>The ChangeLogs include an annotated list of changes (<xref
+linkend="changelog-latest"></xref>) since the last release and in the
+entire &majorversion;.&minorversion; release sequence <xref linkend="changelog"></xref>.</para>
 
   <sect2 id="release-notes-5-2-0">
     <title>Release 5.2.0</title>
@@ -78,7 +80,7 @@
       </listitem>
       <listitem>
         <para>For a complete change list, see the  Change list since
-          5.1.0 in <link linkend="changelog">Changelog</link>.</para>
+          5.1.0 in <xref linkend="changelog"></xref>.</para>
       </listitem>
     </itemizedlist>
    </sect2>
@@ -113,7 +115,7 @@
       </listitem>
       <listitem>
         <para>For a complete change list, see the  Change list since
-          5.0.0 in <link linkend="changelog">Changelog</link>.</para>
+          5.0.0 in <xref linkend="changelog"></xref>.</para>
       </listitem>
     </itemizedlist>
    </sect2>
@@ -381,23 +383,27 @@
     <para><ulink url="release-notes-4-5.html">Release Notes for 4.5</ulink></para>
   </sect2>
 
-<!-- skipping this until after 5.2.0; since the changelog resets with minor releases, changelog-latest = changelog
+<!-- skipping next sect2 id=changelog-latest until after 5.2.0; since the changelog resets with 
+     minor releases, changelog-latest = changelog
+-->
+
  
   <sect2 id="changelog-latest">
     <title>Changelog (most recent release only)</title>
     <programlisting><xi:include href="../../../../../ChangeLog-latest" xi:parse="text" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback>ChangeLog missing</xi:fallback></xi:include></programlisting>
 
   </sect2>
--->
 
-<!-- a changelog entry contains <if>; this will have to be escaped before it can be processed correctly
+
+<!-- &lt;if&gt; needs to be escaped, such as in changelog enteries 
+     before processing will validate
+-->
   <sect2 id="changelog">
     <title>Changelog for &releasebranch;</title>
 <programlisting>
 <xi:include href="../../../../../ChangeLog" xi:parse="text" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback>ChangeLog missing</xi:fallback></xi:include>
 </programlisting>
   </sect2>
--->
 
 
 </sect1>