source: general/prog/perl-modules.xml@ 69a39a2

<?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 perl_modules_md5sums_download_http "&sources-anduin-http;/perl-modules/">
  <!ENTITY perl_modules_md5sums_download_ftp  "&sources-anduin-ftp;/perl-modules/">
  <!ENTITY perl_authors  "http://cpan.metacpan.org/authors">
]>

<!-- FIXME (I only used that so that this gets highlighted by vim ;-)
 If you have the misfortune to have to add a new module which puts a program
 into /usr/bin/, please document it at the end of the page.  'perldoc' is
 sometimes a good place to start, then for scripts look at any comments in the
 script, and if you get a package like Text::BibTeX with compiled progs and
 library, loook at the comments in the code -->
<sect1 id="perl-modules" xreflabel="Perl modules">
  <?dbhtml filename="perl-modules.html" ?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Perl Modules</title>

  <indexterm zone="perl-modules">
    <primary sortas="a-Perl-modules">Perl modules</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Perl Modules</title>

    <para>The <application>Perl</application> module packages add useful
    objects to the <application>Perl</application> language. Modules utilized
    by packages throughout BLFS are listed here, along with their dependencies.
    Installation of the modules shown on this page should be accomplished by
    installing the dependencies in the order listed. The Perl Module standard
    build and installation instructions are shown at the bottom of this page.
    </para>

    <!-- <itemizedlist spacing="compact">
      <listitem>
        <para>Download MD5 sums (HTTP):
        <ulink url="&perl_modules_md5sums_download_http;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sums (FTP):
        <ulink url="&perl_modules_md5sums_download_ftp;"/></para>
      </listitem>
    </itemizedlist> -->

    <!-- Archive::Zip -->
    <bridgehead renderas="sect3" id="perl-archive-zip"
    xreflabel="Archive::Zip-&Archive-Zip-version;">
    Archive::Zip-&Archive-Zip-version;</bridgehead>

    <indexterm zone="perl-modules perl-archive-zip">
      <primary sortas="a-Archive-Zip">Archive::Zip</primary>
    </indexterm>

    <para>The Archive::Zip module allows a <application>Perl</application>
    program to create, manipulate, read, and write Zip archive files. This
    module uses the standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://cpan.metacpan.org/authors/id/P/PH/PHRED/Archive-Zip-&Archive-Zip-version;.tar.gz">Archive::Zip-&Archive-Zip-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://cpan.metacpan.org/authors/id/P/PH/PHRED/Archive-Zip-&Archive-Zip-version;.tar.gz
MD5 sum: 44830965095d3ab66beff48eddb1c478</literallayout>
      </listitem>
    </itemizedlist>

    <!-- autovivification -->
    <bridgehead renderas="sect3" id="perl-autovivification"
    xreflabel="autovivification-&autovivification-version;">
    autovivification-&autovivification-version;</bridgehead>

    <indexterm zone="perl-modules perl-autovivification">
      <primary sortas="a-autovivification">autovivification</primary>
    </indexterm>

    <para>The autovivification module allows you to lexically disable
    autovivification. This module uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/V/VP/VPIT/autovivification-&autovivification-version;.tar.gz">autovivification-&autovivification-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/V/VP/VPIT/autovivification-&autovivification-version;.tar.gz
MD5 sum: bf0f5133a32685218e8d7ad1aba02deb</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Business::ISBN -->
    <bridgehead renderas="sect3" id="perl-business-isbn"
    xreflabel="Business::ISBN-&Business-ISBN-version;">
    Business::ISBN-&Business-ISBN-version;</bridgehead>

    <indexterm zone="perl-modules perl-business-isbn">
      <primary sortas="a-Business-ISBN">Business::ISBN</primary>
    </indexterm>

    <para>The Business::ISBN module is for work with International Standard Book
    Numbers.  This module and its dependency use the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">Business::ISBN-&Business-ISBN-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz
