Author: ken
Date: Sat Nov  3 14:53:48 2018
New Revision: 20673

Log:
perl modules branch: Add LWP::Protocol::https and its dependencies. Please note 
that I have changed the link name for libwww-perl to (new-)perl-libwww-perl 
from perl-lwp to better match the tarball name. The old perl-modules.xml is 
no-longer rendered in this branch. This is now notionally complete, apart from 
any errors I have introduced.

Added:
   branches/perl-modules/general/prog/perl-deps/perl-http-negotiate.xml   
(contents, props changed)
   branches/perl-modules/general/prog/perl-deps/perl-libwww-perl.xml   
(contents, props changed)
   branches/perl-modules/general/prog/perl-deps/perl-net-http.xml   (contents, 
props changed)
   branches/perl-modules/general/prog/perl-deps/perl-test-requiresinternet.xml  
 (contents, props changed)
   branches/perl-modules/general/prog/perl-deps/perl-www-robotrules.xml   
(contents, props changed)
   branches/perl-modules/general/prog/perl-modules/perl-lwp-protocol-https.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/general/prog/perl-deps/perl-http-cookies.xml
   branches/perl-modules/general/prog/perl-deps/perl-xml-sax-expat.xml
   branches/perl-modules/general/prog/prog.xml
   branches/perl-modules/packages.ent
   branches/perl-modules/pst/typesetting/biber.xml
   branches/perl-modules/template/template-perl-module.xml

Modified: branches/perl-modules/general/prog/new-perl-modules.xml
==============================================================================
--- branches/perl-modules/general/prog/new-perl-modules.xml     Sat Nov  3 
14:47:38 2018        (r20672)
+++ branches/perl-modules/general/prog/new-perl-modules.xml     Sat Nov  3 
14:53:48 2018        (r20673)
@@ -218,6 +218,11 @@
       </listitem>
       <listitem>
         <para>
+          <xref linkend="new-perl-lwp-protocol-https"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
           <xref linkend="new-perl-module-build"/>
         </para>
       </listitem>
@@ -397,6 +402,9 @@
     href="perl-modules/perl-log-log4perl.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-modules/perl-lwp-protocol-https.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
     href="perl-modules/perl-module-build.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";

Modified: branches/perl-modules/general/prog/perl-deps.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps.xml    Sat Nov  3 14:47:38 
2018        (r20672)
+++ branches/perl-modules/general/prog/perl-deps.xml    Sat Nov  3 14:53:48 
2018        (r20673)
@@ -217,6 +217,11 @@
       </listitem>
       <listitem>
         <para>
+          <xref linkend="new-perl-http-negotiate"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
           <xref linkend="perl-html-tagset"/>
         </para>
       </listitem>
@@ -237,6 +242,11 @@
       </listitem>
       <listitem>
         <para>
+          <xref linkend="new-perl-libwww-perl"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
           <xref linkend="perl-list-moreutils-xs"/>
         </para>
       </listitem>
@@ -297,6 +307,11 @@
       </listitem>
       <listitem>
         <para>
+          <xref linkend="new-perl-net-http"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
           <xref linkend="perl-net-ssleay"/>
         </para>
       </listitem>
@@ -442,6 +457,11 @@
       </listitem>
       <listitem>
         <para>
+          <xref linkend="new-perl-test-requiresinternet"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
           <xref linkend="new-perl-test-simple"/>
         </para>
       </listitem>
@@ -502,6 +522,11 @@
       </listitem>
       <listitem>
         <para>
+          <xref linkend="new-perl-www-robotrules"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
           <xref linkend="new-perl-xml-libxml"/>
         </para>
       </listitem>
@@ -619,6 +644,9 @@
     href="perl-deps/perl-http-message.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-deps/perl-http-negotiate.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
     href="perl-deps/perl-html-tagset.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
@@ -631,6 +659,9 @@
     href="perl-deps/perl-ipc-system-simple.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-deps/perl-libwww-perl.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
     href="perl-deps/perl-list-moreutils-xs.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
@@ -667,6 +698,9 @@
     href="perl-deps/perl-namespace-clean.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-deps/perl-net-http.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
     href="perl-deps/perl-net-ssleay.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
@@ -754,6 +788,9 @@
     href="perl-deps/perl-test-requires.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-deps/perl-test-requiresinternet.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
     href="perl-deps/perl-test-simple.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
