Author: ken
Date: Wed Sep 12 16:12:57 2018
New Revision: 20496

Log:
perl modules branch: add XML-Simple with deps, noting that XML-SAX-Expat is a 
valid optional dep, it gets used to provide yet another parser, and tests using 
it are run if it is present. For dependencies in general, comment them where 
pulled in by another dep, instead of showing everything.

Added:
   branches/perl-modules/general/prog/perl-deps/perl-xml-namespacesupport.xml   
(contents, props changed)
   branches/perl-modules/general/prog/perl-deps/perl-xml-sax-base.xml   
(contents, props changed)
   branches/perl-modules/general/prog/perl-deps/perl-xml-sax-expat.xml   
(contents, props changed)
   branches/perl-modules/general/prog/perl-deps/perl-xml-sax.xml   (contents, 
props changed)
   branches/perl-modules/general/prog/perl-modules/perl-xml-simple.xml   
(contents, props changed)
Modified:
   branches/perl-modules/general/prog/new-perl-modules.xml
   branches/perl-modules/general/prog/perl-deps.xml
   branches/perl-modules/packages.ent
   branches/perl-modules/template/template-perl-module.xml
   branches/perl-modules/x/icons/icon-naming-utils.xml

Modified: branches/perl-modules/general/prog/new-perl-modules.xml
==============================================================================
--- branches/perl-modules/general/prog/new-perl-modules.xml     Wed Sep 12 
08:32:14 2018        (r20495)
+++ branches/perl-modules/general/prog/new-perl-modules.xml     Wed Sep 12 
16:12:57 2018        (r20496)
@@ -116,6 +116,11 @@
           <xref linkend="new-perl-text-bibtex"/>
         </para>
       </listitem>
+      <listitem>
+        <para>
+          <xref linkend="new-perl-xml-simple"/>
+        </para>
+      </listitem>
       <!-- alternative cpan installation stays at the end -->
       <listitem>
         <para>
@@ -148,6 +153,9 @@
     href="perl-modules/perl-text-bibtex.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-modules/perl-xml-simple.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
     href="perl-alternatives.xml"/>
 
 </sect1>

Modified: branches/perl-modules/general/prog/perl-deps.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps.xml    Wed Sep 12 08:32:14 
2018        (r20495)
+++ branches/perl-modules/general/prog/perl-deps.xml    Wed Sep 12 16:12:57 
2018        (r20496)
@@ -100,6 +100,26 @@
           <xref linkend="new-perl-test-warnings"/>
         </para>
       </listitem>
+      <listitem>
+        <para>
+          <xref linkend="perl-xml-namespacesupport"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <xref linkend="new-perl-xml-sax"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <xref linkend="perl-xml-sax-base"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <xref linkend="perl-xml-sax-expat"/>
+        </para>
+      </listitem>
     </itemizedlist>
   </sect2>
 
@@ -124,4 +144,16 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
     href="perl-deps/perl-test-warnings.xml"/>
 
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-deps/perl-xml-namespacesupport.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-deps/perl-xml-sax.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-deps/perl-xml-sax-base.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-deps/perl-xml-sax-expat.xml"/>
+
 </sect1>

Added: 
branches/perl-modules/general/prog/perl-deps/perl-xml-namespacesupport.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-xml-namespacesupport.xml  
Wed Sep 12 16:12:57 2018        (r20496)
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!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 my-download-http 
"&metacpan_authors;/P/PE/PERIGRIN/XML-NamespaceSupport-&XML-NamespaceSupport-version;.tar.gz">
+  <!ENTITY my-md5sum "a8916c6d095bcf073e1108af02e78c97">
+
+]>
+
+  <!-- Begin XML::NamespaceSupport -->
+  <sect2 id="perl-xml-namespacesupport" 
xreflabel="XML-NamespaceSupport-&XML-NamespaceSupport-version;">
+
+    <title>XML::NamespaceSupport-&XML-NamespaceSupport-version;</title>
+
+    <indexterm zone="perl-xml-namespacesupport">
+      <primary sortas="a-XML-NamespaceSupport">XML::NamespaceSupport</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to XML::NamespaceSupport</title>
+
+      <para>
+        XML::NamespaceSupport offers a simple way to process namespaced XML 
names
+        from within any application that may need them.
+      </para>
+
+      &lfs83_checked;
+
+      <bridgehead renderas="sect4">Package Information</bridgehead>
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            Download (HTTP): <ulink url="&my-download-http;"/>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Download MD5 sum: &my-md5sum;
+          </para>
+        </listitem>
+      </itemizedlist>
+
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of XML::NamespaceSupport</title>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+                  href="../../../xincludes/perl-standard-install.xml"/>
+
+    </sect3>
+
+  </sect2>