MD5 sum: 5ebf339c409d99cdfa6f96974ef96780</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/~bdfoy/Business-ISBN-Data/">Business::ISBN::Data</ulink>
(http://search.cpan.org/~bdfoy/Business-ISBN-Data/)</literallayout>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- Business::ISMN -->
    <bridgehead renderas="sect3" id="perl-business-ismn"
    xreflabel="Business::ISMN-&Business-ISMN-version;">
    Business::ISMN-&Business-ISMN-version;</bridgehead>

    <indexterm zone="perl-modules perl-business-ismn">
      <primary sortas="a-Business-ISMN">Business::ISMN</primary>
    </indexterm>

    <para>The Business::ISMN module is for work with International Standard
    Music Numbers.  This module uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://search.cpan.org/CPAN/authors/id/B/BD/BDFOY/Business-ISMN-&Business-ISMN-version;.tar.gz">Business::ISMN-&Business-ISMN-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://search.cpan.org/CPAN/authors/id/B/BD/BDFOY/Business-ISMN-&Business-ISMN-version;.tar.gz
MD5 sum: e8696a78b4aa8a99869fbb0625c5cc13</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/~bdfoy/Tie-Cycle/">Tie::Cycle</ulink>
(http://search.cpan.org/~bdfoy/Tie-Cycle/)</literallayout>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- Business::ISSN -->
    <bridgehead renderas="sect3" id="perl-business-issn"
    xreflabel="Business::ISSN-&Business-ISSN-version;">
    Business::ISSN-&Business-ISSN-version;</bridgehead>

    <indexterm zone="perl-modules perl-business-issn">
      <primary sortas="a-Business-ISSN">Business::ISSN</primary>
    </indexterm>

    <para>The Business::ISSN module is for work with International Standard
    Serial Numbers.  This module uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/B/BD/BDFOY/Business-ISSN-&Business-ISSN-version;.tar.gz">Business::ISSN-&Business-ISSN-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/B/BD/BDFOY/Business-ISSN-&Business-ISSN-version;.tar.gz 
MD5 sum: d1f609422d3a0ad5e301ae694d142fe4</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Data::Compare -->
    <bridgehead renderas="sect3" id="perl-data-compare"
    xreflabel="Data::Compare-&Data-Compare-version;">
    Data::Compare-&Data-Compare-version;</bridgehead>

    <indexterm zone="perl-modules perl-data-compare">
      <primary sortas="a-Data-Compare">Data::Compare</primary>
    </indexterm>

    <para>The Data::Compare module compares two <application>perl</application>
    data structures. This module and its dependencies use the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/D/DC/DCANTRELL/Data-Compare-&Data-Compare-version;.tar.gz">Data::Compare-&Data-Compare-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/D/DC/DCANTRELL/Data-Compare-&Data-Compare-version;.tar.gz
MD5 sum: 6a397ab5833237f3ca05ed7277b19a7a</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/~rclamp/File-Find-Rule/">File::Find::Rule</ulink>
(http://search.cpan.org/~rclamp/File-Find-Rule/)</literallayout>
            <itemizedlist>
              <listitem> <literallayout><ulink url="http://search.cpan.org/dist/Number-Compare/">Number::Compare</ulink>
(http://search.cpan.org/dist/Number::Compare/)</literallayout>
              </listitem>
              <listitem> <literallayout><ulink url="http://search.cpan.org/dist/Text-Glob/">Text::Glob</ulink>
(http://search.cpan.org/dist/Text::Glob/)</literallayout>
              </listitem>
            </itemizedlist>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- Data::Dump -->
    <bridgehead renderas="sect3" id="perl-data-dump"
    xreflabel="Data::Dump-&Data-Dump-version;">
    Data::Dump-&Data-Dump-version;</bridgehead>

    <indexterm zone="perl-modules perl-data-dump">
      <primary sortas="a-Data-Dump">Data::Dump</primary>
    </indexterm>

    <para>This module provides pretty printing of data structures. It uses
    the standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/G/GA/GAAS/Data-Dump-&Data-Dump-version;.tar.gz">Data::Dump-&Data-Dump-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/G/GA/GAAS/Data-Dump-&Data-Dump-version;.tar.gz
MD5 sum: db211fe64a5cab15b1e86e5b0dc379a4</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Date::Simple -->
    <bridgehead renderas="sect3" id="perl-date-simple"
    xreflabel="Date::Simple-&Date-Simple-version;">
    Date::Simple-&Date-Simple-version;</bridgehead>

    <indexterm zone="perl-modules perl-date-simple">
      <primary sortas="a-Date-Simple">Date::Simple</primary>
    </indexterm>

    <para>Date::Simple provides a simple date object. This module uses the
    standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/I/IZ/IZUT/Date-Simple-&Date-Simple-version;.tar.gz">Date::Simple-&Date-Simple-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/I/IZ/IZUT/Date-Simple-&Date-Simple-version;.tar.gz
MD5 sum: 436049dc2c7dfd8423d8bcc807248b31</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Encode::EUCJPASCII -->
    <bridgehead renderas="sect3" id="perl-encode-eucjpascii"
    xreflabel="Encode::EUCJPASCII-&Encode-EUCJPASCII-version;">
    Encode::EUCJPASCII-&Encode-EUCJPASCII-version;</bridgehead>

    <indexterm zone="perl-modules perl-encode-eucjpascii">
      <primary sortas="a-Encode-EUCJPASCII">Encode::EUCJPASCII</primary>
    </indexterm>

    <para>Encode::EUCJPASCII provides an eucJP-open mapping. This module uses the
    standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/N/NE/NEZUMI/Encode-EUCJPASCII-&Encode-EUCJPASCII-version;.tar.gz">Encode-EUCJPASCII-&Encode-EUCJPASCII-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/N/NE/NEZUMI/Encode-EUCJPASCII-&Encode-EUCJPASCII-version;.tar.gz
MD5 sum: 5daa65f55b7c2050bb0713d9e95f239d</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Encode::HanExtra -->
    <bridgehead renderas="sect3" id="perl-encode-hanextra"
    xreflabel="Encode::HanExtra-&Encode-HanExtra-version;">
    Encode::HanExtra-&Encode-HanExtra-version;</bridgehead>

    <indexterm zone="perl-modules perl-encode-hanextra">
      <primary sortas="a-Encode-HanExtra">Encode::HanExtra</primary>
    </indexterm>

    <para>The Encode::HanExtra module provides extra sets of Chinese Encodings.
    This module uses the standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/A/AU/AUDREYT/Encode-HanExtra-&Encode-HanExtra-version;.tar.gz">Encode::HanExtra-&Encode-HanExtra-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/A/AU/AUDREYT/Encode-HanExtra-&Encode-HanExtra-version;.tar.gz
MD5 sum: e1d3bc32c1c8ee304235a06fbcd5d5a4</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Encode::JIS2K -->
    <bridgehead renderas="sect3" id="perl-encode-jis2k"
    xreflabel="Encode::JIS2K-&Encode-JIS2K-version;">
    Encode::JIS2K-&Encode-JIS2K-version;</bridgehead>

    <indexterm zone="perl-modules perl-encode-jis2k">
      <primary sortas="a-Encode-JIS2K">Encode::JIS2K</primary>
    </indexterm>

    <para>The Encode::JIS2K module provides JIS X 0212 (aka JIS 2000)
    Encodings. This module uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/D/DA/DANKOGAI/Encode-JIS2K-&Encode-JIS2K-version;.tar.gz">Encode::JIS2K-&Encode-JIS2K-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/D/DA/DANKOGAI/Encode-JIS2K-&Encode-JIS2K-version;.tar.gz 
MD5 sum: 00e73ee943fb2f882b00b7b61e4c9db1</literallayout>
      </listitem>
    </itemizedlist>

    <!-- File::Slurp -->
    <bridgehead renderas="sect3" id="perl-file-slurp"
    xreflabel="File::Slurp-&File-Slurp-version;">
    File::Slurp-&File-Slurp-version;</bridgehead>

    <indexterm zone="perl-modules perl-file-slurp">
      <primary sortas="a-File-Slurp">File::Slurp</primary>
    </indexterm>

    <para>The File::Slurp module provides Simple and Efficient
    Reading/Writing/Modifying of Complete Files.  This module uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/U/UR/URI/File-Slurp-&File-Slurp-version;.tar.gz">File::Slurp-&File-Slurp-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/U/UR/URI/File-Slurp-&File-Slurp-version;.tar.gz
MD5 sum: 7d584cd15c4f8b9547765eff8c4ef078</literallayout>
      </listitem>
    </itemizedlist>

    <!-- File::Which -->
    <bridgehead renderas="sect3" id="perl-file-which"
    xreflabel="File::Which-&File-Which-version;">
    File::Which-&File-Which-version;</bridgehead>

    <indexterm zone="perl-modules perl-file-which">
      <primary sortas="a-File-Which">File::Which</primary>
    </indexterm>

    <para>File::Which provides a portable implementation of the
    &apos;which&apos; utility. This module and its dependencies use the standard
    <xref linkend="perl-standard-install"/>.</para>

    &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="&perl_authors;/id/P/PL/PLICEASE/File-Which-&File-Which-version;.tar.gz">
          File::Which-&File-Which-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>&perl_authors;/id/P/PL/PLICEASE/File-Which-&File-Which-version;.tar.gz
MD5 sum: 554bfb36568d828fbeee64f4b9a9faa8</literallayout>
      </listitem>
    </itemizedlist>

<!--    <!- Glib ->
    <bridgehead renderas="sect3" id="perl-glib"
    xreflabel="Glib-&Glib-perl-version;">
    Glib-&Glib-perl-version;</bridgehead>

    <indexterm zone="perl-modules perl-glib">
      <primary sortas="a-Glib">Glib</primary>
    </indexterm>

    <para>
      This module is a <application>Perl</application> wrapper around
      <application>GLib</application> that attempts to provide a perlish
      interface while remaining as true as possible to the underlying C API, so
      that any reference materials you can find on using GLib may still apply to
      using the libraries from Perl. This module and the dependency modules use
      the standard <xref linkend="perl-standard-install"/>.
    </para>

    &lfs7 4_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/T/TS/TSCH/Glib-&Glib-perl-version;.tar.gz">
          Glib-&Glib-perl-version;</ulink> (MD5 sum: 1d81a8aec5f7f1182a96cfaaf119d866)
        </para>
        <itemizedlist>
          <listitem>
            <para>
              <ulink url="http://search.cpan.org/~xaoc/ExtUtils-PkgConfig/">ExtUtils::PkgConfig</ulink>
            </para>
            <itemizedlist>
              <listitem>
                <para>
                  <ulink url="http://search.cpan.org/~flora/ExtUtils-Depends/">ExtUtils::Depends</ulink>
                </para>
              </listitem>
            </itemizedlist>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>
-->
    <!-- HTML::Parser -->
    <bridgehead renderas="sect3" id="perl-html-parser"
    xreflabel="HTML::Parser-&HTML-Parser-version;">
    HTML::Parser-&HTML-Parser-version;</bridgehead>

    <indexterm zone="perl-modules perl-html-parser">
      <primary sortas="a-HTML-Parser">HTML::Parser</primary>
    </indexterm>

    <para>The HTML::Parser distribution is a collection of modules that parse
    and extract information from HTML documents. This module and the dependency
    modules use the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">HTML::Parser-&HTML-Parser-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz
MD5 sum: 9128a45893097dfa3bf03301b19c5efe</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/~petdance/HTML-Tagset/">HTML::Tagset</ulink>
(http://search.cpan.org/~petdance/HTML-Tagset/)</literallayout>
          </listitem>
          <listitem>
            <para>
              <xref linkend="perl-lwp"/> (circular; howevever, it can
              be installed after HTML::Parser as it is only a run-time
              requirement for the included HTML::HeadParser module)
            </para>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- HTML::TableExtract
    <bridgehead renderas="sect3" id="perl-html-tableextract"
    xreflabel="HTML::TableExtract-&HTML-TableExtract-version;">
    HTML::TableExtract-&HTML-TableExtract-version;</bridgehead>

    <indexterm zone="perl-modules perl-html-tableextract">
      <primary sortas="a-HTML-TableExtract">HTML::TableExtract</primary>
    </indexterm>

    <para>HTML::TableExtract is a module that simplifies the extraction of the
    content contained in tables within HTML documents, extracted either as
    text or encoded element trees. Tables of note may be specified using
    Headers, Depth, Count, Attributes, or some combination of the four. This
    module and dependency modules use the standard
    <xref linkend="perl-standard-install"/>.</para>

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
          HTML::TableExtract-&HTML-TableExtract-version;</ulink> (MD5sum: ac1b8fa092d53931a9f3fdbba330f5b0)
        </para>
        <itemizedlist>
          <listitem>
            <para>
              <ulink url="http://search.cpan.org/~msisk/HTML-Element-Extended/">HTML::Element::Extended</ulink>
            </para>
            <itemizedlist>
              <listitem>
                <para>
                  <ulink url="http://search.cpan.org/~cjm/HTML-Tree/">HTML::Tree</ulink>
                </para>
                <itemizedlist>
                  <listitem>
                    <para>
                      <xref linkend="perl-html-parser"/>
                    </para>
                  </listitem>
                  <listitem>
                    <para>
                      <ulink url="http://search.cpan.org/dist/Test-Fatal/">Test::Fatal</ulink>
                      (optionally used in the test suite)
                    </para>
                    <itemizedlist>
                      <listitem>
                        <para>
                          <ulink url="http://search.cpan.org/~doy/Try-Tiny/">Try::Tiny</ulink>
                        </para>
                      </listitem>
                    </itemizedlist>
                  </listitem>
                </itemizedlist>
              </listitem>
            </itemizedlist>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist> -->

    <!-- IPC::Run3 -->
    <bridgehead renderas="sect3" id="perl-ipc-run3"
    xreflabel="IPC::Run3-&IPC-Run3-version;">
    IPC::Run3-&IPC-Run3-version;</bridgehead>

    <indexterm zone="perl-modules perl-ipc-run3">
      <primary sortas="a-IPC-Run3">IPC::Run3</primary>
    </indexterm>

    <para>The IPC::Run3 module is used to run a subprocess with input/ouput
    redirection.  This module uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/R/RJ/RJBS/IPC-Run3-&IPC-Run3-version;.tar.gz">IPC-Run3-&IPC-Run3-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/R/RJ/RJBS/IPC-Run3-&IPC-Run3-version;.tar.gz
MD5 sum: 85b36bcd2fd2450718ee14f894f0d3d1</literallayout>
      </listitem>
    </itemizedlist>

    <!-- LWP (but listed as libwww-perl) -->
    <bridgehead renderas="sect3" id="perl-lwp"
    xreflabel="libwww-perl-&LWP-version;">
    libwww-perl-&LWP-version; (a.k.a. Bundle::LWP)</bridgehead>

    <indexterm zone="perl-modules perl-lwp">
      <primary sortas="a-libwww-perl">libwww-perl</primary>
    </indexterm>

    <para>The libwww-perl (Bundle::LWP) collection is a set of
    <application>Perl</application> modules which provide a simple and
    consistent application programming interface to the World-Wide Web. The
    main focus of the library is to provide classes and functions that allow
    you to write WWW clients. The library also contains modules that are of
    more general use and even classes that help you implement simple HTTP
    servers. The LWP collection and all its dependency modules use the standard
    <xref linkend="perl-standard-install"/>. The dependencies should be
    installed in the order listed below. Ensure you install the dependency
    chain for each module before installing the modules.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="https://cpan.metacpan.org/authors/id/E/ET/ETHER/libwww-perl-&LWP-version;.tar.gz">libwww-perl-&LWP-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>https://cpan.metacpan.org/authors/id/E/ET/ETHER/libwww-perl-&LWP-version;.tar.gz
MD5 sum: 85b36bcd2fd2450718ee14f894f0d3d1</literallayout>
        <itemizedlist>
          <listitem> <literallayout><ulink url="http://search.cpan.org/~gaas/Encode-Locale/">Encode::Locale</ulink>
(http://search.cpan.org/~gaas/Encode-Locale/) </literallayout>
          </listitem>
          <listitem> <literallayout><ulink url="http://search.cpan.org/~gaas/HTML-Form/">HTML::Form</ulink>
(http://search.cpan.org/~gaas/HTML-Form/) </literallayout>
            <itemizedlist>
              <listitem>
                <para>
                  <xref linkend="perl-uri"/>
                </para>
              </listitem>
              <listitem>
                <para>
                  <xref linkend="perl-html-parser"/>
                </para>
              </listitem>
              <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/HTTP-Message/">HTTP::Message</ulink>
(http://search.cpan.org/~gaas/HTTP-Message/)</literallayout>
                <itemizedlist><listitem><literallayout><ulink url="http://search.cpan.org/~gaas/HTTP-Date/">HTTP::Date</ulink>
(http://search.cpan.org/~gaas/HTTP-Date/)</literallayout>
                  </listitem>
                  <listitem><literallayout> <ulink url="http://search.cpan.org/~cjm/IO-HTML/">IO::HTML</ulink>
(http://search.cpan.org/~cjm/IO-HTML/)</literallayout>
                  </listitem>
                  <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/LWP-MediaTypes/">LWP::MediaTypes</ulink>
(http://search.cpan.org/~gaas/LWP-MediaTypes/)</literallayout>
                  </listitem>
                </itemizedlist>
              </listitem>
            </itemizedlist>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/HTTP-Cookies/">HTTP::Cookies</ulink>
(http://search.cpan.org/~gaas/HTTP-Cookies/)</literallayout>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/HTTP-Negotiate/">HTTP::Negotiate</ulink>
(http://search.cpan.org/~gaas/HTTP-Negotiate/)</literallayout>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/Net-HTTP/">Net::HTTP</ulink>
(http://search.cpan.org/~gaas/Net-HTTP/)</literallayout>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/WWW-RobotRules/">WWW::RobotRules</ulink>
(http://search.cpan.org/~gaas/WWW-RobotRules/)</literallayout>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/HTTP-Daemon/">HTTP::Daemon</ulink>
(http://search.cpan.org/~gaas/HTTP-Daemon/)</literallayout>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/File-Listing/">File::Listing</ulink>
(http://search.cpan.org/~gaas/File-Listing/)</literallayout>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <para>After the LWP installation, if you want HTTPS protocol support,
    install the following (application and modules):</para>

    <itemizedlist>
      <listitem>
        <para>
          <xref linkend="openssl"/>
        </para>
      </listitem>
      <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/LWP-Protocol-https/">LWP::Protocol::https</ulink>
(http://search.cpan.org/~gaas/LWP-Protocol-https/)</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/~behroozi/IO-Socket-SSL/">IO::Socket::SSL</ulink>
(http://search.cpan.org/~behroozi/IO-Socket-SSL/)</literallayout>
            <itemizedlist>
              <listitem><literallayout><ulink url="http://search.cpan.org/dist/Net-SSLeay/">Net::SSLeay</ulink>
(http://search.cpan.org/dist/Net-SSLeay/)</literallayout>
              </listitem>
            </itemizedlist>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~abh/Mozilla-CA/">Mozilla::CA</ulink>
(http://search.cpan.org/~abh/Mozilla-CA/)</literallayout>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- List::AllUtils -->
    <bridgehead renderas="sect3" id="perl-list-allutils"
    xreflabel="List::AllUtils-&List-AllUtils-version;">
    List::AllUtils-&List-AllUtils-version;</bridgehead>

    <indexterm zone="perl-modules perl-list-allutils">
      <primary sortas="a-List-AllUtils">List::AllUtils</primary>
    </indexterm>

    <para>The List::Allutils module combines List::Util and List::MoreUtils in
    one bite-sized package. This module and its dependencies use the standard
    <xref linkend="perl-standard-install"/>.</para>

    <para>This package will fail (tests, but not for any obvious reason, and at
    runtime) if the core module List::Util is older than 1.31, as happens with
    e.g. with perl-5.18.2 from LFS-7.5. To test the version, you can run the
    following command</para>
    <!-- use para to avoid line break in the long path -->
    <para><command>strings /usr/lib/perl5/5.*/*/auto/List/Util/Util.so |
    grep v5 -A 1 | tail -n 1</command></para>
    <para>and if necessary install
    <ulink url="http://search.cpan.org/dist/Scalar-List-Utils/">Scalar::List::Utils</ulink>
    (http://search.cpan.org/dist/Scalar-List-Utils/) to get a newer version of
    that module without updating all of <application>perl</application>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/D/DR/DROLSKY/List-AllUtils-&List-AllUtils-version;.tar.gz">List::AllUtils-&List-AllUtils-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/D/DR/DROLSKY/List-AllUtils-&List-AllUtils-version;.tar.gz
MD5 sum: 3e2dfeeef80c4e1952443c6b7d48583c</literallayout>
        <itemizedlist>
          <listitem> <literallayout><ulink url="http://search.cpan.org/dist/Number-Compare/">Number::Compare</ulink>
(http://search.cpan.org/dist/Number::Compare/)</literallayout>
          </listitem>
          <listitem> <literallayout><ulink url="http://search.cpan.org/dist/Text-Glob/">Text::Glob</ulink>
(http://search.cpan.org/dist/Text::Glob/)</literallayout>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- Log::Log4perl -->
    <bridgehead renderas="sect3" id="perl-log-log4perl"
    xreflabel="Log::Log4perl-&Log-Log4perl-version;">
    Log-Log4perl-&Log-Log4perl-version; (a.k.a. Log::Log4perl)</bridgehead>

    <indexterm zone="perl-modules perl-log-log4perl">
      <primary sortas="a-Log-Log4perl">Log::Log4perl</primary>
    </indexterm>

    <para>Log-Log4perl provides a Log4j implementation for
    <application>perl</application>. This module uses the
    standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/M/MS/MSCHILLI/Log-Log4perl-&Log-Log4perl-version;.tar.gz">Log-Log4perl-&Log-Log4perl-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/M/MS/MSCHILLI/Log-Log4perl-&Log-Log4perl-version;.tar.gz
MD5 sum: d247d2327d7f32dca09cbeb51a953fc5</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Module::Info
    <bridgehead renderas="sect3" id="perl-module-info"
    xreflabel="Module::Info-&Module-Info-version;">
    Module::Info-&Module-Info-version;</bridgehead>

    <indexterm zone="perl-modules perl-module-info">
      <primary sortas="a-Module-Info">Module::Info</primary>
    </indexterm>

    <para>The Module::Info module is quite useful for tasks other than just
    support of other modules. It can be used from the command-line to tell you
    if a particular module is included in, or has been installed into your
    <application>Perl</application> installation. Additionally, Module::Info
    can tell you what version of a module is installed and what dependencies
    are required for it. You can even use Module::Info to gather dependencies
    of uninstalled modules. The Module::Info module and dependencies install
    using the standard <application>Perl</application> module
    <xref linkend="perl-standard-install"/>.</para>

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
          Module-Info-&Module-Info-version;</ulink>
        </para>
      </listitem>
    </itemizedlist>
    -->

    <!-- Module::Signature
    <bridgehead renderas="sect3" id="perl-module-signature"
    xreflabel="Module::Signature-&Module-Signature-version;">
    Module::Signature-&Module-Signature-version;</bridgehead>

    <indexterm zone="perl-modules perl-module-signature">
      <primary sortas="a-Module-Signature">Module::Signature</primary>
    </indexterm>

    <para>The Module::Signature module is used to check and create
    <filename>SIGNATURE</filename> files for CPAN distributions. After
    installing Module::Signature you can verify the content of a distribution
    tarball (if it includes a <filename>SIGNATURE</filename> file) by unpacking
    the tarball, changing into the newly created directory and issuing the
    command <command>cpansign -v</command>. It will check each file's
    integrity, as well as the signature's validity. Note that some of the
    dependencies appear to be circular, however, they are only run-time
    conflicts and you should be able to fully utilize them as long as
    everything is installed. Module::Signature and the dependency modules are
    installed using the standard <application>Perl</application>
    module <xref linkend="perl-standard-install"/>.</para>

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://cpan.org/authors/id/A/AU/AUDREYT/Module-Signature-&Module-Signature-version;.tar.gz">
          Module-Signature-&Module-Signature-version;</ulink>
        </para>
        <itemizedlist>
          <listitem>
            <para>
              <xref linkend="perl-text-diff"/>
            </para>
          </listitem>
          <listitem>
            <para>
              <ulink url="http://cpan.org/authors/id/S/SM/SMUELLER/PAR-Dist-&PAR-Dist-version;.tar.gz">
              PAR-Dist-&PAR-Dist-version;</ulink>
            </para>
            <itemizedlist>
              <listitem>
                <para>
                  <xref linkend="perl-archive-zip"/>
                </para>
              </listitem>
              <listitem>
                <para>
                  <xref linkend="perl-lwp"/>
                </para>
              </listitem>
              <listitem>
                <para>
                  <xref linkend="perl-module-signature"/>
                </para>
              </listitem>
            </itemizedlist>
          </listitem>
          <listitem>
            <para>
            <xref linkend="gnupg"/>
            </para>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>
    -->

    <!-- Net::DNS -->
    <bridgehead renderas="sect3" id="perl-net-dns"
    xreflabel="Net::DNS-&Net-DNS-version;">
    Net::DNS-&Net-DNS-version;</bridgehead>

    <indexterm zone="perl-modules perl-net-dns">
      <primary sortas="a-Net-DNS">Net::DNS</primary>
    </indexterm>

    <para>Net::DNS is a DNS resolver implemented in
    <application>Perl</application>. It can be used to perform nearly any type
    of DNS query from a <application>Perl</application> script. The Net::DNS
    module and all its dependencies are installed using the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/N/NL/NLNETLABS/Net-DNS-&Net-DNS-version;.tar.gz">Net::DNS-&Net-DNS-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/N/NL/NLNETLABS/Net-DNS-&Net-DNS-version;.tar.gz
MD5 sum: f1d48107ff6b366479ad035783486d7a</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/~gaas/Digest-HMAC/">Digest::HMAC</ulink>
(http://search.cpan.org/~gaas/Digest-HMAC/) (required by the testsuite)</literallayout>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~shlomif/IO-Socket-INET6-2.72/">IO::Socket::INET6</ulink>
(http://search.cpan.org/~shlomif/IO-Socket-INET6-2.72/) (required for IPv6 support)</literallayout>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~gbarr/IO/lib/IO/Socket/INET.pm">IO::Socket::INET</ulink>
(http://search.cpan.org/~gbarr/IO/lib/IO/Socket/INET.pm) (required for IPv6 support)</literallayout>
            <itemizedlist>
              <listitem><literallayout><ulink url="http://search.cpan.org/~umemoto/Socket6/">Socket6</ulink>
(http://search.cpan.org/~umemoto/Socket6/)</literallayout>
              </listitem>
            </itemizedlist>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- Readonly::XS -->
<!--    <bridgehead renderas="sect3" id="perl-readonly-xs"
    xreflabel="Readonly::XS-&Readonly-XS-version;">
    Readonly::XS-&Readonly-XS-version;</bridgehead>

    <indexterm zone="perl-modules perl-readonly-xs">
      <primary sortas="a-Readonly-XS">Readonly::XS</primary>
    </indexterm>

    <para>The Readonly::XS module is a companion module for Readonly.pm, to
    speed up read-only scalar variables. This module uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/R/RO/ROODE/Readonly-XS-&Readonly-XS-version;.tar.gz">Readonly::XS-&Readonly-XS-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/R/RO/ROODE/Readonly-XS-&Readonly-XS-version;.tar.gz
MD5 sum: df71f29abfcbd14c963f912d6d6ded6b</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/dist/Readonly/">Readonly</ulink>
(http://search.cpan.org/dist/Readonly/)
this uses the <xref linkend="perl-build-install"/></literallayout>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist> -->

    <!-- Regexp::Common -->
    <bridgehead renderas="sect3" id="perl-regexp-common"
    xreflabel="Regexp::Common-&Regexp-Common-version;">
    Regexp::Common-&Regexp-Common-version;</bridgehead>

    <indexterm zone="perl-modules perl-regexp-common">
      <primary sortas="a-Regexp-Common">Regexp::Common</primary>
    </indexterm>

    <para>Regexp::Common provides commonly requested regular expressions. This
    module uses the standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/A/AB/ABIGAIL/Regexp-Common-&Regexp-Common-version;.tar.gz">Regexp-Common-&Regexp-Common-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/A/AB/ABIGAIL/Regexp-Common-&Regexp-Common-version;.tar.gz
MD5 sum: 2b9c335312dcfd9980ff7acbad0e5905</literallayout>
      </listitem>
    </itemizedlist>

    <!-- SGMLSpm -->
    <bridgehead renderas="sect3" id="perl-sgmlspm"
    xreflabel="SGMLSpm-&SGMLSpm-version;">
    SGMLSpm-&SGMLSpm-version;</bridgehead>

    <indexterm zone="perl-modules perl-sgmlspm">
      <primary sortas="a-SGMLSpm">SGMLSpm</primary>
    </indexterm>

    <para>The SGMLSpm module is a <application>Perl</application> library
      used for parsing the output from James Clark's SGMLS and NSGMLS
      parsers. This modules uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <para> Before beginning the build, issue
      the following command to prevent an error:</para>

<screen><userinput>chmod -v 644 MYMETA.yml</userinput></screen>

    <para>
      After the package has been installed, run the following command
      as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>ln -sv sgmlspl.pl /usr/bin/sgmlspl</userinput></screen>

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://anduin.&lfs-domainname;/sources/BLFS/conglomeration/perl-modules/SGMLSpm-&SGMLSpm-version;.tar.gz">SGMLSpm-&SGMLSpm-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://anduin.&lfs-domainname;/sources/BLFS/conglomeration/perl-modules/SGMLSpm-&SGMLSpm-version;.tar.gz
MD5 sum: 746c74ae969992cedb1a2879b4168090</literallayout>
<!--http://search.cpan.org/CPAN/authors/id/R/RA/RAAB/SGMLSpm-&SGMLSpm-version;.tar.gz -->
      </listitem>
    </itemizedlist>

    <!-- Test-Command -->
    <bridgehead renderas="sect3" id="perl-test-command"
    xreflabel="Test::Command-&Test-Command-version;">
    Test-Command-&Test-Command-version; (Test::Command)</bridgehead>

    <indexterm zone="perl-modules perl-test-command">
      <primary sortas="a-Test-Command">Test::Command</primary>
    </indexterm>

    <para>
      This module tests the exit status, STDOUT, or STDERR, of an external
      command. This module uses the standard
      <xref linkend="perl-standard-install"/>.
    </para>

    &lfs77_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/D/DA/DANBOO/Test-Command-&Test-Command-version;.tar.gz">Test-Command-&Test-Command-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/D/DA/DANBOO/Test-Command-&Test-Command-version;.tar.gz
MD5 sum: 9ab83c4695961dbe92cd86efe08f0634</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Test::Differences -->
    <bridgehead renderas="sect3" id="perl-test-differences"
    xreflabel="Test::Differences-&Test-Differences-version;">
    Test::Differences-&Test-Differences-version;</bridgehead>

    <indexterm zone="perl-modules perl-test-differences">
      <primary sortas="a-Test-Differences">Test::Differences</primary>
    </indexterm>

    <para>Test::Differences - Test strings and data structures and show
    differences if not ok. This module and its dependency modules use the
    standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/D/DC/DCANTRELL/Test-Differences-&Test-Differences-version;.tar.gz">Test::Differences-&Test-Differences-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/D/DC/DCANTRELL/Test-Differences-&Test-Differences-version;.tar.gz
MD5 sum: 473cce4879642e29d41bdfafd89c821d</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/~ovid/Text-Diff/">Text::Diff (for the testsuite)</ulink>
(http://search.cpan.org/~ovid/Text-Diff/)</literallayout>
            <itemizedlist>
              <listitem><literallayout><ulink url="http://search.cpan.org/~tyemq/Algorithm-Diff/">Algorithm::Diff (for the testsuite)</ulink>
(http://search.cpan.org/~tyemq/Algorithm-Diff/)</literallayout>
              </listitem>
            </itemizedlist>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- Test::Pod -->
    <bridgehead renderas="sect3" id="perl-test-pod"
    xreflabel="Test::Pod-&Test-Pod-version;">
    Test::Pod-&Test-Pod-version;</bridgehead>

    <indexterm zone="perl-modules perl-test-pod">
      <primary sortas="a-Test-Pod">Test::Pod</primary>
    </indexterm>

    <para>
      Test::Pod checks for POD errors in files. It uses the standard
      <xref linkend="perl-standard-install"/>.
    </para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/D/DW/DWHEELER/Test-Pod-&Test-Pod-version;.tar.gz">Test-Pod-&Test-Pod-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/D/DW/DWHEELER/Test-Pod-&Test-Pod-version;.tar.gz
MD5 sum: c6bfd00ccdcb417d68fb3c0a0ec884c8</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Test::Pod::Coverage -->
    <bridgehead renderas="sect3" id="perl-test-pod-coverage"
    xreflabel="Test::Pod::Coverage-&Test-Pod-Coverage-version;">
    Test::Pod::Coverage-&Test-Pod-Coverage-version;</bridgehead>

    <indexterm zone="perl-modules perl-test-pod-coverage">
      <primary sortas="a-Test-Pod-Coverage">Test::Pod::Coverage</primary>
    </indexterm>

    <para>Test::Pod::Coverage check for pod coverage. This module and its
    dependency modules use the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/N/NE/NEILB/Test-Pod-Coverage-&Test-Pod-Coverage-version;.tar.gz">Test::Pod::Coverage-&Test-Pod-Coverage-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/N/NE/NEILB/Test-Pod-Coverage-&Test-Pod-Coverage-version;.tar.gz
MD5 sum: c9ea5f4182415b13d2db18484a38c01b</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/~rclamp/Pod-Coverage/">Pod::Coverage (for the testsuite)</ulink>
(http://search.cpan.org/~rclamp/Pod-Coverage/)</literallayout>
            <itemizedlist>
              <listitem><literallayout><ulink url="http://search.cpan.org/~andk/Devel-Symdump/">Devel::Symdump (for the testsuite)</ulink>
(http://search.cpan.org/~andk/Devel-Symdump/)</literallayout>
              </listitem>
            </itemizedlist>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- Text::BibTeX -->
    <bridgehead renderas="sect3" id="perl-text-bibtex"
    xreflabel="Text::BibTeX-&Text-BibTeX-version;">
    Text::BibTeX-&Text-BibTeX-version;</bridgehead>

    <indexterm zone="perl-modules perl-text-bibtex">
      <primary sortas="a-Text-BibTeX">Text::BibTex</primary>
    </indexterm>

    <para>Text::BibTeX provides an interface to read and parse
    <application>BibTeX</application> files. This module uses the
    <xref linkend="perl-build-install"/>, but except where noted,
    its dependencies are installed using the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/A/AM/AMBS/Text-BibTeX-&Text-BibTeX-version;.tar.gz">Text-BibTeX-&Text-BibTeX-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/A/AM/AMBS/Text-BibTeX-&Text-BibTeX-version;.tar.gz
MD5 sum: 2dfdccab7c747d1805df432f4935ce66</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/dist/Config-AutoConf/">Config::AutoConf</ulink>
(http://search.cpan.org/dist/Config-AutoConf/)</literallayout>
            <itemizedlist>
              <listitem><literallayout><ulink url="http://search.cpan.org/dist/Capture-Tiny/">Capture=Tiny</ulink>
(http://search.cpan.org/dist/Capture-Tiny/)</literallayout>
              </listitem>
              <listitem><literallayout><ulink url="http://search.cpan.org/dist/ExtUtils-LibBuilder/">ExtUtils-LibBuilder</ulink>
(http://search.cpan.org/dist/LibBuilder/)
this uses the <xref linkend="perl-build-install"/></literallayout>
              </listitem>
            </itemizedlist>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>


    <!-- Text::Diff
    <bridgehead renderas="sect3" id="perl-text-diff"
    xreflabel="Text::Diff-&Text-Diff-version;">
    Text::Diff-&Text-Diff-version;</bridgehead>

    <indexterm zone="perl-modules perl-text-diff">
      <primary sortas="a-Text-Diff">Text::Diff</primary>
    </indexterm>

    <para>Text::Diff is used to perform diffs on files and record sets. It
    provides a basic set of services akin to the GNU <command>diff</command>
    utility. It is not anywhere near as feature complete as GNU
    <command>diff</command>, but it is better integrated with
    <application>Perl</application> and available on all platforms. Text::Diff
    is often faster than shelling out to a system's <command>diff</command>
    executable for small files, and generally slower on larger files. The
    modules listed below are installed using the standard
    <application>Perl</application> module
    <xref linkend="perl-standard-install"/>.</para>

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
          Text-Diff-&Text-Diff-version;</ulink></para>
        <itemizedlist>
          <listitem>
            <para>
              <ulink url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.tar.gz">
              Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>
    -->

    <!-- Text::Roman -->
    <bridgehead renderas="sect3" id="perl-text-roman"
    xreflabel="Text::Roman-&Text-Roman-version;">
    Text::Roman-&Text-Roman-version;</bridgehead>

    <indexterm zone="perl-modules perl-text-roman">
      <primary sortas="a-Text-Roman">Text::Roman</primary>
    </indexterm>

    <para>
      Text::Roman allows conversion between Roman and Arabic algorisms (number
      systems, e.g. MCMXLV and 1945). This module uses the standard
      <xref linkend="perl-standard-install"/>.
    </para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/S/SY/SYP/Text-Roman-&Text-Roman-version;.tar.gz">Text-Roman-&Text-Roman-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/S/SY/SYP/Text-Roman-&Text-Roman-version;.tar.gz
MD5 sum: 1f6b09c0cc1f4425b565ff787a39fd83</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Tk
    <bridgehead renderas="sect3" id="tk-perl"
    xreflabel="Tk-Perl-&Tk-Perl-version;">
    Tk-&Tk-Perl-version;</bridgehead>

    <indexterm zone="perl-modules tk-perl">
      <primary sortas="a-Tk">Tk</primary>
    </indexterm>

    <para>The <application>Tk</application> module is a
    <application>Perl</application> interface to the
    <application>Tk</application> package. The goal of this release is Unicode
    support via <application>Perl</application>'s and
    core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
    builds and loads into a threaded <application>Perl</application> but is NOT
    yet thread safe. The module is installed using the standard
    <application>Perl</application> module
    <xref linkend="perl-standard-install"/>.</para>

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/S/SR/SREZIC/Tk-&Tk-Perl-version;.tar.gz">
          Tk-&Tk-Perl-version;</ulink></para>
        <itemizedlist>
          <listitem>
            <para>
              <xref linkend="tk"/> and <xref linkend="libjpeg"/>
            </para>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>
    -->

    <!-- Unicode::Collate -->
    <bridgehead renderas="sect3" id="perl-unicode-collate"
    xreflabel="Unicode::Collate-&Unicode-Collate-version;">
    Unicode::Collate-&Unicode-Collate-version;</bridgehead>

    <indexterm zone="perl-modules perl-unicode-collate">
      <primary sortas="a-Unicode-Collate">Unicode::Collate</primary>
    </indexterm>

    <para>Unicode::Collate  provides a Unicode collation algorithm. This module
    uses the standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://search.cpan.org/CPAN/authors/id/S/SA/SADAHIRO/Unicode-Collate-&Unicode-Collate-version;.tar.gz">Unicode-Collate-&Unicode-Collate-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://search.cpan.org/CPAN/authors/id/S/SA/SADAHIRO/Unicode-Collate-&Unicode-Collate-version;.tar.gz
MD5 sum: 9eb22e6d7745d4d29b6753c79cbe5014</literallayout>
      </listitem>
    </itemizedlist>

    <!-- Unicode::LineBreak -->
    <bridgehead renderas="sect3" id="perl-unicode-linebreak"
    xreflabel="Unicode::LineBreak-&Unicode-LineBreak-version;">
    Unicode::LineBreak-&Unicode-LineBreak-version;</bridgehead>

    <indexterm zone="perl-modules perl-unicode-linebreak">
      <primary sortas="a-Unicode-LineBreak">Unicode::LineBreak</primary>
    </indexterm>

    <para>Unicode::LineBreak provides a UAX #14 Unicode Line Breaking Algorithm.
    This module and its dependencies use the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/N/NE/NEZUMI/Unicode-LineBreak-&Unicode-LineBreak-version;.tar.gz">Unicode::LineBreak-&Unicode-LineBreak-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/N/NE/NEZUMI/Unicode-LineBreak-&Unicode-LineBreak-version;.tar.gz
MD5 sum: c908890e6a00f4203da5d4a5d6060586</literallayout>
        <itemizedlist>
          <listitem><literallayout><ulink url="http://search.cpan.org/dist/MIME-Charset/">MIME::Charset</ulink>
(http://search.cpan.org/dist/MIME-Charset/)</literallayout>
            <itemizedlist>
              <listitem><literallayout><ulink url="http://search.cpan.org/dist/Encode-JISX0213/">Encode-JISX0213</ulink>
(http://search.cpan.org/dist/Encode-JISX0213/)</literallayout>
                <itemizedlist>
                  <listitem><literallayout><ulink url="http://search.cpan.org/dist/Encode-ISO2022/">Encode-ISO2022</ulink>
(http://search.cpan.org/dist/Encode-ISO2022/)</literallayout>
                  </listitem>
                </itemizedlist>
              </listitem>
            </itemizedlist>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- URI -->
    <bridgehead renderas="sect3" id="perl-uri"
    xreflabel="URI-&URI-version;">
    URI-&URI-version;</bridgehead>

    <indexterm zone="perl-modules perl-uri">
      <primary sortas="a-URI">URI</primary>
    </indexterm>

    <para>
      This module implements the URI class. Objects of this class represent
      "Uniform Resource Identifier references" as specified in RFC 2396 (and
      updated by RFC 2732). A Uniform Resource Identifier is a compact string of
      characters that identifies an abstract or physical resource. A Uniform
      Resource Identifier can be further classified as either a Uniform Resource
      Locator (URL) or a Uniform Resource Name (URN). The distinction between
      URL and URN does not matter to the URI class interface. A "URI-reference"
      is a URI that may have additional information attached in the form of a
      fragment identifier. This module uses the standard
      <xref linkend="perl-standard-install"/>.
    </para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/E/ET/ETHER/URI-&URI-version;.tar.gz">URI-&URI-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/E/ET/ETHER/URI-&URI-version;.tar.gz
MD5 sum: d0ef53b6c63bcc02ba55f405c30741e3</literallayout>
      </listitem>
    </itemizedlist>

    <!-- XML::LibXML::Simple -->
    <bridgehead renderas="sect3" id="perl-xml-libxml-simple"
    xreflabel="XML::LibXML::Simple-&XML-LibXML-Simple-version;">
    XML::LibXML::Simple-&XML-LibXML-Simple-version;</bridgehead>

    <indexterm zone="perl-modules perl-xml-libxml-simple">
      <primary sortas="a-XML-LibXML-Simple">XML::LibXML::Simple</primary>
    </indexterm>

    <para>The XML::LibXML::Simple module is a rewrite of XML::Simple to use the
    XML::LibXML parser for XML structures,instead of the plain
    <application>Perl</application> or SAX parsers.
    This module and all dependency modules use the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://cpan.org/authors/id/M/MA/MARKOV/XML-LibXML-Simple-&XML-LibXML-Simple-version;.tar.gz">XML::LibXML::Simple-&XML-LibXML-Simple-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://cpan.org/authors/id/M/MA/MARKOV/XML-LibXML-Simple-&XML-LibXML-Simple-version;.tar.gz
MD5 sum: 862fd977c97c4ec777a235522e12229d</literallayout>
        <itemizedlist>
          <listitem>
            <para>
              <xref linkend="perl-xml-sax"/>
            </para>
          </listitem>
          <listitem>
            <para>
              <xref linkend="perl-xml-libxml"/>
            </para>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/dist/File-Slurp-Tiny/">File::Slurp::Tiny</ulink>
(http://search.cpan.org/dist/File-Slurp-Tiny/)</literallayout>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- XML::LibXSLT -->
    <bridgehead renderas="sect3" id="perl-xml-libxslt"
    xreflabel="XML::LibXSLT-&XML-LibXSLT-version;">
    XML::LibXSLT-&XML-LibXSLT-version;</bridgehead>

    <indexterm zone="perl-modules perl-xml-libxslt">
      <primary sortas="a-XML-LibXSLT">XML::LibXSLT</primary>
    </indexterm>

    <para>The XML::LibXSLT module provides an interface to
    <application>libxslt</application>. This module uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/S/SH/SHLOMIF/XML-LibXSLT-&XML-LibXSLT-version;.tar.gz">XML::LibXSLT-&XML-LibXSLT-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/S/SH/SHLOMIF/XML-LibXSLT-&XML-LibXSLT-version;.tar.gz
MD5 sum: a32045699c001d960d6f94891f9e853c</literallayout>
        <itemizedlist>
          <listitem>
            <para>
              <xref linkend="libxslt"/>
            </para>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- XML::Parser -->
<!--    <bridgehead renderas="sect3" id="perl-xml-parser"
    xreflabel="XML::Parser-&XML-Parser-version;">
    XML::Parser-&XML-Parser-version;</bridgehead>

    <indexterm zone="perl-modules perl-xml-parser">
      <primary sortas="a-XML-Parser">XML::Parser</primary>
    </indexterm>

    <para>The XML::Parser module is a <application>Perl</application> extension
    interface to James Clark's XML parser,
    <application>expat</application>. The module uses the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs7x5_checked;

    <itemizedlist>
      <listitem> <literallayout><ulink url="http://search.cpan.org/CPAN/authors/id/T/TO/TODDR/XML-Parser-&XML-Parser-version;.tar.gz">XML::Parser-&XML-Parser-version;</ulink>
http://search.cpan.org/CPAN/authors/id/T/TO/TODDR/XML-Parser-&XML-Parser-version;.tar.gz 
MD5 sum: c320d2ffa459e6cdc6f9f59c1185855e) </literallayout>
        <itemizedlist>
          <!-<listitem>
            <para>
              <xref linkend="expat"/>
            </para>
          </listitem> ->
          <listitem>
            <para>
              <xref linkend="perl-lwp"/> (optionally used in the test suite)
            </para>
          </listitem>
        </itemizedlist>

      </listitem>
    </itemizedlist>-->

    <!-- XML::Simple -->
    <bridgehead renderas="sect3" id="perl-xml-simple"
    xreflabel="XML::Simple-&XML-Simple-version;">
    XML::Simple-&XML-Simple-version;</bridgehead>

    <indexterm zone="perl-modules perl-xml-simple">
      <primary sortas="a-XML-Simple">XML::Simple</primary>
    </indexterm>

    <para>The XML::Simple module is a <application>Perl</application> extension
    that provides an easy API to read and write XML (especially config files).
    This module and all dependency modules use the standard
    <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://cpan.org/authors/id/G/GR/GRANTM/XML-Simple-&XML-Simple-version;.tar.gz">XML::Simple-&XML-Simple-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://cpan.org/authors/id/G/GR/GRANTM/XML-Simple-&XML-Simple-version;.tar.gz
MD5 sum: 4d10964e123b76eca36678464daa63cd</literallayout>
        <itemizedlist>
   <!--   <listitem> <literallayout><ulink url="http://search.cpan.org/~grantm/XML-SAX/">XML::SAX</ulink> -->
          <listitem><literallayout><ulink id="perl-xml-sax" xreflabel="XML::SAX" url="http://search.cpan.org/~grantm/XML-SAX/">XML::SAX</ulink>
(http://search.cpan.org/~grantm/XML-SAX/)
(Note: this package does not support parallel build)</literallayout>
            <itemizedlist>
              <listitem><literallayout><ulink url="http://search.cpan.org/~perigrin/XML-NamespaceSupport/">XML::NamespaceSupport</ulink>
(http://search.cpan.org/~perigrin/XML-NamespaceSupport/)</literallayout>
              </listitem>
              <listitem><literallayout><ulink url="http://search.cpan.org/~grantm/XML-SAX-Base/">XML::SAX::Base</ulink>
(http://search.cpan.org/~grantm/XML-SAX-Base/)</literallayout>
              </listitem>
            </itemizedlist>
          </listitem>
          <listitem> <literallayout><ulink url="http://search.cpan.org/~bjoern/XML-SAX-Expat/">XML::SAX::Expat</ulink>
(http://search.cpan.org/~bjoern/XML-SAX-Expat/)
(Note: this package does not support parallel build)</literallayout>
<!--            <itemizedlist>
              <listitem>
                <para>
                  <xref linkend="perl-xml-parser"/>
                </para>
              </listitem>
            </itemizedlist>-->
          </listitem>
          <listitem><literallayout> <ulink id="perl-xml-libxml" xreflabel="XML::LibXML" url="http://search.cpan.org/~shlomif/XML-LibXML/">XML::LibXML</ulink>
(http://search.cpan.org/~shlomif/XML-LibXML/)
(recommended for faster parsing)</literallayout>
          </listitem>
          <listitem><literallayout><ulink url="http://search.cpan.org/~chorny/Tie-IxHash/">Tie::IxHash</ulink>
(http://search.cpan.org/~chorny/Tie-IxHash/)
(optionally used in the test suite)</literallayout>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>

    <!-- XML::Writer -->
    <bridgehead renderas="sect3" id="perl-xml-writer"
    xreflabel="XML::Writer-&XML-Writer-version;">
    XML::Writer-&XML-Writer-version;</bridgehead>

    <indexterm zone="perl-modules perl-xml-writer">
      <primary sortas="a-XML-Writer">XML::Writer</primary>
    </indexterm>

    <para>XML::Writer provides a <application>Perl</application>
    extension for writing XML documents. This
    module uses the standard <xref linkend="perl-standard-install"/>.</para>

    &lfs77_checked; &gcc5_checked;

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://www.cpan.org/authors/id/J/JO/JOSEPHW/XML-Writer-&XML-Writer-version;.tar.gz">XML::Writer-&XML-Writer-version;</ulink>
        </para>
      </listitem>
      <listitem>
<literallayout>http://www.cpan.org/authors/id/J/JO/JOSEPHW/XML-Writer-&XML-Writer-version;.tar.gz
MD5 sum: b9c2420c243c6a36ce45a008740fcede</literallayout>
      </listitem>
    </itemizedlist>

    <!-- YAML
    <bridgehead renderas="sect3" id="perl-yaml"
    xreflabel="YAML-&YAML-version;">
    YAML-&YAML-version;</bridgehead>

    <indexterm zone="perl-modules perl-yaml">
      <primary sortas="a-YAML">YAML</primary>
    </indexterm>

    <para>The <application>YAML</application> modules implement a
    <application>YAML</application> Loader and Dumper based on the
    <application>YAML</application> 1.0 specification
    <ulink url="http://www.yaml.org/spec/"/>.
    <application>YAML</application> is a generic data serialization language
    that is optimized for human readability. It can be used to express the data
    structures of most modern programming languages. The module and
    dependencies are installed using the standard
    <application>Perl</application> module
    <xref linkend="perl-standard-install"/>.</para>

    <note>
      <para>The <application>YAML</application>,
      <application>Test::Base</application> and
      <application>Spiffy</application> modules will install UTF-8
      encoded manual pages. To modify the manual pages so that non-UTF-8
      encoded pages are installed, issue the following commands (before
      any other build commands):</para>

<screen><literal>For <application>Spiffy</application>:     <command>sed -i 's,\xc3\xb6,o,' lib/Spiffy.pm</command>

For <application>Test::Base</application>: <command>sed -i 's,\xc3\xb6,o,' \
                  lib/Test/Base{,/Filter}.pm \
                  lib/Module/Install/TestBase.pm</command>

For <application>YAML</application>:       <command>sed -i 's,\xc3\xb6,o,' \
                  ysh \
                  lib{,/Test}/YAML.pm \
                  lib/YAML/{Types,Node,Error,Marshall,Tag,Base}.pm \
                  lib/YAML/{Loader,Dumper}{,/Base}.pm</command></literal></screen>

    </note>

    <itemizedlist>
      <listitem>
        <para>
          <ulink url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
          YAML-&YAML-version;</ulink></para>
        <itemizedlist>
          <listitem>
            <para>
              <ulink url="http://cpan.org/authors/id/I/IN/INGY/Test-Base-&Test-Base-version;.tar.gz">
              Test-Base-&Test-Base-version;</ulink>
              (optionally used during the tests)
           </para>
             <itemizedlist>
               <listitem>
                <para
                  <ulink url="http://cpan.org/authors/id/I/IN/INGY/Spiffy-&Spiffy-version;.tar.gz">
                  Spiffy-&Spiffy-version;</ulink></para>
               </listitem>
             </itemizedlist>
          </listitem>
          <listitem>
            <para>
              <xref linkend="perl-text-diff"/>
              (optionally used during the tests)
            </para>
          </listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>
    -->

  </sect2>

  <sect2 role="installation" id="perl-standard-install"
  xreflabel="build and installation instructions">
    <title>Standard Installation of Perl Modules</title>

    <para>Install <application>Perl</application> modules by running the
    following commands:</para>

<screen><userinput>perl Makefile.PL &amp;&amp;
make &amp;&amp;
make test</userinput></screen>

    <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>

  </sect2>

  <sect2 role="installation" id="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>

<!-- when Build is removed from the core perl distribution, perhaps in 5.22,
     Module::Build should be added to this page, and linked from here -->
<screen><userinput>perl Build.PL &amp;&amp;
./Build &amp;&amp;
./Build test</userinput></screen>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>./Build install</userinput></screen>

<!-- following not tested
    <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>./Build install UNINST=1</userinput></screen>
    </note> -->

  </sect2>

  <sect2 role="installation" id="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&gt;&nbsp;</prompt></emphasis>
    prompt with the command:</para>

<screen role="root"><userinput>install <replaceable>&lt;Module::Name&gt;</replaceable></userinput></screen>

    <para>For additional commands and help, issue '<command>help</command>'
    from the
    <emphasis role='underlined'><prompt>cpan&gt;&nbsp;</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>&lt;Module1::Name&gt; &lt;Module2::Name&gt;</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>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <para>
      Most of these modules only install into the perl directories, but a
      few will also install programs (mostly, perl scripts), or even a library,
      into <filename class="directory">/usr</filename>
    </para>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>

      <seglistitem>
        <seg> <!-- Use emphasis to highlihght the relevant module name.
                   Our setup actually uses italic to do this this. -->
          <emphasis>Archive::Zip:</emphasis> crc32
          <emphasis>File::Find::Rule:</emphasis> findrule
          <emphasis>libwww-perl:</emphasis> lwp-download, lwp-dump, lwp-mirror, lwp-request
          <emphasis>Log::Log4perl:</emphasis> l4p-tmpl
          <emphasis>Pod::Coverage:</emphasis> pod_cover
          <emphasis>Text::BibTeX:</emphasis> biblex, bibparse, dumpnames
        </seg>
        <seg>
          <emphasis>Text::BibTeX:</emphasis> libbtparse.so
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="crc32">
        <term><command>crc32</command></term>
        <listitem>
          <para>computes and prints to stdout the CRC-32 values of the
          given files.</para>
          <indexterm zone="perl-modules crc32">
            <primary sortas="b-crc32">crc32</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="findrule">
        <term><command>findrule</command></term>
        <listitem>
          <para>is a command line wrapper to File:Find:Rule.</para>
          <indexterm zone="perl-modules findrule">
            <primary sortas="b-findrule">findrule</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lwp-download">
        <term><command>lwp-download</command></term>
        <listitem>
          <para>is a script to fetch a large file from the web.</para>
          <indexterm zone="perl-modules lwp-download">
            <primary sortas="b-lwp-download">lwp-download</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lwp-dump">
        <term><command>lwp-dump</command></term>
        <listitem>
          <para>is used to see what headers and content is returned for a URL.</para>
          <indexterm zone="perl-modules lwp-dump">
            <primary sortas="b-lwp-dump">lwp-dump</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lwp-mirror">
        <term><command>lwp-mirror</command></term>
        <listitem>
          <para>is a simple mirror utility.</para>
          <indexterm zone="perl-modules lwp-mirror">
            <primary sortas="b-lwp-mirror">lwp-mirror</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lwp-request">
        <term><command>lwp-request</command></term>
        <listitem>
          <para>is a simple command line user agent.</para>
          <indexterm zone="perl-modules lwp-request">
            <primary sortas="b-lwp-request">lwp-request</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="l4p-templ">
        <term><command>l4p-templ</command></term>
        <listitem>
          <para>prints out the text of a template Log4perl configuration for
          starting a new Log4perl configuration file.</para>
          <indexterm zone="perl-modules l4p-templ">
            <primary sortas="b-l4p-templ">l4p-templ</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pod_cover">
        <term><command>pod_cover</command></term>
        <listitem>
          <para>is used to get a coverage analysis of the embedded documentation
          in a perl module.</para>
          <indexterm zone="perl-modules pod_cover">
            <primary sortas="b-pod_cover">pod_cover</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="biblex">
        <term><command>biblex</command></term>
        <listitem>
          <para>performs lexical analysis on a BibTeX file.</para>
          <indexterm zone="perl-modules biblex">
            <primary sortas="b-biblex">biblex</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="bibparse">
        <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="perl-modules bibparse">
            <primary sortas="b-bibparse">bibparse</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="dumpnames">
        <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="perl-modules dumpnames">
            <primary sortas="b-dumpnames">dumpnames</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libbtparse">
        <term><filename class='libraryfile'>libbtparse.so</filename></term>
        <listitem>
          <para>is a library for parsing and processing BibTeX data files.</para>
          <indexterm zone="perl-modules libbtparse">
            <primary sortas="c-libbtparse">libbtparse.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>
  </sect2>

</sect1>