@@ -790,6 +827,9 @@
     href="perl-deps/perl-variable-magic.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+    href="perl-deps/perl-www-robotrules.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
     href="perl-deps/perl-xml-libxml.xml"/>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";

Modified: branches/perl-modules/general/prog/perl-deps/perl-http-cookies.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps/perl-http-cookies.xml  Sat Nov 
 3 14:47:38 2018        (r20672)
+++ branches/perl-modules/general/prog/perl-deps/perl-http-cookies.xml  Sat Nov 
 3 14:53:48 2018        (r20673)
@@ -24,7 +24,8 @@
       <para>
         HTTP::Cookies provides a class for objects that represent a "cookie 
jar"
         -- that is, a database of all the HTTP cookies that a given
-        LWP::UserAgent (from libwww-perl) object knows about.          
+        LWP::UserAgent (from <xref linkend="new-perl-libwww-perl"/>) object
+        knows about.
       </para>
 
       &lfs83_checked;

Added: branches/perl-modules/general/prog/perl-deps/perl-http-negotiate.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-http-negotiate.xml        
Sat Nov  3 14:53:48 2018        (r20673)
@@ -0,0 +1,63 @@
+<?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/GA/GAAS/HTTP-Negotiate-&HTTP-Negotiate-version;.tar.gz">
+  <!ENTITY my-md5sum "1236195250e264d7436e7bb02031671b">
+
+]>
+
+  <!-- Begin HTTP::Negotiate -->
+  <sect2 id="new-perl-http-negotiate" 
xreflabel="HTTP-Negotiate-&HTTP-Negotiate-version;">
+
+    <title>HTTP::Negotiate-&HTTP-Negotiate-version;</title>
+
+    <indexterm zone="new-perl-http-negotiate">
+      <primary sortas="a-HTTP-Negotiate">HTTP::Negotiate</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to HTTP::Negotiate</title>
+
+      <para>
+        HTTP::Negotiate provides a complete implementation of the HTTP content
+        negotiation algorithm.
+      </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">HTTP::Negotiate Dependencies</bridgehead>
+
+      <bridgehead renderas="sect5">Required</bridgehead>
+      <para role="required">
+        <!-- The required HTTP~::Headers is part of HTTP::Message -->
+        <xref linkend="perl-http-message"/> (for the testsuite)
+      </para>
+
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of HTTP::Negotiate</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-libwww-perl.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-libwww-perl.xml   Sat Nov 
 3 14:53:48 2018        (r20673)