Added: branches/perl-modules/general/prog/perl-deps/perl-xml-sax-base.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-xml-sax-base.xml  Wed Sep 
12 16:12:57 2018        (r20496)
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!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 my-download-http 
"&metacpan_authors;/G/GR/GRANTM/XML-SAX-Base-&XML-SAX-Base-version;.tar.gz">
+  <!ENTITY my-md5sum "ec347a14065dd7aec7d9fb181b2d7946">
+
+]>
+
+  <!-- Begin XML::SAX::Base -->
+  <sect2 id="perl-xml-sax-base" 
xreflabel="XML-SAX-Base-&XML-SAX-Base-version;">
+
+    <title>XML::SAX::Base-&XML-SAX-Base-version;</title>
+
+    <indexterm zone="perl-xml-sax-base">
+      <primary sortas="a-XML-SAX-Base">XML::SAX::Base</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to XML::SAX::Base</title>
+
+      <para>
+        This module has a very simple task - to be a base class for PerlSAX
+        drivers and filters.
+      </para>
+
+      &lfs83_checked;
+
+      <bridgehead renderas="sect4">Package Information</bridgehead>
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            Download (HTTP): <ulink url="&my-download-http;"/>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Download MD5 sum: &my-md5sum;
+          </para>
+        </listitem>
+      </itemizedlist>
+
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of XML::SAX-Base</title>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+                  href="../../../xincludes/perl-standard-install.xml"/>
+
+    </sect3>
+
+  </sect2>

Added: branches/perl-modules/general/prog/perl-deps/perl-xml-sax-expat.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-xml-sax-expat.xml Wed Sep 
12 16:12:57 2018        (r20496)
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!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 my-download-http 
"&metacpan_authors;/B/BJ/BJOERN/XML-SAX-Expat-&XML-SAX-Expat-version;.tar.gz">
+  <!ENTITY my-md5sum "74c540095d84e3f054d1f8703a73ef76">
+
+]>
+
+  <!-- Begin XML::SAX::Expat -->
+  <sect2 id="perl-xml-sax-expat" 
xreflabel="XML-SAX-Expat-&XML-SAX-Expat-version;">
+
+    <title>XML::SAX::Expat-&XML-SAX-Expat-version;</title>
+
+    <indexterm zone="perl-xml-sax-expat">
+      <primary sortas="a-XML-SAX-Expat">XML::SAX::Expat</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to XML::SAX::Expat</title>
+
+      <para>
+        XML::SAX::Expat is an implementation of a SAX2 driver sitting on top of
+        Expat (XML::Parser).
+      </para>
+
+      &lfs83_checked;
+
+      <bridgehead renderas="sect4">Package Information</bridgehead>
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            Download (HTTP): <ulink url="&my-download-http;"/>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Download MD5 sum: &my-md5sum;
+          </para>
+        </listitem>
+      </itemizedlist>
+
+      <bridgehead renderas="sect4">XML::SAX::Expat Dependencies</bridgehead>
+
+      <bridgehead renderas="sect5">Required</bridgehead>
+      <para role="required">
+        <xref linkend="perl-xml-sax"/>
+        <!-- perl-xml-sax pulls in perl-xml-namespacesupport and
+             perl-xml-sax-base -->
+      </para>
+
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of XML::SAX::Expat</title>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+                  href="../../../xincludes/perl-standard-install.xml"/>
+
+    </sect3>
+
+  </sect2>

Added: branches/perl-modules/general/prog/perl-deps/perl-xml-sax.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-xml-sax.xml       Wed Sep 
12 16:12:57 2018        (r20496)
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!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 my-download-http 
"&metacpan_authors;/G/GR/GRANTM/XML-SAX-&XML-SAX-version;.tar.gz">
+  <!ENTITY my-md5sum "861a454f7bf269990ed2c1c125f4db48">
+
+]>
+
+  <!-- Begin XML::SAX -->
+  <sect2 id="new-perl-xml-sax" xreflabel="XML-SAX-&XML-SAX-version;">
+
+    <title>XML::SAX-&XML-SAX-version;</title>
+
+    <indexterm zone="new-perl-xml-sax">
+      <primary sortas="a-XML-SAX">XML::SAX</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to XML::SAX</title>
+
+      <para>
+        XML::SAX is a SAX parser access API for Perl. It includes classes and
+        APIs required for implementing SAX drivers, along with a factory class
+        for returning any SAX parser installed on the user's system.
+      </para>
+
+      &lfs83_checked;
+
+      <bridgehead renderas="sect4">Package Information</bridgehead>
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            Download (HTTP): <ulink url="&my-download-http;"/>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Download MD5 sum: &my-md5sum;
+          </para>
+        </listitem>
+      </itemizedlist>
+
+      <bridgehead renderas="sect4">XML::SAX Dependencies</bridgehead>
+
+      <bridgehead renderas="sect5">Required</bridgehead>
+      <para role="required">
+        <xref linkend="libxml2"/>,
+        <xref linkend="perl-xml-namespacesupport"/> and
+        <xref linkend="perl-xml-sax-base"/>
+      </para>
+
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of XML::SAX</title>
+
+      <para>
+        This module asks if you wish to allow it to alter ParserDetails.ini.
+        If you are scripting, you will wish to change 'make' to 'yes | make'.
+        <!-- claimed to not support parallel building, but all it does is
+         copy a few files, works with -j4 although running parallel builds
+         on modules is usually not beneficial : Ken -->
+      </para>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+                  href="../../../xincludes/perl-standard-install.xml"/>
+
+    </sect3>
+
+  </sect2>

