Author: ken
Date: Fri Sep 7 18:23:57 2018
New Revision: 20472
Log:
New branch for testing changes to perl modules.
Added:
branches/perl-modules/
- copied from r20471, trunk/BOOK/
branches/perl-modules/general/prog/new-perl-modules.xml (contents, props
changed)
branches/perl-modules/general/prog/perl-alternatives.xml (contents, props
changed)
branches/perl-modules/general/prog/perl-deps/
branches/perl-modules/general/prog/perl-deps.xml (contents, props changed)
branches/perl-modules/general/prog/perl-deps/perl-capture-tiny.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-deps/perl-config-autoconf.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-deps/perl-extutils-libbuilder.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-deps/perl-sub-identify.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-deps/perl-super.xml (contents,
props changed)
branches/perl-modules/general/prog/perl-deps/perl-test-mockmodule.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-deps/perl-test-warnings.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-modules/
branches/perl-modules/general/prog/perl-modules/perl-archive-zip.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-modules/perl-autovivification.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-modules/perl-business-issn.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-modules/perl-module-build.xml
(contents, props changed)
branches/perl-modules/general/prog/perl-modules/perl-text-bibtex.xml
(contents, props changed)
branches/perl-modules/template/template-perl-module.xml (contents, props
changed)
Modified:
branches/perl-modules/general.ent
branches/perl-modules/general/prog/perl-modules.xml
branches/perl-modules/general/prog/prog.xml
branches/perl-modules/packages.ent
branches/perl-modules/pst/typesetting/biber.xml
branches/perl-modules/xsoft/office/libreoffice.xml
Modified: branches/perl-modules/general.ent
==============================================================================
--- trunk/BOOK/general.ent Fri Sep 7 13:23:37 2018 (r20471)
+++ branches/perl-modules/general.ent Fri Sep 7 18:23:57 2018 (r20472)
@@ -48,6 +48,8 @@
<!ENTITY kernel-dl "https://www.kernel.org/pub";>
<!ENTITY mozilla-http "https://archive.mozilla.org/pub";>
<!ENTITY mozilla-hg
"https://hg.mozilla.org/releases/mozilla-release/archive/";>
+<!ENTITY perl_authors "https://www.cpan.org/authors";>
+<!ENTITY metacpan_authors "https://cpan.metacpan.org/authors/id/";>
<!ENTITY pymodules-dl "https://files.pythonhosted.org/packages/source";>
<!ENTITY sourceforge-dl "https://downloads.sourceforge.net";>
Added: branches/perl-modules/general/prog/new-perl-modules.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/new-perl-modules.xml Fri Sep 7
18:23:57 2018 (r20472)
@@ -0,0 +1,129 @@
+<?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;
+]>
+
+<sect1 id="new-perl-modules" xreflabel="Perl Modules (new page)">
+ <?dbhtml filename="new-perl-modules.html" ?>
+
+ <sect1info>
+ <othername>$LastChangedBy$</othername>
+ <date>$Date$</date>
+ </sect1info>
+
+ <title>Perl Modules (new page)</title>
+
+ <indexterm zone="new-perl-modules">
+ <primary sortas="a-new-perl-Modules">Perl Modules</primary>
+ </indexterm>
+
+ <sect2 role="package">
+ <title>Introduction to Perl Modules</title>
+
+ <para>
+ The <application>Perl</application> module packages (also referred to as
+ Distributions, because each can contain multiple modules) add useful
+ objects to the <application>Perl</application> language. The packages
+ listed on this page are required or recommended for other packages in
+ the book. If they have dependent modules, those are either on this page
+ or else on the next page.
+ </para>
+
+ <para>
+ Modules utilized by packages throughout BLFS are listed here, along with
+ their dependencies. The various ways of building and installing perl
+ modules are shown at the bottom of this page.
+ </para>
+
+ <para>
+ In many cases, only the required or recommended dependencies are listed -
+ there might be other modules which allow more tests to be run, but
+ omitting them will still allow the tests to <literal>PASS</literal>.
+ </para>
+
+ <para>
+ For a few modules, the BLFS editors have determined that other modules
+ still listed as prerequisites are not required, and omitted them.
+ </para>
+
+ <para>
+ It is generally worth running the tests for perl modules, they often
+ can show problems such as missing dependencies which are required to
+ use the module. In some cases, such dependencies are marked as
+ '(for the testsuite)'.
+ </para>
+
+ <para>
+ There are a number of different ways of installing perl modules, they are
+ listed at the end of this page.
+ </para>
+
+ <para>
+ Most of these modules only install files below <filename
+ class="directory">/usr/lib/perl5/site_perl/5.xx.y</filename> and those
will
+ not be documented. One or two install programs (mostly, perl scripts), or
+ even a library, into <filename class="directory">/usr</filename> and
those
+ are documented.
+ </para>
+
+ <para condition="html" role="usernotes">User Notes:
+ <ulink url="&blfs-wiki;/perl-modules"/>
+ </para>
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ <xref linkend="new-perl-archive-zip"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="new-perl-autovivification"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="new-perl-business-issn"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="new-perl-module-build"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="new-perl-text-bibtex"/>
+ </para>
+ </listitem>
+ <!-- Build and install options always come at the end, but one of
+ them is perl-build-install so call the set perl-alternatives -->
+ <listitem>
+ <para>
+ <xref linkend="perl-alternatives"/>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-modules/perl-archive-zip.xml"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-modules/perl-autovivification.xml"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-modules/perl-business-issn.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";
+ href="perl-modules/perl-text-bibtex.xml"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-alternatives.xml"/>
+
+</sect1>
Added: branches/perl-modules/general/prog/perl-alternatives.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-alternatives.xml Fri Sep 7
18:23:57 2018 (r20472)
@@ -0,0 +1,139 @@
+<?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;
+
+ <!-- it seems at least one entity is needed -->
+ <!ENTITY perl-alternatives-dummy "42">
+]>
+ <!-- Begin perl alternatives -->
+ <sect2 id="perl-alternatives" xreflabel="Building and installing perl
modules">
+
+ <title>Building and installing perl modules</title>
+
+ <indexterm zone="perl-alternatives">
+ <primary sortas="a-installing-perl-modules">Installing perl
modules</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>The various ways of building and Installing perl modules</title>
+
+ <para>
+ Most modules use a standard install, but some use a different method.
Each
+ module links to the appropriate method. You can also make an automated
+ install, using CPAN to download any modular dependencies - details at the
+ end.
+ </para>
+
+ </sect3>
+
+ <sect3 role="installation" id="new-perl-standard-install"
+ xreflabel="standard build and installation instructions">
+ <title>Standard Installation of Perl Modules</title>
+
+ <para>Install <application>Perl</application> modules by running the
+ following commands:</para>
+
+ <para>For <xref linkend="perl-data-uniqid"/>, first apply the required
+ patch with:</para>
+
+<screen><userinput>patch -Np1 -i
../Data-Uniqid-&Data-Uniqid-version;-disable_failing_test-1.patch</userinput></screen>
+
+ <para>Then, or for all other modules using the standard installation,
proceed
+ with:</para>
+
+<screen><userinput>perl Makefile.PL &&
+make &&
+make test</userinput></screen>
+
+ <note>
+ <para>If the module is described as using the
<emphasis>unsafe</emphasis>
+ variant of the Standard Installation, (the use of the current
+ directory in <literal>@INC</literal> was removed for security reasons
+ in <literal>perl-5.26.0</literal>)
+ you should change the perl invocation to:</para>
+
+<screen><userinput>PERL_USE_UNSAFE_INC=1 &&</userinput></screen>
+
+ <para>If, however, you are using the Auto Installation described below,
+ that environment variable will be set whenever the
<command>cpan</command>
+ shell <command>install</command> is used.</para>
+ </note>
+
+ <para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+ <note>
+ <para>When reinstalling a <application>Perl</application> module,
+ sometimes older versions of the module being reinstalled are in other
+ directories specified in <parameter>@INC</parameter>. To delete all
+ other versions of the module being reinstalled (not simply older ones)
+ set the <varname>UNINST</varname> variable:</para>
+
+<screen><userinput>make install UNINST=1</userinput></screen>
+ </note>
+
+ </sect3>
+
+ <sect3 role="installation" id="new-perl-build-install"
+ xreflabel="instructions for packages using Build.PL">
+ <title>Installation of Perl Modules which use Build.PL</title>
+
+ <para>Install <application>Perl</application> modules which use
+ Build.PL by running the following commands:</para>
+
+<screen><userinput>perl Build.PL &&
+./Build &&
+./Build test</userinput></screen>
+
+ <para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
+
+<screen role="root"><userinput>./Build install</userinput></screen>
+
+ </sect3>
+
+ <sect3 role="installation" id="new-perl-auto-install"
+ xreflabel="alternate auto installation instructions">
+ <title>(Alternate) Auto Installation of Perl Modules.</title>
+
+ <para>There is an alternate way of installing the modules using the
+ <command>cpan</command> shell <command>install</command> command. The
+ command automatically downloads the source from the CPAN archive,
extracts
+ it, runs the compilation, testing and installation commands mentioned
+ above, and removes the build source tree. You may still need to install
+ dependent library packages before running the automated installation
+ method.</para>
+
+ <para>The first time you run <command>cpan</command>, you'll be prompted
+ to enter some information regarding download locations and methods. This
+ information is retained in files located in
+ <filename class='directory'>~/.cpan</filename>. Start the
+ <command>cpan</command> shell by issuing '<command>cpan</command>' as the
+ <systemitem class="username">root</systemitem> user. Any module may now
be
+ installed from the
+ <emphasis role='underlined'><prompt>cpan> </prompt></emphasis>
+ prompt with the command:</para>
+
+<screen role="root"><userinput>install
<replaceable><Module::Name></replaceable></userinput></screen>
+
+ <para>For additional commands and help, issue '<command>help</command>'
+ from the
+ <emphasis role='underlined'><prompt>cpan> </prompt></emphasis>
+ prompt.</para>
+
+ <para>Alternatively, for scripted or non-interactive installations, use
the
+ following syntax as the
+ <systemitem class="username">root</systemitem> user to install one or
more
+ modules:</para>
+
+<screen role="root"><userinput>cpan -i <replaceable><Module1::Name>
<Module2::Name></replaceable></userinput></screen>
+
+ <para>Review the <filename>cpan.1</filename> man page for additional
+ parameters you can pass to <command>cpan</command> on the command
+ line.</para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-deps.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps.xml Fri Sep 7 18:23:57
2018 (r20472)
@@ -0,0 +1,127 @@
+<?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;
+]>
+
+<sect1 id="perl-deps" xreflabel="Subsidiary Perl Modules">
+ <?dbhtml filename="perl-deps.html" ?>
+
+ <sect1info>
+ <othername>$LastChangedBy$</othername>
+ <date>$Date$</date>
+ </sect1info>
+
+ <title>Subsidiary Perl Modules</title>
+
+ <indexterm zone="new-perl-modules">
+ <primary sortas="a-perl-deps">Perl Dependencies</primary>
+ </indexterm>
+
+ <sect2 role="package">
+ <title>Perl Modules which are only required by other modules</title>
+
+ <para>
+ The modules on the previous page are referenced from other pages in BLFS,
+ but these modules are only in the book as dependencies of other modules.
+ If you use the CPAN install method, you do not need to read this page.
+ </para>
+
+ <para>
+ The BLFS editors pay much less attention to these modules, and the
+ versions will not be regularly reviewed. In all cases, only the required
or
+ recommended dependencies are listed - there might be other modules which
+ allow more tests to be run, but omitting them will still allow the tests
to
+ <literal>PASS</literal>.
+ </para>
+
+ <note>
+ <para>
+ The links on this page (to metacpan.org) should go to "known good"
+ versions, for which their dependencies are correct. If you wish to use
a
+ later version, please check the Changes file at https://metacpan.org -
+ sometimes added dependencies are listed, other times not. Some of these
+ modules have very frequent updates, often bringing different
dependencies.
+ <!-- FIXME - change or comment this when necessary -->
+ The linked metacpan.org versions below are known to build and work with
+ the module versions in BLFS-8.3
+ </para>
+
+ <para>
+ However, if you notice that the Changes file for a newer version than
is
+ in the current development book reports a fix for a security issue,
please
+ report this to either the blfs-dev or the blfs-support list.
+ </para>
+
+ <para>
+ Similarly, if you discover that an updated module on the previous page
+ needs an extra dependency, please report this.
+ </para>
+ </note>
+
+ <para condition="html" role="usernotes">User Notes:
+ <ulink url="&blfs-wiki;/perl-modules"/>
+ </para>
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ <xref linkend="new-perl-capture-tiny"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="perl-config-autoconf"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="perl-extutils-libbuilder"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="new-perl-sub-identify"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="perl-super"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="perl-test-mockmodule"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="new-perl-test-warnings"/>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-deps/perl-capture-tiny.xml"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-deps/perl-config-autoconf.xml"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-deps/perl-extutils-libbuilder.xml"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-deps/perl-sub-identify.xml"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-deps/perl-super.xml"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-deps/perl-test-mockmodule.xml"/>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="perl-deps/perl-test-warnings.xml"/>
+
+</sect1>
Added: branches/perl-modules/general/prog/perl-deps/perl-capture-tiny.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-capture-tiny.xml Fri Sep
7 18:23:57 2018 (r20472)
@@ -0,0 +1,56 @@
+<?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;/D/DA/DAGOLDEN/Capture-Tiny-&Capture-Tiny-version;.tar.gz">
+ <!ENTITY my-md5sum "f5d24083ad270f8326dd659dd83eeb54">
+
+]>
+
+ <!-- Begin Capture::Tiny -->
+ <sect2 id="new-perl-capture-tiny"
xreflabel="Capture-Tiny-&Capture-Tiny-version;">
+
+ <title>Capture::Tiny-&Capture-Tiny-version;</title>
+
+ <indexterm zone="new-perl-capture-tiny">
+ <primary sortas="a-Capture-Tiny">Capture::Tiny</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to Capture::Tiny</title>
+
+ <para>
+ The Capture::Tiny module captures STDOUT and STDERR from Perl, XS
+ (eXternal Subroutine, i.e. written in C or C++) or external programs.
+ </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 Capture::Tiny</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-deps/perl-config-autoconf.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-config-autoconf.xml
Fri Sep 7 18:23:57 2018 (r20472)
@@ -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;/R/RE/REHSACK/Config-AutoConf-&Config-AutoConf-version;.tar.gz">
+ <!ENTITY my-md5sum "29f87fc7803f1725f6daafcf416089ce">
+
+]>
+
+ <!-- Begin Config::AutoConf -->
+ <sect2 id="perl-config-autoconf"
xreflabel="Config-AutoConf-&Config-AutoConf-version;">
+
+ <title>Config::AutoConf-&Config-AutoConf-version;</title>
+
+ <indexterm zone="perl-config-autoconf">
+ <primary sortas="a-Config-AutoConf">Config::AutoConf</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to Config::AutoConf</title>
+
+ <para>
+ The Config::AutoConf module implements some of the AutoConf macros
+ (detecting a command, detecting a library, etc.) in pure perl.
+ </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">Config::AutoConf Dependencies</bridgehead>
+
+ <bridgehead renderas="sect5">Required</bridgehead>
+ <para role="required">
+ <xref linkend="new-perl-capture-tiny"/>
+ </para>
+
+ </sect3>
+
+ <sect3 role="installation">
+ <title>Installation of Config::AutoConf</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-deps/perl-extutils-libbuilder.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-extutils-libbuilder.xml
Fri Sep 7 18:23:57 2018 (r20472)
@@ -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;/A/AM/AMBS/ExtUtils-LibBuilder-&ExtUtils-LibBuilder-version;.tar.gz">
+ <!ENTITY my-md5sum "8ffe9e9a3c2f916f40dc4f6aed237d33">
+
+]>
+
+ <!-- Begin ExtUtils::LibBuilder -->
+ <sect2 id="perl-extutils-libbuilder"
xreflabel="ExtUtils-LibBuilder-&ExtUtils-LibBuilder-version;">
+
+ <title>ExtUtils::LibBuilder-&ExtUtils-LibBuilder-version;</title>
+
+ <indexterm zone="perl-extutils-libbuilder">
+ <primary sortas="a-ExtUtils-LibBuilder">ExtUtils::LibBuilder</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to ExtUtils::LibBuilder</title>
+
+ <para>
+ ExtUtils::LibBuilder is a tool to build C libraries.
+ </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">ExtUtils::LibBuilder
Dependencies</bridgehead>
+
+ <bridgehead renderas="sect5">Required</bridgehead>
+ <para role="required">
+ <xref linkend="new-perl-module-build"/>
+ </para>
+
+ </sect3>
+
+ <sect3 role="installation">
+ <title>Installation of ExtUtils::LibBuilder</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-build-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-deps/perl-sub-identify.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-sub-identify.xml Fri Sep
7 18:23:57 2018 (r20472)
@@ -0,0 +1,56 @@
+<?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;/R/RG/RGARCIA/Sub-Identify-&Sub-Identify-version;.tar.gz">
+ <!ENTITY my-md5sum "014f19e72698b6a2cbcb54adc9691825">
+
+]>
+
+ <!-- Begin Sub::Identify -->
+ <sect2 id="new-perl-sub-identify"
xreflabel="Sub-Identify-&Sub-Identify-version;">
+
+ <title>Sub::Identify-&Sub-Identify-version;</title>
+
+ <indexterm zone="new-perl-sub-identify">
+ <primary sortas="a-Sub-Identify">Sub::Identify</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to Sub::Identify</title>
+
+ <para>
+ Sub::Identify allows you to retrieve the real name of code references.
+ It is encouraged to migrate to Sub::Util (a core module) when possible.
+ </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 Sub::Identify</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-deps/perl-super.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-super.xml Fri Sep 7
18:23:57 2018 (r20472)
@@ -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;/C/CH/CHROMATIC/SUPER-&SUPER-version;.tar.gz">
+ <!ENTITY my-md5sum "51076638f973c02cb9e5828dce85010e">
+
+]>
+
+ <!-- Begin SUPER -->
+ <sect2 id="perl-super" xreflabel="SUPER-&SUPER-version;">
+
+ <title>SUPER-&SUPER-version;</title>
+
+ <indexterm zone="perl-super">
+ <primary sortas="a-SUPER">SUPER</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to SUPER</title>
+
+ <para>
+ SUPER provides easier methods to dispatch control to the superclass
+ (when subclassing a class).
+ </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">SUPER Dependencies</bridgehead>
+
+ <bridgehead renderas="sect5">Required</bridgehead>
+ <para role="required">
+ <xref linkend="new-perl-sub-identify"/> (for the testsuite)
+ </para>
+
+ </sect3>
+
+ <sect3 role="installation">
+ <title>Installation of SUPER</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-deps/perl-test-mockmodule.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-test-mockmodule.xml
Fri Sep 7 18:23:57 2018 (r20472)
@@ -0,0 +1,65 @@
+<?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/GF/GFRANKS/Test-MockModule-&Test-MockModule-version;.tar.gz">
+ <!ENTITY my-md5sum "2af3d00f52c6a7c42d5f7333aa98f476">
+
+]>
+
+ <!-- Begin Test::MockModule -->
+ <sect2 id="perl-test-mockmodule"
xreflabel="Test-MockModule-&Test-MockModule-version;">
+
+ <title>Test::MockModule-&Test-MockModule-version;</title>
+
+ <indexterm zone="perl-test-mockmodule">
+ <primary sortas="a-Test-MockModule">Test::MockModule</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to Test::MockModule</title>
+
+ <para>
+ Test::MockModule lets you temporarily redefine subroutines in other
+ packages for the purposes of unit testing.
+ </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">Test::MockModule Dependencies</bridgehead>
+
+ <bridgehead renderas="sect5">Required</bridgehead>
+ <para role="required">
+ <xref linkend="new-perl-module-build"/>,
+ <xref linkend="perl-super"/>, and
+ <xref linkend="new-perl-test-warnings"/> (for the testsuite)
+ </para>
+
+ </sect3>
+
+ <sect3 role="installation">
+ <title>Installation of Test::MockModule</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-build-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-deps/perl-test-warnings.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-deps/perl-test-warnings.xml Fri Sep
7 18:23:57 2018 (r20472)
@@ -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;/E/ET/ETHER/Test-Warnings-&Test-Warnings-version;.tar.gz">
+ <!ENTITY my-md5sum "1a379f7eac4c89155d98e652459593a7">
+
+]>
+
+ <!-- Begin Test::Warnings -->
+ <sect2 id="new-perl-test-warnings"
xreflabel="Test-Warnings-&Test-Warnings-version;">
+
+ <title>Test::Warnings-&Test-Warnings-version;</title>
+
+ <indexterm zone="new-perl-test-warnings">
+ <primary sortas="a-Test-Warnings">Test::Warnings</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to Test::Warnings</title>
+
+ <para>
+ Test::Warnings tests for warnings and the lack of 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 Test::Warnings</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Modified: branches/perl-modules/general/prog/perl-modules.xml
==============================================================================
--- trunk/BOOK/general/prog/perl-modules.xml Fri Sep 7 13:23:37 2018
(r20471)
+++ branches/perl-modules/general/prog/perl-modules.xml Fri Sep 7 18:23:57
2018 (r20472)
@@ -6,7 +6,8 @@
(Abandon all hope, ye who enter here). -->
%general-entities;
- <!ENTITY perl_authors "https://www.cpan.org/authors";>
+<!-- moved to general.ent
+ <!ENTITY perl_authors "https://www.cpan.org/authors";>-->
<!ENTITY Archive-Zip-download-http
"&perl_authors;/id/P/PH/PHRED/Archive-Zip-&Archive-Zip-version;.tar.gz">
<!ENTITY Archive-Zip-md5sum "0576016be1e676cacebc447e2463dc44">
@@ -185,7 +186,7 @@
<date>$Date$</date>
</sect1info>
- <title>Perl Modules</title>
+ <title>Perl Modules (old page)</title>
<indexterm zone="perl-modules">
<primary sortas="a-Perl-modules">Perl modules</primary>
Added: branches/perl-modules/general/prog/perl-modules/perl-archive-zip.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-modules/perl-archive-zip.xml
Fri Sep 7 18:23:57 2018 (r20472)
@@ -0,0 +1,95 @@
+<?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/P/PH/PHRED/Archive-Zip-&Archive-Zip-version;.tar.gz">
+ <!ENTITY my-md5sum "0576016be1e676cacebc447e2463dc44">
+
+]>
+
+ <!-- Begin Archive::Zip -->
+ <sect2 id="new-perl-archive-zip"
xreflabel="Archive-Zip-&Archive-Zip-version;">
+
+ <title>Archive::Zip-&Archive-Zip-version;</title>
+
+ <indexterm zone="new-perl-archive-zip">
+ <primary sortas="a-Archive-Zip">Archive::Zip</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to Archive::Zip</title>
+
+ <para>
+ The Archive::Zip module allows a Perl program to create, manipulate,
+ read, and write Zip archive files.
+ </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">Archive::Zip Dependencies</bridgehead>
+
+ <bridgehead renderas="sect5">Required</bridgehead>
+ <para role="required">
+ <xref linkend="perl-test-mockmodule"/> (for the testsuite)
+ </para>
+
+ </sect3>
+
+ <sect3 role="installation">
+ <title>Installation of Archive::Zip</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>.
+ </para>
+
+ </sect3>
+
+ <sect3 role="content">
+ <title>Contents</title>
+
+ <segmentedlist>
+ <segtitle>Installed Programs</segtitle>
+
+ <seglistitem>
+ <seg>
+ crc32
+ </seg>
+ </seglistitem>
+ </segmentedlist>
+
+ <variablelist>
+ <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+ <?dbfo list-presentation="list"?>
+ <?dbhtml list-presentation="table"?>
+
+ <varlistentry id="crc32-prog">
+ <term><command>crc32</command></term>
+ <listitem>
+ <para>computes and prints to stdout the CRC-32 values of the given
files.</para>
+ <indexterm zone="new-perl-archive-zip crc32-prog">
+ <primary sortas="b-crc32">crc32</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-modules/perl-autovivification.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-modules/perl-autovivification.xml
Fri Sep 7 18:23:57 2018 (r20472)
@@ -0,0 +1,58 @@
+<?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/V/VP/VPIT/autovivification-&autovivification-version;.tar.gz">
+ <!ENTITY my-md5sum "8dec994e1e7d368e055f21a5777385a0">
+
+]>
+
+ <!-- Begin Autovivification -->
+ <sect2 id="new-perl-autovivification"
xreflabel="autovivification-&autovivification-version;">
+
+ <title>autovivification-&autovivification-version;</title>
+
+ <indexterm zone="new-perl-autovivification">
+ <primary sortas="a-autovivification">autovivification</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to the autovivification module</title>
+
+ <para>
+ This module allows you disable autovivification (the automatic creation
+ and population of new arrays and hashes whenever undefined variables
are
+ dereferenced), and optionally throw a warning or an error when it would
+ have occurred.
+ </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 autovivification</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-modules/perl-business-issn.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-modules/perl-business-issn.xml
Fri Sep 7 18:23:57 2018 (r20472)
@@ -0,0 +1,57 @@
+<?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/B/BD/BDFOY/Business-ISSN-&Business-ISSN-version;.tar.gz">
+ <!ENTITY my-md5sum "6720f5ff3a8e7cb4d84aa35c78d8536c">
+
+]>
+
+ <!-- Begin Business::ISSN -->
+ <sect2 id="new-perl-business-issn"
xreflabel="Business-ISSN-&Business-ISSN-version;">
+
+ <title>Business::ISSN-&Business-ISSN-version;</title>
+
+ <indexterm zone="new-perl-business-issn">
+ <primary sortas="a-Business-ISSN">Business::ISSN</primary>
+ </indexterm>
+
+
+ <sect3 role="package">
+ <title>Introduction to Business::ISSN</title>
+
+ <para>
+ The Business::ISSN module is for work with International Standard
+ Serial Numbers.
+ </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 Business::ISSN</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-modules/perl-module-build.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-modules/perl-module-build.xml
Fri Sep 7 18:23:57 2018 (r20472)
@@ -0,0 +1,59 @@
+<?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/L/LE/LEONT/Module-Build-&Module-Build-version;.tar.gz">
+ <!ENTITY my-md5sum "b74c2f6e84b60aad3a3defd30b6f0f4d">
+
+]>
+
+ <!-- Begin Module::Build -->
+ <sect2 id="new-perl-module-build"
xreflabel="Module-Build-&Module-Build-version;">
+
+ <title>Module::Build-&Module-Build-version;</title>
+
+ <indexterm zone="new-perl-module-build">
+ <primary sortas="a-Module-Build">Module::Build</primary>
+ </indexterm>
+
+
+ <sect3 role="package">
+ <title>Introduction to Module::Build</title>
+
+ <para>
+ Module::Build allows perl modules to be built without a
+ <command>make</command> command being present.
+ </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 Module::Build</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>,
+ but it can also use the legacy <xref
linkend="new-perl-build-install"/>.
+ </para>
+
+ </sect3>
+
+ </sect2>
Added: branches/perl-modules/general/prog/perl-modules/perl-text-bibtex.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/general/prog/perl-modules/perl-text-bibtex.xml
Fri Sep 7 18:23:57 2018 (r20472)
@@ -0,0 +1,133 @@
+<?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/A/AM/AMBS/Text-BibTeX-&Text-BibTeX-version;.tar.gz">
+ <!ENTITY my-md5sum "eff0352d6de29a8d4d61efcc7774186c">
+
+]>
+
+ <!-- Begin Text::BibTeX -->
+ <sect2 id="new-perl-text-bibtex"
xreflabel="Text-BibTeX-&Text-BibTeX-version;">
+
+ <title>Text::BibTeX-&Text-BibTeX-version;</title>
+
+ <indexterm zone="new-perl-text-bibtex">
+ <primary sortas="a-Text-BibTeX">Text::BibTeX</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to Text::BibTeX</title>
+
+ <para>
+ Text::BibTeX provides an interface to read and parse
+ <application>BibTeX</application> files.
+ </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">Text::BibTex Dependencies</bridgehead>
+
+ <bridgehead renderas="sect5">Required</bridgehead>
+ <para role="required">
+ <xref linkend="perl-config-autoconf"/>,
+ <xref linkend="perl-extutils-libbuilder"/> and
+ <xref linkend="new-perl-module-build"/>
+ </para>
+
+ </sect3>
+
+ <sect3 role="installation">
+ <title>Installation of Text::BibTeX</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-build-install"/>.
+ </para>
+
+ </sect3>
+
+ <sect3 role="content">
+ <title>Contents</title>
+
+ <segmentedlist>
+ <segtitle>Installed Programs</segtitle>
+ <segtitle>Installed Libraries</segtitle>
+
+ <seglistitem>
+ <seg>
+ biblex, libparse, dumpnames
+ </seg>
+ <seg>
+ libtparse.so
+ </seg>
+ </seglistitem>
+ </segmentedlist>
+
+ <variablelist>
+ <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+ <?dbfo list-presentation="list"?>
+ <?dbhtml list-presentation="table"?>
+
+ <varlistentry id="biblex-prog">
+ <term><command>biblex</command></term>
+ <listitem>
+ <para>performs lexical analysis on a BibTeX file.</para>
+ <indexterm zone="new-perl-text-bibtex biblex-prog">
+ <primary sortas="b-biblex">biblex</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="bibparse-prog">
+ <term><command>bibparse</command></term>
+ <listitem>
+ <para>parses a series of BibTeX files with command line options to
+ control the string post-processing behaviour.</para>
+ <indexterm zone="new-perl-text-bibtex bibparse-prog">
+ <primary sortas="b-bibparse">bibparse</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="dumpnames-prog">
+ <term><command>dumpnames</command></term>
+ <listitem>
+ <para>parses a BibTeX file, splitting 'author' and 'editor' fields
+ into lists of names, and then dumps everything to stdout.</para>
+ <indexterm zone="new-perl-text-bibtex dumpnames-prog">
+ <primary sortas="b-dumpnames">dumpnames</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="libbtparse-lib">
+ <term><filename class='libraryfile'>libbtparse.so</filename></term>
+ <listitem>
+ <para>is a library for parsing and processing BibTeX data
files.</para>
+ <indexterm zone="new-perl-text-bibtex libbtparse-lib">
+ <primary sortas="c-libbtparse">libbtparse.so</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect3>
+
+ </sect2>
Modified: branches/perl-modules/general/prog/prog.xml
==============================================================================
--- trunk/BOOK/general/prog/prog.xml Fri Sep 7 13:23:37 2018 (r20471)
+++ branches/perl-modules/general/prog/prog.xml Fri Sep 7 18:23:57 2018
(r20472)
@@ -47,6 +47,8 @@
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="nasm.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="ninja.xml"/>
<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="php.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="python2.xml"/>
Modified: branches/perl-modules/packages.ent
==============================================================================
--- trunk/BOOK/packages.ent Fri Sep 7 13:23:37 2018 (r20471)
+++ branches/perl-modules/packages.ent Fri Sep 7 18:23:57 2018 (r20472)
@@ -406,6 +406,16 @@
<!ENTITY XML-Simple-version "2.25">
<!ENTITY XML-Writer-version "0.625">
+<!-- perl modules which are only in the book as deps of other modules
+ DO NOT RUN DAILY TESTS FOR NEWER VERSIONS -->
+<!ENTITY Capture-Tiny-version "0.48">
+<!ENTITY Config-AutoConf-version "0.317">
+<!ENTITY ExtUtils-LibBuilder-version "0.06">
+<!ENTITY Sub-Identify-version "0.14">
+<!ENTITY SUPER-version "1.20141117">
+<!ENTITY Test-MockModule-version "0.15">
+<!ENTITY Test-Warnings-version "0.026">
+
<!-- Python module versions used in the Python Modules instructions -->
<!ENTITY Beaker-version "1.10.0">
<!ENTITY docutils-version "0.14">
Modified: branches/perl-modules/pst/typesetting/biber.xml
==============================================================================
--- trunk/BOOK/pst/typesetting/biber.xml Fri Sep 7 13:23:37 2018
(r20471)
+++ branches/perl-modules/pst/typesetting/biber.xml Fri Sep 7 18:23:57
2018 (r20472)
@@ -105,10 +105,10 @@
requirements in Build.PL, the rest are just requirements, but the
difference seems moot. Those two are needed to build Text::BibTeX
so not listed separately. -->
- <xref linkend="perl-autovivification"/>
+ <xref linkend="new-perl-autovivification"/>
<xref linkend="perl-business-isbn"/>
<xref linkend="perl-business-ismn"/>
- <xref linkend="perl-business-issn"/>
+ <xref linkend="new-perl-business-issn"/>
<xref linkend="perl-class-accessor"/>
<xref linkend="perl-data-compare"/>
<xref linkend="perl-data-dump"/>
@@ -136,12 +136,12 @@
that is pulled in by LWP::Protocol::https -->
<!-- Module::Build is pulled in by perl-text-bibtex, but mention it
explicitly
so that the note on automatically installing missing dependencies can be
run -->
- <xref linkend="perl-module-build"/>
+ <xref linkend="new-perl-module-build"/>
<!-- Mozilla::CA is a dependency of LWP-Protocol-https -->
<xref linkend="perl-perlio-utf8_strict"/>
<xref linkend="perl-regexp-common"/>
<xref linkend="perl-sort-key"/>
- <xref linkend="perl-text-bibtex"/>
+ <xref linkend="new-perl-text-bibtex"/>
<xref linkend="perl-text-csv"/>
<!-- Text-CSV_XS is a recommended dependency for Text-CSV -->
<xref linkend="perl-text-roman"/>
@@ -173,9 +173,12 @@
<note>
<para>
It is possible to install all missing dependencies automatically.
+<!-- Module::Build can now be built using perl Makefile.PL, so does not need to
+ be installed in advance
But from <application>perl-5.22.0</application> onwards,
<xref linkend="perl-module-build"/> is no longer part of the core perl
- distribution. And for <xref linkend="perl-data-uniqid"/> we have to
+ distribution. And for -->
+ 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 those two modules first using <xref
Added: branches/perl-modules/template/template-perl-module.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/template/template-perl-module.xml Fri Sep 7
18:23:57 2018 (r20472)
@@ -0,0 +1,113 @@
+<?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;
+
+ <!-- for modules referenced outside of perl, put them in
general/prog/perl-modules/
+ and use a link to &perl_authors;/id/X/XY/XYZZY/Fu-Bar-$Fu-Bar-version; -->
+ <!ENTITY my-download-http
"&perl_authors;/id/X/XY/XYZZY/Fu-Bar-&Fu-Bar-version;.tar.gz">
+ <!-- but for modules which are only dependencies of other modules, put them in
+ general/pprog/perl-deps with a link to &metacpan_authors; that includes the
/id part -->
+ <!ENTITY my-download-http
"&metacpan_authors;/X/XY/XYZZY/Fu-Bar-&Fu-Bar-version;.tar.gz">
+ <!-- only one of the above choices -->
+ <!ENTITY my-md5sum "eff0352d6de29a8d4d61efcc7774186c">
+
+]>
+
+ <!-- Begin Fu::Bar -->
+ <sect2 id="new-perl-fu-bar" xreflabel="Fu-Bar-&Fu-Bar-version;">
+
+ <title>Fu::Bar-&Fu-Bar-version;</title>
+
+ <indexterm zone="new-perl-fu-bar">
+ <primary sortas="a-Fu-Bar">Fu::Bar</primary>
+ </indexterm>
+
+ <sect3 role="package">
+ <title>Introduction to Fu::Bar</title>
+
+ <para>
+ Fu::Bar does something.
+ </para>
+
+<!-- &lfs8x_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>
+
+ <!-- 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. -->
+ <bridgehead renderas="sect4">Fu::Bar Dependencies</bridgehead>
+
+ <bridgehead renderas="sect5">Required</bridgehead>
+ <para role="required">
+ <xref linkend="perl-bar-baz"/>,
+ <xref linkend="perl-wibble"/> and
+ <xref linkend="new-perl-wobble"/>
+ </para>
+
+ </sect3>
+
+ <sect3 role="installation">
+ <title>Installation of Fu::Bar</title>
+
+ <para>
+ This module uses the <xref linkend="new-perl-standard-install"/>.
+ </para>
+
+ </sect3>
+
+ <!-- omit content unless prog(s) or lib is installed in /usr -->
+ <sect3 role="content">
+ <title>Contents</title>
+
+ <segmentedlist>
+ <segtitle>Installed Programs</segtitle>
+ <!-- omit libraries entirely unless present in /usr, there are often
+ perl libraries in site-perl so 'none' can be misleading -->
+ <segtitle>Installed Libraries</segtitle>
+
+ <seglistitem>
+ <seg>
+ dibbler
+ </seg>
+ </seglistitem>
+ </segmentedlist>
+
+ <variablelist>
+ <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+ <?dbfo list-presentation="list"?>
+ <?dbhtml list-presentation="table"?>
+
+ <varlistentry id="dibbler-prog">
+ <term><command>dibbler</command></term>
+ <listitem>
+ <para>sells sausage inna bun.</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-fu-bar dibbler-prog">
+ <primary sortas="b-dibbler">dibbler</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect3>
+
+ </sect2>
Modified: branches/perl-modules/xsoft/office/libreoffice.xml
==============================================================================
--- trunk/BOOK/xsoft/office/libreoffice.xml Fri Sep 7 13:23:37 2018
(r20471)
+++ branches/perl-modules/xsoft/office/libreoffice.xml Fri Sep 7 18:23:57
2018 (r20472)
@@ -155,7 +155,7 @@
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
- <xref linkend="perl-archive-zip"/>,
+ <xref linkend="new-perl-archive-zip"/>,
<xref linkend="unzip"/>,
<xref linkend="wget"/>,
<xref linkend="which"/>, and
--
http://lists.linuxfromscratch.org/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
