From 16178c54de24bac84a15861c7a736d14e489b2b1 Mon Sep 17 00:00:00 2001
From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Tue, 28 Aug 2007 10:46:06 +0000
Subject: [PATCH] Moved release-notes boilerplate into abstract and added links
 to online change history to release-notes and to README. Also made a minor
 correction to the README.BUILD file.

---
 xsl/README                               | 22 ++++++--
 xsl/README.BUILD                         |  4 +-
 xsl/RELEASE-NOTES.xml                    | 66 ++++++++++++++----------
 xsl/tools/xsl/build/doc-link-docbook.xsl |  1 +
 4 files changed, 61 insertions(+), 32 deletions(-)

diff --git a/xsl/README b/xsl/README
index 62ca6ec39..1ef913bc1 100644
--- a/xsl/README
+++ b/xsl/README
@@ -125,12 +125,26 @@ xhtml/        for producing XHTML
 ----------------------------------------------------------------------
 Changes
 ----------------------------------------------------------------------
-See the ChangeHistory.xml.zip file for a cumulative list of all changes.
-
 See the NEWS file for changes made since the previous release.
 
-See the RELEASE-NOTES.html or RELEASE-NOTES.txt or RELEASE-NOTES.pdf files
-for per-release cumulative summaries of significant user-visible changes.
+See the RELEASE-NOTES.html or RELEASE-NOTES.txt or RELEASE-NOTES.pdf
+files for per-release cumulative summaries of significant
+user-visible changes.
+
+For online access to a hyperlinked view of all changes made over
+the entire history of the codebase, see the following:
+
+  http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/?view=log
+
+WARNING: That above change history is a very long list and may
+take a long time to load/download.
+
+You can also create an XML-formatted "ChangeHistory.xml" copy of
+the complete change history for the codebase by running the
+following commands:
+
+  svn checkout https://docbook.svn.sf.net/svnroot/docbook/trunk/xsl
+  svn log --xml --verbose xsl > ChangeHistory.xml
 
 ----------------------------------------------------------------------
 Copyright information
diff --git a/xsl/README.BUILD b/xsl/README.BUILD
index a59bcc448..941269610 100644
--- a/xsl/README.BUILD
+++ b/xsl/README.BUILD
@@ -265,7 +265,7 @@ the stylesheets -- then you can ignore this "Part 2" section; the
 
      rm -f DOCBOOK-BUILD.LOG && \
      . ~/docbk.sh && \
-     $DOCBOOK_SVN/releasetools/build-clean && \
+     $DOCBOOK_SVN/buildtools/build-clean && \
      make all 2>&1 \
        XSLTENGINE=xsltproc \
        | tee DOCBOOK-BUILD.LOG && \
@@ -385,7 +385,7 @@ you're not a project member, you can safely ignore this part.
 
      rm -f DOCBOOK-BUILD.LOG && \
      . ~/docbk.sh && \
-     $DOCBOOK_SVN/releasetools/build-clean && \
+     $DOCBOOK_SVN/buildtools/build-clean && \
      make all 2>&1 \
        XSLTENGINE=xsltproc \
        | tee DOCBOOK-BUILD.LOG && \
diff --git a/xsl/RELEASE-NOTES.xml b/xsl/RELEASE-NOTES.xml
index 08e978f0d..95a357dda 100644
--- a/xsl/RELEASE-NOTES.xml
+++ b/xsl/RELEASE-NOTES.xml
@@ -4,39 +4,53 @@
   xml:lang="en" xml:id="releasenotes"
   version="5.0">
 <info>
-  <title>Release Notes</title>
-  <subtitle>DocBook Project XSL Stylesheets</subtitle>
+  <title>Release Notes for the DocBook XSL Stylesheets</title>
   <pubdate><?dbtimestamp format="Y-m-d"?></pubdate>
   <releaseinfo role="cvs">$Revision$ $Date$</releaseinfo>
