Add docbook-xsl-ns for docs of PAM, colord, etc.

3 files changed, 275 insertions, 0 deletions

diff --git a/introduction/welcome/changelog.xml b/introduction/welcome/changelog.xml
index b7484cb790..06d4876475 100644
--- a/introduction/welcome/changelog.xml
+++ b/introduction/welcome/changelog.xml
@@ -42,6 +42,10 @@
       <para>October 27th, 2024</para>
       <itemizedlist>
         <listitem>
+          <para>[xry111] - Add docbook-xsl-ns-1.79.2. Fixes
+          <ulink url="&blfs-ticket-root;20580">#20580</ulink>.</para>
+        </listitem>
+        <listitem>
           <para>[bdubbs] - Upgrade to mpg123-1.32.8. Fixes
           <ulink url="&blfs-ticket-root;20579">#20579</ulink>.</para>
         </listitem>
diff --git a/pst/xml/docbook-xsl-ns.xml b/pst/xml/docbook-xsl-ns.xml
new file mode 100644
index 0000000000..a66f4c0199
--- /dev/null
+++ b/pst/xml/docbook-xsl-ns.xml
@@ -0,0 +1,270 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY path "https://github.com/docbook/xslt10-stylesheets/releases/download/release">
+
+  <!ENTITY docbook-xsl-ns-download-http "&path;/&docbook-xsl-version;/docbook-xsl-&docbook-xsl-version;.tar.bz2">
+  <!ENTITY docbook-xsl-ns-download-ftp  " ">
+  <!ENTITY docbook-xsl-ns-md5sum        "4a400f0264a19329c7f95f69e098744a">
+  <!ENTITY docbook-xsl-ns-size          "23 MB">
+  <!ENTITY docbook-xsl-ns-buildsize     "49 MB">
+  <!ENTITY docbook-xsl-ns-time          "less than 0.1 SBU">
+]>
+
+<sect1 id="docbook-xsl-ns"
+xreflabel="docbook-xsl-ns-&docbook-xsl-version;">
+  <?dbhtml filename="docbook-xsl-ns.html"?>
+
+
+  <title>docbook-xsl-ns-&docbook-xsl-version;</title>
+
+  <indexterm zone="docbook-xsl-ns">
+    <primary sortas="a-DocBook-XSL-Stylesheets">DocBook XSL
+    Stylesheets (Namespaced)</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to DocBook XSL Stylesheets (Namespaced)</title>
+
+    <para>
+      The <application>DocBook XSL Stylesheets (Namespaced)</application>
+      package contains XSL stylesheets. These are useful for
+      performing transformations on XML DocBook 5.0 files.
+    </para>
+
+    &lfs122_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>
+          Download (HTTP): <ulink url="&docbook-xsl-ns-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&docbook-xsl-ns-download-ftp;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &docbook-xsl-ns-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &docbook-xsl-ns-size;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &docbook-xsl-ns-buildsize;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &docbook-xsl-ns-time;
+        </para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para>
+          Required patch: <ulink url=
+            "&patch-root;/docbook-xsl-&docbook-xsl-version;-stack_fix-1.patch"/>
+        </para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">DocBook XSL Stylesheets (Namespaced) Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Recommended (at runtime)</bridgehead>
+    <para role="recommended">
+      <xref role="runtime" linkend="libxml2"/>
+    </para>
+
+    <bridgehead renderas="sect4">Optional (all used at runtime)</bridgehead>
+    <para role="optional">
+      <xref role="runtime" linkend="apache-ant"/>
+         (to produce <quote>webhelp</quote> documents),
+      <xref role="runtime"  linkend="libxslt"/>
+         (or any other XSLT processor), to process
+          Docbook documents,
+      <xref role="runtime" linkend="ruby"/>
+         (to utilize the <quote>epub</quote> stylesheets),
+      <xref role="runtime" linkend="zip"/>
+         (to produce <quote>epub3</quote> documents), and
+      <ulink url="https://sourceforge.net/projects/saxon/files/saxon6/">
+        Saxon6
+      </ulink> and
+      <ulink url="http://xerces.apache.org/xerces2-j/">Xerces2 Java</ulink>
+         (used with <xref role="runtime" linkend="apache-ant"/>
+          to produce <quote>webhelp</quote> documents)
+    </para>
+
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of DocBook XSL Stylesheets (Namespaced)</title>
+
+    <para>
+      First, fix a problem that causes stack overflows when doing recursion:
+    </para>
+
+<screen><userinput>patch -Np1 -i ../docbook-xsl-nons-&docbook-xsl-version;-stack_fix-1.patch</userinput></screen>
+
+    <para>
+      BLFS does not install the required packages to run the test suite
+      and provide meaningful results.
+    </para>
+
+    <para>
+      Install <application>DocBook XSL Stylesheets</application>
+      by running the following commands as the
+      <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
+
+cp -v -R VERSION assembly common eclipse epub epub3 extensions fo        \
+         highlighting html htmlhelp images javahelp lib manpages params  \
+         profiling roundtrip slides template tests tools webhelp website \
+         xhtml xhtml-1_1 xhtml5                                          \
+    /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
+
+ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;/VERSION.xsl</userinput></screen>
+
+    <para>
+      The documentation for this package is shared with its non-namespaced
+      counterpart, the <xref linkend='docbook-xsl'/> package.  Install the
+      latter if you want the documentation.
+    </para>
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring DocBook XSL Stylesheets</title>
+
+    <sect3 id="docbook-xsl-ns-config">
+      <title>Config Files</title>
+
+      <para>
+        <filename>/etc/xml/catalog</filename>
+      </para>
+
+      <indexterm zone="docbook-xsl docbook-xsl-config">
+        <primary sortas="e-etc-xml-catalog">/etc/xml/catalog</primary>
+      </indexterm>
+
+    </sect3>
+
+    <sect3>
+      <title>Configuration Information</title>
+
+      <para>
+        Create (or append) and populate the XML catalog file using the
+        following commands as the <systemitem
+        class="username">root</systemitem> user (both <emphasis>http</emphasis>
+        and <emphasis>https</emphasis> forms are used because upstream
+        have had both in their documentation):
+      </para>
+
+<screen role="root"><userinput>if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &amp;&amp;
+if [ ! -f /etc/xml/catalog ]; then
+    xmlcatalog --noout --create /etc/xml/catalog
+fi &amp;&amp;
+
+xmlcatalog --noout --add "rewriteSystem" \
+           "http://cdn.docbook.org/release/xsl/&docbook-xsl-version;" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog &amp;&amp;
+
+xmlcatalog --noout --add "rewriteSystem" \
+           "https://cdn.docbook.org/release/xsl/&docbook-xsl-version;" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog &amp;&amp;
+
+xmlcatalog --noout --add "rewriteURI" \
+           "http://cdn.docbook.org/release/xsl/&docbook-xsl-version;" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog &amp;&amp;
+
+xmlcatalog --noout --add "rewriteURI" \
+           "https://cdn.docbook.org/release/xsl/&docbook-xsl-version;" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog &amp;&amp;
+
+xmlcatalog --noout --add "rewriteSystem" \
+           "http://cdn.docbook.org/release/xsl/current" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog &amp;&amp;
+
+xmlcatalog --noout --add "rewriteSystem" \
+           "https://cdn.docbook.org/release/xsl/current" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog &amp;&amp;
+
+xmlcatalog --noout --add "rewriteURI" \
+           "http://cdn.docbook.org/release/xsl/current" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog &amp;&amp;
+
+xmlcatalog --noout --add "rewriteURI" \
+           "https://cdn.docbook.org/release/xsl/current" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog &amp;&amp;
+
+xmlcatalog --noout --add "rewriteSystem" \
+           "http://docbook.sourceforge.net/release/xsl-ns/current" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog &amp;&amp;
+
+xmlcatalog --noout --add "rewriteURI" \
+           "http://docbook.sourceforge.net/release/xsl-ns/current" \
+           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
+    /etc/xml/catalog</userinput></screen>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Files</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;/*/*.xsl</seg>
+        <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="xsl-stylesheets-ns">
+        <term><filename>XSL Stylesheets (Namespaced)</filename></term>
+        <listitem>
+          <para>
+            are used for performing transformations on XML files
+          </para>
+          <indexterm zone="docbook-xsl-ns xsl-stylesheets-ns">
+            <primary sortas="g-XSL-Stylesheets-Namespaced">XSL Stylesheets (Namespaced)</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>
diff --git a/pst/xml/xml.xml b/pst/xml/xml.xml
index edb2828c8c..9f44f61e33 100644
--- a/pst/xml/xml.xml
+++ b/pst/xml/xml.xml
@@ -20,6 +20,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="docbook5.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="docbook51.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="docbook-xsl.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="docbook-xsl-ns.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="itstool.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="xmlto.xml"/>