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