@@ -0,0 +1,148 @@
+<?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;/E/ET/ETHER/libwww-perl-&libwww-perl-version;.tar.gz">
+  <!ENTITY my-md5sum "19cd0f55f61359c973caa9301ec405bd">
+
+]>
+
+  <!-- Begin libwww-perl -->
+  <sect2 id="new-perl-libwww-perl" 
xreflabel="libwww-perl-&libwww-perl-version;">
+
+    <title>libwww-perl-&libwww-perl-version;</title>
+
+    <indexterm zone="new-perl-libwww-perl">
+      <primary sortas="a-libwww-perl">libwww-perl</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to LWP - The World-wide Web library for
+      <application>Perl</application></title>
+
+      <para>
+        The libwww-perl collection is a set of Perl modules which provides a
+        simple and consistent application programming interface (API) to the
+        World-Wide Web. The main focus of the library is to provide classes and
+        functions that allow you to write WWW clients. The library also 
contains
+        modules that are of more general use and even classes that help you
+        implement simple HTTP servers.
+      </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">libwww-perl Dependencies</bridgehead>
+
+      <bridgehead renderas="sect5">Required</bridgehead>
+      <para role="required">
+        <xref linkend="new-perl-file-listing"/>,
+        <xref linkend="new-perl-http-cookies"/>,
+        <xref linkend="new-perl-http-daemon"/>,
+        <!-- perl-http-daemon pulls in perl-http-message
+          for HTTP::Request, HTTP::Response, HTTP::Status -->
+        <!-- perl-http-message pulls in perl-encode-locale,
+          perl-http-date, perl-lwp-mediatypes and perl-uri -->
+        <xref linkend="new-perl-http-negotiate"/>,
+        <xref linkend="new-perl-html-parser"/>,
+        <xref linkend="new-perl-net-http"/>,
+        <xref linkend="new-perl-try-tiny"/> and
+        <xref linkend="new-perl-www-robotrules"/>, also
+        <xref linkend="new-perl-test-fatal"/>,
+        <xref linkend="new-perl-test-needs"/> and
+        <xref linkend="new-perl-test-requiresinternet"/> (all three for the 
testusite)
+      </para>
+
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of libwww-perl</title>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+                  href="../../../xincludes/perl-standard-install.xml"/>
+
+    </sect3>
+
+    <sect3 role="content">
+      <title>Contents</title>
+
+      <segmentedlist>
+        <segtitle>Installed Programs</segtitle>
+
+        <seglistitem>
+          <seg>
+            lwp-download, lwp-dump, lwp-mirror, lwp-request
+          </seg>
+        </seglistitem>
+      </segmentedlist>
+
+      <variablelist>
+        <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+        <?dbfo list-presentation="list"?>
+        <?dbhtml list-presentation="table"?>
+
+        <varlistentry id="lwp-download-prog">
+          <term><command>lwp-download</command></term>
+          <listitem>
+            <para>is a script to fetch a large file from the web.</para>
+            <!-- the -prog is for while (old) and new- perl module pages
+             are both in the book, without it the link to the package is
+             correct, but the link to the prog goes to the progs in old
+             perl-modules.xml -->
+            <indexterm zone="new-perl-libwww-perl lwp-download-prog">
+              <primary sortas="b-lwp-download">lwp-download</primary>
+            </indexterm>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry id="lwp-dump-prog">
+          <term><command>lwp-dump</command></term>
+          <listitem>
+            <para>is used to see what headers and content is returned
+            for a URL.</para>
+            <indexterm zone="new-perl-libwww-perl lwp-dump-prog">
+              <primary sortas="b-lwp-dump">lwp-dump</primary>
+            </indexterm>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry id="lwp-mirror-prog">
+          <term><command>lwp-mirror</command></term>
+          <listitem>
+            <para>is a simple mirror utility.</para>
+            <indexterm zone="new-perl-libwww-perl lwp-mirror-prog">
+              <primary sortas="b-lwp-mirror">lwp-mirror</primary>
+            </indexterm>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry id="lwp-request-prog">
+          <term><command>lwp-request</command></term>
+          <listitem>
+            <para>is a simple command line user agent.</para>
+            <indexterm zone="new-perl-libwww-perl lwp-request-prog">
+              <primary sortas="b-lwp-request">lwp-request</primary>
+            </indexterm>
+          </listitem>
+        </varlistentry>
+
+      </variablelist>
+
+    </sect3>
+
+  </sect2>

Added: branches/perl-modules/general/prog/perl-deps/perl-net-http.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-net-http.xml      Sat Nov 
 3 14:53:48 2018        (r20673)