Added: branches/perl-modules/general/prog/perl-modules/perl-xml-simple.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-modules/perl-xml-simple.xml Wed Sep 
12 16:12:57 2018        (r20496)
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!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 my-download-http 
"&perl_authors;/id/G/GR/GRANTM/XML-Simple-&XML-Simple-version;.tar.gz">
+  <!ENTITY my-md5sum "bb841dce889a26c89a1c2739970e9fbc">
+
+]>
+
+  <!-- Begin XML::Simple -->
+  <sect2 id="new-perl-xml-simple" xreflabel="XML-Simple-&XML-Simple-version;">
+
+    <title>XML::Simple-&XML-Simple-version;</title>
+
+    <indexterm zone="new-perl-xml-simple">
+      <primary sortas="a-XML-Simple">XML::Simple</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to XML::Simple</title>
+
+      <para>
+        XML::Simple provides an easy API to read and write XML (especially 
config
+        files). It is deprecated and its use is discouraged.
+         <!-- per https://metacpan.org/pod/XML::Simple :-
+        The use of this module in new code is strongly discouraged. 
(explanations
+        are given there) -->
+      </para>
+
+      &lfs83_checked;
+
+      <bridgehead renderas="sect4">Package Information</bridgehead>
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            Download (HTTP): <ulink url="&my-download-http;"/>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Download MD5 sum: &my-md5sum;
+          </para>
+        </listitem>
+      </itemizedlist>
+
+      <bridgehead renderas="sect4">XML::Simple Dependencies</bridgehead>
+
+      <bridgehead renderas="sect5">Optional</bridgehead>
+      <para role="optional">
+        <xref linkend="new-perl-xml-sax"/> (for an alternative parser)
+        <!-- perl-xml-sax pulls in perl-xml-namespacesupport and
+             perl-xml-sax-base -->
+        <xref linkend="perl-xml-sax-expat"/> (for a further additional parser)
+      </para>
+
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of XML::Simple</title>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+                  href="../../../xincludes/perl-standard-install.xml"/>
+
+    </sect3>
+
+  </sect2>

Modified: branches/perl-modules/packages.ent
==============================================================================
--- branches/perl-modules/packages.ent  Wed Sep 12 08:32:14 2018        (r20495)
+++ branches/perl-modules/packages.ent  Wed Sep 12 16:12:57 2018        (r20496)
@@ -416,6 +416,10 @@
 <!ENTITY SUPER-version                "1.20141117">
 <!ENTITY Test-MockModule-version      "0.15">
 <!ENTITY Test-Warnings-version        "0.026">
+<!ENTITY XML-NamespaceSupport-version "1.12">
+<!ENTITY XML-SAX-Base-version         "1.09">
+<!ENTITY XML-SAX-Expat-version        "0.51">
+<!ENTITY XML-SAX-version              "1.00">
 
 <!-- Python module versions used in the Python Modules instructions -->
 <!ENTITY Beaker-version               "1.10.0">

Modified: branches/perl-modules/template/template-perl-module.xml
==============================================================================
--- branches/perl-modules/template/template-perl-module.xml     Wed Sep 12 
08:32:14 2018        (r20495)
+++ branches/perl-modules/template/template-perl-module.xml     Wed Sep 12 
16:12:57 2018        (r20496)
@@ -47,14 +47,15 @@
         </listitem>
       </itemizedlist>
 
-      <!-- omit dependencies if not needed, but unlike the rest of the book,
-       show ALL perl module dependencies, avoid thinking "b will bring in a",
-       their deps might change when one is next updated. -->
+      <!-- omit dependencies if not needed.
+       If module A currently brings in the required dep of B, add a comment 
that
+       B is pulled in by A.  This is to keep it maintainable as deps change. 
-->
       <bridgehead renderas="sect4">Fu::Bar Dependencies</bridgehead>
 
       <bridgehead renderas="sect5">Required</bridgehead>
       <para role="required">
         <xref linkend="perl-bar-baz"/>,
+        <!-- perl-bar-baz pulls in perl-mojotasticity for the testsuite -->
         <xref linkend="perl-wibble"/> and
         <xref linkend="new-perl-wobble"/>
       </para>

Modified: branches/perl-modules/x/icons/icon-naming-utils.xml
==============================================================================
--- branches/perl-modules/x/icons/icon-naming-utils.xml Wed Sep 12 08:32:14 
2018        (r20495)
+++ branches/perl-modules/x/icons/icon-naming-utils.xml Wed Sep 12 16:12:57 
2018        (r20496)
@@ -64,7 +64,7 @@
     <bridgehead renderas="sect3">icon-naming-utils Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
-    <para role="required"><xref linkend="perl-xml-simple"/></para>
+    <para role="required"><xref linkend="new-perl-xml-simple"/></para>
 
     <para condition="html" role="usernotes">User Notes:
     <ulink url="&blfs-wiki;/icon-naming-utils"/></para>
-- 
http://lists.linuxfromscratch.org/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to