-  <author><orgname>DocBook Project Development Team</orgname></author>
-</info>
+  <!-- * <author><orgname>DocBook Project Development Team</orgname></author> -->
+
+<abstract>
+<para>These release notes for the DocBook XSL Stylesheets
+  distribution are available in the following formats:
+  <link
+    xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/reference.html"
+    >HTML</link>,
+  <link
+    xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/reference.pdf"
+    >PDF</link>,
+  <link
+    xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/reference.txt"
+    >plain text</link>. This document provides a per-release list
+of enhancements and changes to the stylesheets’ public APIs
+(user-configurable parameters) and excludes descriptions of most
+bug fixes. For a complete list of all changes (including all bug
+fixes) that have been made since the previous release, see the
+separate <link xlink:href="NEWS">NEWS</link> (plain text) or <link
+  xlink:href="NEWS.html">NEWS.html</link> files. Also available:
+An online <link
+  xlink:href="http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/?view=log"
+  >hyperlinked change history</link> (warning: big file) of all
+changes made over the entire history of the codebase.</para>
 
-<!-- * <para>These are the release notes for the DocBook XSL Stylesheets -->
-<!-- * distribution. This document provides an (incomplete) per-release list -->
-<!-- * of enhancements and changes to the stylesheets’ public APIs -->
-<!-- * (user-configurable parameters) and generally excludes descriptions of -->
-<!-- * bug fixes. For a complete list of all changes (including all bug -->
-<!-- * fixes) that have been made since the previous release, see the -->
-<!-- * separate <link xlink:href="NEWS">NEWS</link> (plain text) or <link -->
-<!-- * xlink:href="NEWS.html">NEWS.html</link> files.</para> -->
-<!-- *  -->
 <!-- * <para>As with all DocBook Project <link linkend="dot0">dot-zero</link> -->
 <!-- * releases, this is an experimental release. It will be followed shortly -->
 <!-- * by a stable release.</para> -->
 <!-- *  -->
-<para>This is a pre-release “snapshot” of the DocBook XSL
-Stylesheets. The change information in the first section of this
-file (for “<xi:include href="NEWS.xml"
-xpointer="xpointer(/article/sect1/title/text())"/>”) is
-auto-generated from change descriptions stored in the project
-source-code repository.</para>
-
-<para>That means the first section contains descriptions both of bug
-fixes and of feature changes. The remaning sections are manually
-edited changelog subsets that exclude bug-fix descriptions – that
-is, trimmed down to just those those descriptions that document
-enhancements and changes to the public APIs (user-configurable
-parameters).</para>
+<!-- * <para>This is a pre-release “snapshot” of the DocBook XSL -->
+<!-- * Stylesheets. The change information in the first section of this -->
+<!-- * file (for “<xi:include href="NEWS.xml" -->
+<!-- * xpointer="xpointer(/article/sect1/title/text())"/>”) is -->
+<!-- * auto-generated from change descriptions stored in the project -->
+<!-- * source-code repository.</para> -->
+<!-- *  -->
+<!-- * <para>That means the first section contains descriptions both of bug -->
+<!-- * fixes and of feature changes. The remaning sections are manually -->
+<!-- * edited changelog subsets that exclude bug-fix descriptions – that -->
+<!-- * is, trimmed down to just those those descriptions that document -->
+<!-- * enhancements and changes to the public APIs (user-configurable -->
+<!-- * parameters).</para> -->
+</abstract>
+</info>
 
 <xi:include href="NEWS.xml" xpointer="xpointer(/article/sect1)"/>
 
diff --git a/xsl/tools/xsl/build/doc-link-docbook.xsl b/xsl/tools/xsl/build/doc-link-docbook.xsl
index d7e72f574..db86b7131 100644
--- a/xsl/tools/xsl/build/doc-link-docbook.xsl
+++ b/xsl/tools/xsl/build/doc-link-docbook.xsl
@@ -5,6 +5,7 @@
 <xsl:import href="../../../html/docbook.xsl"/>
 <xsl:include href="tdg-link.xsl"/>
 <xsl:include href="xsl-param-link.xsl"/>
+<xsl:param name="abstract.notitle.enabled" select="1"/>
 <xsl:param name="html.append"><xsl:text>&#x0a;</xsl:text></xsl:param>
 
 </xsl:stylesheet>
-- 
2.40.0