@@ -0,0 +1,62 @@
+<?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;/O/OA/OALDERS/Net-HTTP-&Net-HTTP-version;.tar.gz">
+  <!ENTITY my-md5sum "6da11a7db0e933b7684148e1fb32006a">
+
+]>
+
+  <!-- Begin Net::HTTP -->
+  <sect2 id="new-perl-net-http" xreflabel="Net-HTTP-&Net-HTTP-version;">
+
+    <title>Net::HTTP-&Net-HTTP-version;</title>
+
+    <indexterm zone="new-perl-net-http">
+      <primary sortas="a-Net-HTTP">Net::HTTP</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to Net::HTTP</title>
+
+      <para>
+        The Net::HTTP class is a low level HTTP client. An instance of the 
class
+        represents a connection to an HTTP server.
+      </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">Net::HTTP Dependencies</bridgehead>
+
+      <bridgehead renderas="sect5">Required</bridgehead>
+      <para role="required">
+        <xref linkend="new-perl-uri"/>
+      </para>
+
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of Net::HTTP</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-test-requiresinternet.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-test-requiresinternet.xml 
Sat Nov  3 14:53:48 2018        (r20673)
@@ -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;/M/MA/MALLEN/Test-RequiresInternet-&Test-RequiresInternet-version;.tar.gz">
+  <!ENTITY my-md5sum "0ba9f1cff4cf90ed2618c2eddfd525d8">
+
+]>
+
+  <!-- Begin Test::RequiresInternet -->
+  <sect2 id="new-perl-test-requiresinternet" 
xreflabel="Test-RequiresInternet-&Test-RequiresInternet-version;">
+
+    <title>Test::RequiresInternet-&Test-RequiresInternet-version;</title>
+
+    <indexterm zone="new-perl-test-requiresinternet">
+      <primary 
sortas="a-Test-RequiresInternet">Test::RequiresInternet</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to Test::RequiresInternet</title>
+
+      <para>
+        Test::RequiresInternet is intended to easily test network connectivity
+        before functional tests begin to non-local Internet resources.
+      </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 Test::RequiresInternet</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-www-robotrules.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-www-robotrules.xml        
Sat Nov  3 14:53:48 2018        (r20673)
@@ -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;/G/GA/GAAS/WWW-RobotRules-&WWW-RobotRules-version;.tar.gz">
+  <!ENTITY my-md5sum "b7186e8b8b3701e70c22abf430742403">
+
+]>
+
+  <!-- Begin WWW::RobotRules -->
+  <sect2 id="new-perl-www-robotrules" 
xreflabel="WWW-RobotRules-&WWW-RobotRules-version;">
+
+    <title>WWW::RobotRules-&WWW-RobotRules-version;</title>
+
+    <indexterm zone="new-perl-www-robotrules">
+      <primary sortas="a-WWW-RobotRules">WWW::RobotRules</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to WWW::RobotRules</title>
+
+      <para>
+        WWW::RobotRules parses <filename>robots.txt</filename> files,
+        creating a WWW::RobotRules object with methods to check if access
+        to a given URL is prohibited.
+      </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">WWW::RobotRules Dependencies</bridgehead>
+
+      <bridgehead renderas="sect5">Required (runtime)</bridgehead>
+      <para role="required">
+        <!-- LWP~::Simple comes from libwww-perl -->
+        <xref linkend="new-perl-libwww-perl"/> (install this module first and
+        install that later)
+      </para>
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of WWW::RobotRules</title>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+                  href="../../../xincludes/perl-standard-install.xml"/>
+
+    </sect3>
+
+  </sect2>

Modified: branches/perl-modules/general/prog/perl-deps/perl-xml-sax-expat.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps/perl-xml-sax-expat.xml Sat Nov 
 3 14:47:38 2018        (r20672)
+++ branches/perl-modules/general/prog/perl-deps/perl-xml-sax-expat.xml Sat Nov 
 3 14:53:48 2018        (r20673)
@@ -46,7 +46,7 @@
 
       <bridgehead renderas="sect5">Required</bridgehead>
       <para role="required">
-        <xref linkend="perl-xml-sax"/>
+        <xref linkend="new-perl-xml-sax"/>
         <!-- perl-xml-sax pulls in perl-xml-namespacesupport and
              perl-xml-sax-base -->
       </para>

Added: 
branches/perl-modules/general/prog/perl-modules/perl-lwp-protocol-https.xml
==============================================================================
--- /dev/null   00:00:00 1970   (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-modules/perl-lwp-protocol-https.xml 
Sat Nov  3 14:53:48 2018        (r20673)
@@ -0,0 +1,87 @@
+<?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/O/OA/OALDERS/LWP-Protocol-https-&LWP-Protocol-https-version;.tar.gz">
+  <!ENTITY my-md5sum "b8943dfb7d187af63c36fc18ab15947d">
+
+]>
+
+  <!-- Begin LWP::Protocol::https -->
+  <sect2 id="new-perl-lwp-protocol-https" 
xreflabel="LWP-Protocol-https-&LWP-Protocol-https-version;">
+
+    <title>LWP::Protocol::https-&LWP-Protocol-https-version;</title>
+
+    <indexterm zone="new-perl-lwp-protocol-https">
+      <primary sortas="a-LWP-Protocol-https">LWP::Protocol::https</primary>
+    </indexterm>
+
+    <sect3 role="package">
+      <title>Introduction to LWP::Protocol::https</title>
+
+      <para>
+        LWP::Protocol::https provides https support for LWP::UserAgent (i.e.
+        <xref linkend="new-perl-libwww-perl"/>). Once the module is installed
+        LWP is able to access sites using HT~TP over SSL/TLS.
+      </para>
+
+      <bridgehead renderas="sect4">Additional Download</bridgehead>
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            Required patch:
+            <ulink 
url="&patch-root;/LWP-Protocol-https-&LWP-Protocol-https-version;-system_certs-1.patch"/>
+          </para>
+        </listitem>
+      </itemizedlist>
+
+      &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">LWP::Protocol::https 
Dependencies</bridgehead>
+
+      <bridgehead renderas="sect5">Required</bridgehead>
+      <para role="required">
+        <xref linkend="new-perl-io-socket-ssl"/>,
+        <!-- perl-io-socket-ssl pulls in perl-net-ssleay -->
+        <xref linkend="new-perl-libwww-perl"/> and
+        <!-- perl-libwww-perl pulls in perl-net-https -->
+        <xref linkend="make-ca"/> with the
+        <literal>/etc/pki/tls/certs/ca-bundle.crt</literal> symlink
+      </para>
+
+    </sect3>
+
+    <sect3 role="installation">
+      <title>Installation of LWP::Protocol::https</title>
+
+      <para>
+        First, apply a patch to use the system certificates (using the CPAN
+        automated install will instead use <ulink
+        url="https://metacpan.org/pod/Mozilla::CA";>Mozilla::CA</ulink>) which
+        is usually not up to date and does not use local certificates.
+      </para>
+
+<screen><userinput>patch -Np1 -i 
../LWP-Protocol-https-&LWP-Protocol-https-version;-system_certs-1.patch</userinput></screen>
+
+      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+                  href="../../../xincludes/perl-standard-install.xml"/>
+
+    </sect3>
+
+  </sect2>

