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