Modified: branches/perl-modules/general/prog/prog.xml
==============================================================================
--- branches/perl-modules/general/prog/prog.xml Sat Nov  3 14:47:38 2018        
(r20672)
+++ branches/perl-modules/general/prog/prog.xml Sat Nov  3 14:53:48 2018        
(r20673)
@@ -50,7 +50,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="npapi-sdk.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; 
href="new-perl-modules.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="perl-deps.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; 
href="perl-modules.xml"/>
+<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; 
href="perl-modules.xml"/> -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="php.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="python2.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="python3.xml"/>

Modified: branches/perl-modules/packages.ent
==============================================================================
--- branches/perl-modules/packages.ent  Sat Nov  3 14:47:38 2018        (r20672)
+++ branches/perl-modules/packages.ent  Sat Nov  3 14:53:48 2018        (r20673)
@@ -389,6 +389,8 @@
 <!ENTITY List-AllUtils-version        "0.14">
 <!ENTITY List-MoreUtils-version       "0.428">
 <!ENTITY Log-Log4perl-version         "1.49">
+<!-- remove when old perl-modules.xml is retired
+ (the dep file references libwww-perl-version) -->
 <!ENTITY LWP-version                  "6.35">
 <!ENTITY LWP-Protocol-https-version   "6.07">
 <!ENTITY Module-Build-version         "0.4224">
@@ -448,6 +450,7 @@
 <!ENTITY Importer-version             "0.025">
 <!ENTITY IO-HTML-version              "1.001">
 <!ENTITY IPC-System-Simple-version    "1.25">
+<!ENTITY libwww-perl-version          "6.35">
 <!ENTITY List-MoreUtils-XS-version    "0.428">
 <!ENTITY List-SomeUtils-version       "0.56">
 <!ENTITY List-SomeUtils-XS-version    "0.58">

Modified: branches/perl-modules/pst/typesetting/biber.xml
==============================================================================
--- branches/perl-modules/pst/typesetting/biber.xml     Sat Nov  3 14:47:38 
2018        (r20672)
+++ branches/perl-modules/pst/typesetting/biber.xml     Sat Nov  3 14:53:48 
2018        (r20673)
@@ -120,20 +120,19 @@
       <xref linkend="new-perl-lingua-translit"/>
       <xref linkend="new-perl-list-allutils"/>
       <xref linkend="new-perl-list-moreutils"/>
-      <!-- new-perl-list-moreutils-xs is a dep of new-perl-lsit-moreutils -->
+      <!-- perl-list-moreutils-xs is a dep of perl-list-moreutils -->
       <xref linkend="new-perl-log-log4perl"/>
-      <!-- I initially misread LWP-Protocol-https as part of libwww-perl
-      when I was preparing this list.  In fact, it depends on that -->
-      <xref linkend="perl-lwp-protocol-https"/>
-      <!-- LWP::Simple is part of libwww-perl,
-      that is pulled in by LWP::Protocol::https -->
+      <xref linkend="new-perl-lwp-protocol-https"/>
+      <!-- LWP::Simple is part of perl-libwww-perl,
+      that is pulled in by perl-lwp-protocol-https
+      and that pulls in perl-uri -->
       <xref linkend="new-perl-module-build"/>
-      <!-- Mozilla::CA is a dependency of LWP-Protocol-https -->
+      <!-- Mozilla::CA should not be needed when using system certificates -->
       <xref linkend="new-perl-regexp-common"/>
       <xref linkend="new-perl-sort-key"/>
       <xref linkend="new-perl-text-bibtex"/>
       <xref linkend="new-perl-text-csv"/>
-      <!-- Text-CSV_XS is a recommended dependency for Text-CSV -->
+      <!-- perl-text-csv_xs is a recommended dependency for perl-text-csv -->
       <xref linkend="new-perl-text-roman"/>
       <!-- Unicode-Collate usually needs to be latest when biber is released,
         core perl is usually older. To read the core version, look at
@@ -143,14 +142,14 @@
       <xref linkend="new-perl-unicode-linebreak"/>
       <!-- Unicode::Normalize is part of core perl, found in
         /usr/lib/perl5/5.xx.y/x86_64-linux-thread-multi/Unicode/Normalize.pm 
-->
-      <!-- FIXME URI is probably a dep in the lwp or libwww area --> 
-      <!-- XML::LibXML is a dependency of XML::LibXML::Simple -->
+      <!-- perl-xml-libxml is a dependency of perl-xml-libxml-simple -->
       <xref linkend="new-perl-xml-libxml-simple"/>
       <xref linkend="new-perl-xml-libxslt"/>
       <xref linkend="new-perl-xml-writer"/> and
       <!-- untarring biblatex requires that the texmf directories already 
exist -->
       <xref linkend="texlive"/>
-      (or <xref linkend="tl-installer"/>)
+      (or <xref linkend="tl-installer"/>, but for that you can use
+       <command>tlmgr update </command>)
     </para>
 
     <note> <!-- assume people with an old release may be slowly building 
things -->
@@ -171,11 +170,7 @@
         It is possible to install all missing dependencies automatically.
         But from <application>perl-5.22.0</application> onwards,
         <xref linkend="new-perl-module-build"/> is no longer part of the core 
perl
-        distribution.<!-- And for <xref linkend="perl-data-uniqid"/> we have to
-        patch it to skip over a test which always fails - that failing test may
-        break the automatic install.--> To automatically install the remaining 
perl
- <!--   dependencies you can install that module first using <xref
-        linkend="perl-alternatives"/>. then run <command>perl 
./Build.PL</command> -->
+        distribution. To automatically install the remaining perl
         dependencies you can install that module first using <xref
         linkend="new-perl-auto-install"/>. then run <command>perl 
./Build.PL</command>
         and when it prompts you, become the root user and run

Modified: branches/perl-modules/template/template-perl-module.xml
==============================================================================
--- branches/perl-modules/template/template-perl-module.xml     Sat Nov  3 
14:47:38 2018        (r20672)
+++ branches/perl-modules/template/template-perl-module.xml     Sat Nov  3 
14:53:48 2018        (r20673)
@@ -31,6 +31,16 @@
         Fu::Bar does something.
       </para>
 
+      <bridgehead renderas="sect4">Additional Download</bridgehead>
+      <itemizedlist spacing="compact">
+        <listitem>
+          <para>
+            Required patch:
+            <ulink 
url="&patch-root;/Fu-Bar-&Fu-Bar-version;-do_something-1.patch"/>
+          </para>
+        </listitem>
+      </itemizedlist>
+
 <!--  &lfs8x_checked; -->
 
       <bridgehead renderas="sect4">Package Information</bridgehead>
@@ -65,7 +75,13 @@
     <sect3 role="installation">
       <title>Installation of Fu::Bar</title>
 
+      <para>
+        First, apply a patch to do something ...
+      </para>
+
 <!-- Any specific action for the module (patches, etc) should come first -->
+<screen><userinput>patch -Np1 -i 
../Fu-Bar-https-&Fu-Bar-version;-do_something-1.patch</userinput></screen>
+
 <!-- If the module uses standard installation instructions: -->
       <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
                   href="../../../xincludes/perl-standard-install.xml"/>
-- 
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