r5558 - trunk/BOOK/general/prog

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sun Jan 15 13:03:06 PST 2006


Author: randy
Date: 2006-01-15 14:03:05 -0700 (Sun, 15 Jan 2006)
New Revision: 5558

Modified:
   trunk/BOOK/general/prog/perl-modules.xml
Log:
Minor textual fixes and alphabetized the Perl Modules instructions (1 of 2)

Modified: trunk/BOOK/general/prog/perl-modules.xml
===================================================================
--- trunk/BOOK/general/prog/perl-modules.xml	2006-01-15 19:33:20 UTC (rev 5557)
+++ trunk/BOOK/general/prog/perl-modules.xml	2006-01-15 21:03:05 UTC (rev 5558)
@@ -28,10 +28,13 @@
     <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.
-    Most references to <application>Perl</application> modules are in the form
-    of Module, Module::SubName or Module::Sub::Name, however occasionally
-    you'll also see Module, Module-SubName or Module-Sub-Name. Most references
-    on this page are in the latter form, as these are the official package
+    Installation of the modules shown on this page should be accomplished by
+    installing the listed dependencies (from the bottom and working up to the
+    top) and then the desired module. Most references to
+    <application>Perl</application> modules are in the form of Module,
+    Module::SubName or Module::Sub::Name, though sometimes you'll see Module,
+    Module-SubName or Module-Sub-Name. The references on this page that reflect
+    an external URL are in the latter form, as these are the official package
     names.</para>
 
     <!-- This section commented out now because the new organization of files
@@ -48,7 +51,6 @@
         <ulink url="&perl_modules_md5sums_download_ftp;"/></para>
       </listitem>
     </itemizedlist>
-
     -->
 
     <!-- This is info for the Test::Builder::Tester module which may very well
@@ -69,77 +71,374 @@
     </indexterm>
     -->
 
-    <!-- Module::Info -->
-    <bridgehead renderas="sect3" id="perl-module-info"
-    xreflabel="Module::Info">The Module::Info Module</bridgehead>
+    <!-- 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-module-info">
-      <primary sortas="g-Module-Info">Module::Info</primary>
+    <indexterm zone="perl-modules perl-archive-zip">
+      <primary sortas="g-Archive-Zip">Archive::Zip</primary>
     </indexterm>
 
-    <para>One module in particular is shown first, as this module's usefulness
-    warrants installation, even though it won't be required by many other
-    modules. The Module::Info module can 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 versions are
-    installed and what dependencies are required for them. You can even use
-    Module::Info to gather dependencies of uninstalled modules.</para>
+    <para>The Archive::Zip module allows a <application>Perl</application>
+    program to create, manipulate, read, and write Zip archive files. The
+    two modules listed below can be installed using the
+    <application>Perl</application> module
+    <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
-        Module-Info-&Module-Info-version;</ulink>
+        url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
+        Archive-Zip-&Archive-Zip-version;</ulink></para>
+
+        <itemizedlist>
+          <listitem>
+            <para><xref linkend="perl-compress-zlib"/></para>
+          </listitem>
+        </itemizedlist>
+
+      </listitem>
+    </itemizedlist>
+
+    <!-- Compress::Zlib -->
+    <bridgehead renderas="sect3" id="perl-compress-zlib"
+    xreflabel="Compress::Zlib-&Compress-Zlib-version;">
+    Compress::Zlib-&Compress-Zlib-version;</bridgehead>
+
+    <indexterm zone="perl-modules perl-compress-zlib">
+      <primary sortas="g-Compress-Zlib">Compress::Zlib</primary>
+    </indexterm>
+
+    <para>The Compress::Zlib module provides a <application>Perl</application>
+    interface to the <application>Zlib</application> compression library. Most
+    of the functionality provided by <application>Zlib</application> is
+    available in Compress::Zlib. The module can be split into two general areas
+    of functionality, namely in-memory compression/decompression and read/write
+    access to gzip files.</para>
+
+    <note>
+      <para>The Compress::Zlib module requires the following
+      <command>sed</command> after untarring the distribution tarball (before
+      any other build commands) to use the system-installed copy of
+      <application>Zlib</application>.</para>
+
+<screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \
+       -e "s|INCLUDE    = ./zlib-src|INCLUDE    = /usr/include|" \
+       -e "s|LIB        = ./zlib-src|LIB        = /usr/lib|" \
+    config.in</userinput></screen>
+    </note>
+
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para><ulink
+        url="http://cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz">
+        Compress-Zlib-&Compress-Zlib-version;</ulink>
         (<xref linkend="perl-standard-install"/>)</para>
       </listitem>
     </itemizedlist>
 
-    <!-- Test::Pod -->
-    <bridgehead renderas="sect3" id="perl-test-pod"
-    xreflabel="Test::Pod">The Test::Pod Module</bridgehead>
+    <!-- Date::Manip -->
+    <bridgehead renderas="sect3" id="perl-date-manip"
+    xreflabel="Date::Manip-&DateManip-version;">
+    Date::Manip-&DateManip-version;</bridgehead>
 
-    <indexterm zone="perl-modules perl-test-pod">
-      <primary sortas="g-Test-Pod">Test::Pod</primary>
+    <indexterm zone="perl-modules perl-date-manip">
+      <primary sortas="g-Date-Manip">Date::Manip</primary>
     </indexterm>
 
-    <para>Another useful module, and one which is (typically optionally) used
-    by other modules during the build process is the Test:Pod module. This
-    module is used to check the validity of POD (Plain Old Documentation)
-    files. The Test::Pod module is typically included by module authors to
-    automatically find and check all POD files in a module distribution. This
-    module and all the dependencies can be installed using the
+    <para>Date::Manip is a set of routines designed to make any common
+    date/time manipulation easy to do. Operations such as comparing two times,
+    calculating a time a given amount of time from another, or parsing
+    international times are all easily done. From the very beginning, the
+    main focus of Date::Manip has been to be able to do ANY desired date/time
+    operation easily.</para>
+
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para><ulink
+        url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
+        DateManip-&DateManip-version;</ulink>
+        (<xref linkend="perl-standard-install"/>)</para>
+      </listitem>
+    </itemizedlist>
+
+    <!-- Finance::Quote -->
+    <bridgehead renderas="sect3" id="perl-finance-quote"
+    xreflabel="Finance::Quote-&Finance-Quote-version;">
+    Finance::Quote-&Finance-Quote-version;</bridgehead>
+
+    <indexterm zone="perl-modules perl-finance-quote">
+      <primary sortas="g-Finance-Quote">Finance::Quote</primary>
+    </indexterm>
+
+    <para>Finance::Quote is used to get stock quotes from various Internet
+    sources, including Yahoo! Finance, Fidelity Investments, and the Australian
+    Stock Exchange. There are two methods of using this module – a
+    functional interface that is depreciated, and an object-orientated method
+    that provides greater flexibility and stability. With the exception of
+    straight currency exchange rates, all information is returned as a
+    two-dimensional hash (or a reference to such a hash, if called in a scalar
+    context).</para>
+
+    <para>After you've installed the package, issue
+    <command>perldoc Finance::Quote</command> for full information.
+    Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
+    after unpacking the distribution tarball and changing into the top-level
+    directory. The module and dependencies can be installed using the
+    <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
+    <note>
+      <para>To run the regression test suite, you'll need to create a
+      symbolic link to the <filename class='directory'>test</filename>
+      directory using the following command after unpacking the tarball
+      and changing into the root directory of the sources:</para>
+
+<screen><userinput>ln -s test t</userinput></screen>
+
+      <para>Some tests will fail depending on certain conditions. See the
+      <filename>INSTALL</filename> file for full details.</para>
+    </note>
+
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
-        Test-Pod-&Test-Pod-version;</ulink></para>
+        url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
+        Finance-Quote-&Finance-Quote-version;</ulink></para>
 
         <itemizedlist>
           <listitem>
-            <para id="perl-pod-simple"><ulink
-            url="http://cpan.org/authors/id/A/AR/ARANDAL/Pod-Simple-&Pod-Simple-version;.tar.gz">
-            Pod-Simple-&Pod-Simple-version;</ulink></para>
-            <indexterm zone="perl-modules perl-pod-simple">
-              <primary sortas="g-Pod-Simple">Pod::Simple</primary>
+            <para><xref linkend="perl-html-tableextract"/></para>
+          </listitem>
+          <listitem>
+            <para><xref linkend="perl-lwp"/></para>
+          </listitem>
+        </itemizedlist>
+
+      </listitem>
+    </itemizedlist>
+
+    <!-- Finance::QuoteHist -->
+    <bridgehead renderas="sect3" id="perl-finance-quotehist"
+    xreflabel="Finance::QuoteHist-&Finance-QuoteHist-version;">
+    Finance::QuoteHist-&Finance-QuoteHist-version;</bridgehead>
+
+    <indexterm zone="perl-modules perl-finance-quotehist">
+      <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
+    </indexterm>
+
+    <para>The Finance::QuoteHist bundle is several modules designed to fetch
+    historical stock quotes from the web. The module and dependencies can be
+    installed using the <application>Perl</application> module
+    <xref linkend="perl-standard-install"/>.</para>
+
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para><ulink
+        url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
+        Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
+
+        <itemizedlist>
+          <listitem>
+            <para><xref linkend="perl-html-tableextract"/></para>
+          </listitem>
+          <listitem>
+            <para><xref linkend="perl-lwp"/></para>
+          </listitem>
+          <listitem>
+            <para><xref linkend="perl-date-manip"/></para>
+          </listitem>
+          <listitem>
+            <para id="perl-text-csv_xs"><ulink
+            url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
+            Text-CSV_XS-&Text-CSV_XS-version;</ulink></para>
+            <indexterm zone="perl-modules perl-text-csv_xs">
+              <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
             </indexterm>
+          </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="g-HTML-Parser">HTML::Parser</primary>
+    </indexterm>
+
+    <para>The HTML::Parser distribution is a collection of modules that parse
+    and extract information from HTML documents. In order to use the included
+    HTML::HeadParser module, you will also need to install
+    <xref linkend="perl-lwp"/>. The two modules listed below can be installed
+    using the <application>Perl</application> Module
+    <xref linkend="perl-standard-install"/>.</para>
+
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para><ulink
+        url="http://cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
+        HTML-Parser-&HTML-Parser-version;</ulink></para>
+
+        <itemizedlist>
+          <listitem>
+            <para id="perl-html-tagset"><ulink
+            url="http://cpan.org/authors/id/P/PE/PETDANCE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
+            HTML-Tagset-&HTML-Tagset-version;</ulink></para>
+            <indexterm zone="perl-modules perl-html-tagset">
+              <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
+            </indexterm>
+          </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="g-HTML-TableExtract">HTML::TableExtract</primary>
+    </indexterm>
+
+    <para></para>
+
+    <itemizedlist spacing='compact'>
+      <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></para>
+
+        <itemizedlist>
+          <listitem>
+            <para><xref linkend="perl-html-parser"/></para>
+          </listitem>
+        </itemizedlist>
+
+      </listitem>
+    </itemizedlist> 
+
+    <!-- LWP -->
+    <bridgehead renderas="sect3" id="perl-lwp"
+    xreflabel="LWP-&LWP-version;">
+    LWP-&LWP-version;</bridgehead>
+
+    <indexterm zone="perl-modules perl-lwp">
+      <primary sortas="g-LWP">LWP</primary>
+    </indexterm>
+
+    <para>The libwww-perl (LWP) collection is a set of
+    <application>Perl</application> modules which provides 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 modules and all its <application>Perl</application>
+    module dependencies can be installed using the
+    <application>Perl</application> Module
+    <xref linkend="perl-standard-install"/>.</para>
+
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para><ulink
+        url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
+        LWP-&LWP-version;</ulink></para>
+
+        <itemizedlist>
+          <listitem>
+            <para id="perl-uri"><ulink
+            url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
+            URI-&URI-version;</ulink></para>
+            <indexterm zone="perl-modules perl-uri">
+              <primary sortas="g-URI">URI</primary>
+            </indexterm>
+
             <itemizedlist>
               <listitem>
-                <para id="perl-pod-escapes"><ulink
-                url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
-                Pod-Escapes-&Pod-Escapes-version;</ulink></para>
-                <indexterm zone="perl-modules perl-pod-escapes">
-                  <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
+                <para id="perl-business-isbn"><ulink
+                url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
+                Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
+                used during the test suite)</para>
+                <indexterm zone="perl-modules perl-business-isbn">
+                  <primary sortas="g-Business-ISBN">Business::ISBN</primary>
                 </indexterm>
+
+                <itemizedlist>
+                  <listitem>
+                    <para id="perl-business-isbn-data"><ulink
+                    url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
+                    Business-ISBN-Data-&Business-ISBN-Data-version;</ulink></para>
+                    <indexterm zone="perl-modules perl-business-isbn-data">
+                      <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
+                    </indexterm>
+
+                    <itemizedlist>
+                      <listitem>
+                        <para><xref linkend="perl-test-pod"/></para>
+                      </listitem>
+                      <listitem>
+                        <para id="perl-test-prereq"><ulink
+                        url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
+                        Test-Prereq-&Test-Prereq-version;</ulink></para>
+                        <indexterm zone="perl-modules perl-test-prereq">
+                          <primary sortas="g-Test-Prereq">Test::Prereq</primary>
+                        </indexterm>
+
+                        <itemizedlist>
+                          <listitem>
+                            <para><xref linkend="perl-module-info"/></para>
+                          </listitem>
+                          <listitem>
+                            <para><xref linkend="perl-module-build"/> (optional)</para>
+                          </listitem>
+                          <listitem>
+                            <para id="perl-module-corelist"><ulink
+                            url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
+                            Module-CoreList-&Module-Corelist-version;</ulink></para>
+                            <indexterm zone="perl-modules perl-module-corelist">
+                              <primary sortas="g-Module-Corelist">Module::Corelist</primary>
+                            </indexterm>
+                          </listitem>
+                        </itemizedlist>
+
+                      </listitem>
+                    </itemizedlist>
+
+                  </listitem>
+                </itemizedlist>
+
               </listitem>
             </itemizedlist>
 
           </listitem>
           <listitem>
-            <para><xref linkend="perl-test-simple"/></para>
+            <para><xref linkend="perl-html-parser"/></para>
           </listitem>
+          <listitem>
+            <para><xref linkend="perl-compress-zlib"/></para>
+          </listitem>
+          <listitem>
+            <para id="perl-crypt-ssleay"><ulink
+            url="http://cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
+            Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
+            support)</para>
+            <indexterm zone="perl-modules perl-crypt-ssleay">
+              <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
+            </indexterm>
+
+            <itemizedlist>
+              <listitem>
+                <para><xref linkend="openssl"/></para>
+              </listitem>
+            </itemizedlist>
+
+          </listitem>
         </itemizedlist>
 
       </listitem>
@@ -147,7 +446,8 @@
 
     <!-- Module::Build -->
     <bridgehead renderas="sect3" id="perl-module-build"
-    xreflabel="Module::Build">The Module::Build Module</bridgehead>
+    xreflabel="Module::Build-&Module-Build-version;">
+    Module::Build-&Module-Build-version;</bridgehead>
 
     <indexterm zone="perl-modules perl-module-build">
       <primary sortas="g-Module-Build">Module::Build</primary>
@@ -307,236 +607,36 @@
 
 <screen role='root'><userinput>./Build install</userinput></screen>
 
-    <!-- Compress::Zlib -->
-    <bridgehead renderas="sect3" id="perl-compress-zlib"
-    xreflabel="Compress::Zlib">The Compress::Zlib Module</bridgehead>
+    <!-- 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-compress-zlib">
-      <primary sortas="g-Compress-Zlib">Compress::Zlib</primary>
+    <indexterm zone="perl-modules perl-module-info">
+      <primary sortas="g-Module-Info">Module::Info</primary>
     </indexterm>
 
-    <para>The Compress::Zlib module provides a <application>Perl</application>
-    interface to the <application>Zlib</application> compression library. Most
-    of the functionality provided by <application>Zlib</application> is
-    available in Compress::Zlib. The module can be split into two general areas
-    of functionality, namely in-memory compression/decompression and read/write
-    access to gzip files.</para>
+    <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.</para>
 
-    <note>
-      <para>The Compress::Zlib module requires the following
-      <command>sed</command> after untarring the distribution tarball (before
-      any other build commands) to use the system-installed copy of
-      <application>Zlib</application>.</para>
-
-<screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \
-       -e "s|INCLUDE    = ./zlib-src|INCLUDE    = /usr/include|" \
-       -e "s|LIB        = ./zlib-src|LIB        = /usr/lib|" \
-    config.in</userinput></screen>
-    </note>
-
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz">
-        Compress-Zlib-&Compress-Zlib-version;</ulink>
+        url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
+        Module-Info-&Module-Info-version;</ulink>
         (<xref linkend="perl-standard-install"/>)</para>
       </listitem>
     </itemizedlist>
 
-    <!-- HTML::Parser -->
-    <bridgehead renderas="sect3" id="perl-html-parser"
-    xreflabel="HTML::Parser">The HTML::Parser Module</bridgehead>
-
-    <indexterm zone="perl-modules perl-html-parser">
-      <primary sortas="g-HTML-Parser">HTML::Parser</primary>
-    </indexterm>
-
-    <para>The HTML::Parser distribution is a collection of modules that parse
-    and extract information from HTML documents. In order to use the included
-    HTML::HeadParser module, you will also need to install
-    <xref linkend="perl-lwp"/>. The two modules listed below can be installed
-    using the <application>Perl</application> Module
-    <xref linkend="perl-standard-install"/>.</para>
-
-    <itemizedlist spacing='compact'>
-      <listitem>
-        <para><ulink
-        url="http://cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
-        HTML-Parser-&HTML-Parser-version;</ulink></para>
-
-        <itemizedlist>
-          <listitem>
-            <para id="perl-html-tagset"><ulink
-            url="http://cpan.org/authors/id/P/PE/PETDANCE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
-            HTML-Tagset-&HTML-Tagset-version;</ulink></para>
-            <indexterm zone="perl-modules perl-html-tagset">
-              <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
-            </indexterm>
-          </listitem>
-        </itemizedlist>
-
-      </listitem>
-    </itemizedlist>
-
-    <!-- HTML::TableExtract -->
-    <bridgehead renderas="sect3" id="perl-html-tableextract"
-    xreflabel="HTML::TableExtract">The HTML::TableExtract Module</bridgehead>
-
-    <indexterm zone="perl-modules perl-html-tableextract">
-      <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary>
-    </indexterm>
-
-    <para></para>
-
-    <itemizedlist spacing='compact'>
-      <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></para>
-
-        <itemizedlist>
-          <listitem>
-            <para><xref linkend="perl-html-parser"/></para>
-          </listitem>
-        </itemizedlist>
-
-      </listitem>
-    </itemizedlist> 
-
-    <!-- Test::Simple -->
-    <bridgehead renderas="sect3" id="perl-test-simple"
-    xreflabel="Test::Simple">The Test::Simple Module</bridgehead>
-
-    <indexterm zone="perl-modules perl-test-simple">
-      <primary sortas="g-Test-Simple">Test::Simple</primary>
-    </indexterm>
-
-    <para>The Test::Simple module contains utilities designed to assist
-    developers in creating tests. A version of Test::Simple was installed
-    during LFS with the <application>Perl</application>-&LFS-Perl-version;
-    installation, however, some of the sub-modules contained in Test::Simple
-    have been updated (notably, the Test::More module) and these updated
-    modules are now required by other modules. This updated version of
-    Test::Simple also now includes the Test:Builder:Tester module, required by
-    many of the modules on this page. Note that installing this updated
-    version of Test::Simple will overwrite some files from the original
-    <application>Perl</application> installation, but there's really nothing to
-    be alarmed about as these modules are only used by developers creating
-    tests, or for running the test suites during additional module
-    installations.</para>
-
-    <itemizedlist spacing='compact'>
-      <listitem>
-        <para><ulink
-        url="http://cpan.org/authors/id/M/MS/MSCHWERN/Test-Simple-&Test-Simple-version;.tar.gz">
-        Test-Simple-&Test-Simple-version;</ulink>
-        (<xref linkend="perl-standard-install"/>)</para>
-      </listitem>
-    </itemizedlist>
-
-    <!-- XML::Parser -->
-    <bridgehead renderas="sect3" id="perl-xml-parser"
-    xreflabel="XML::Parser">The XML::Parser Module</bridgehead>
-
-    <indexterm zone="perl-modules perl-xml-parser">
-      <primary sortas="g-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 can be installed using the
-    <application>Perl</application> Module
-    <xref linkend="perl-standard-install"/>.</para>
-
-    <itemizedlist spacing='compact'>
-      <listitem>
-        <para><ulink
-        url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
-        XML-Parser-&XML-Parser-version;</ulink></para>
-
-        <itemizedlist>
-          <listitem>
-            <para><xref linkend="expat"/></para>
-          </listitem>
-        </itemizedlist>
-
-      </listitem>
-    </itemizedlist>
-
-    <!-- SGMLSpm -->
-    <bridgehead renderas="sect3" id="perl-sgmlspm"
-    xreflabel="SGMLSpm">The SGMLSpm Module</bridgehead>
-
-    <indexterm zone="perl-modules perl-sgmlspm">
-      <primary sortas="g-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 module requires modified installation instructions, shown
-    below.</para>
-
-    <itemizedlist spacing='compact'>
-      <listitem>
-        <para><ulink
-        url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
-        SGMLSpm-&SGMLSpm-version;</ulink></para>
-      </listitem>
-    </itemizedlist>
-
-    <para>If your system's <application>Perl</application> version is different
-    than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
-    command below to reflect the version you have installed.</para>
-
-<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
-       -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
-       -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
-    Makefile</userinput></screen>
-
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
-
-<screen role="root"><userinput>make install &&
-install -v -d -m755 /usr/share/doc/perl5 &&
-make install_html &&
-rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &&
-install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
-
-    <!-- Tk -->
-    <bridgehead renderas="sect3" id="perl-tk"
-    xreflabel="Perl-Tk">The Tk Module</bridgehead>
-
-    <indexterm zone="perl-modules perl-tk">
-      <primary sortas="g-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-&Perl-Tk-version;
-    builds and loads into a threaded <application>Perl</application> but is NOT
-    yet thread safe. The module can be installed using the
-    <application>Perl</application> Module
-    <xref linkend="perl-standard-install"/>.</para>
-
-    <itemizedlist spacing='compact'>
-      <listitem>
-        <para><ulink
-        url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
-        Tk-&Perl-Tk-version;</ulink></para>
-
-        <itemizedlist>
-          <listitem>
-            <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
-          </listitem>
-        </itemizedlist>
-
-      </listitem>
-    </itemizedlist>
-
     <!-- Net::DNS -->
     <bridgehead renderas="sect3" id="perl-net-dns"
-    xreflabel="Net-DNS">The Net::DNS Module</bridgehead>
+    xreflabel="Net-DNS-&Net-DNS-version;">
+    Net::DNS-&Net-DNS-version;</bridgehead>
 
     <indexterm zone="perl-modules perl-net-dns">
       <primary sortas="g-Net-DNS">Net::DNS</primary>
@@ -619,269 +719,182 @@
       </listitem>
     </itemizedlist>
 
-    <!-- LWP -->
-    <bridgehead renderas="sect3" id="perl-lwp"
-    xreflabel="LWP">The LWP Module</bridgehead>
+    <!-- Test::Pod -->
+    <bridgehead renderas="sect3" id="perl-test-pod"
+    xreflabel="Test::Pod">The Test::Pod Module</bridgehead>
 
-    <indexterm zone="perl-modules perl-lwp">
-      <primary sortas="g-LWP">LWP</primary>
+    <indexterm zone="perl-modules perl-test-pod">
+      <primary sortas="g-Test-Pod">Test::Pod</primary>
     </indexterm>
 
-    <para>The libwww-perl (LWP) collection is a set of
-    <application>Perl</application> modules which provides 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 modules and all its <application>Perl</application>
-    module dependencies can be installed using the
-    <application>Perl</application> Module
+    <para>Another useful module, and one which is (typically optionally) used
+    by other modules during the build process is the Test:Pod module. This
+    module is used to check the validity of POD (Plain Old Documentation)
+    files. The Test::Pod module is typically included by module authors to
+    automatically find and check all POD files in a module distribution. This
+    module and all the dependencies can be installed using the
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
-        LWP-&LWP-version;</ulink></para>
+        url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
+        Test-Pod-&Test-Pod-version;</ulink></para>
 
         <itemizedlist>
           <listitem>
-            <para id="perl-uri"><ulink
-            url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
-            URI-&URI-version;</ulink></para>
-            <indexterm zone="perl-modules perl-uri">
-              <primary sortas="g-URI">URI</primary>
+            <para id="perl-pod-simple"><ulink
+            url="http://cpan.org/authors/id/A/AR/ARANDAL/Pod-Simple-&Pod-Simple-version;.tar.gz">
+            Pod-Simple-&Pod-Simple-version;</ulink></para>
+            <indexterm zone="perl-modules perl-pod-simple">
+              <primary sortas="g-Pod-Simple">Pod::Simple</primary>
             </indexterm>
 
             <itemizedlist>
               <listitem>
-                <para id="perl-business-isbn"><ulink
-                url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
-                Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
-                used during the test suite)</para>
-                <indexterm zone="perl-modules perl-business-isbn">
-                  <primary sortas="g-Business-ISBN">Business::ISBN</primary>
+                <para id="perl-pod-escapes"><ulink
+                url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
+                Pod-Escapes-&Pod-Escapes-version;</ulink></para>
+                <indexterm zone="perl-modules perl-pod-escapes">
+                  <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
                 </indexterm>
-
-                <itemizedlist>
-                  <listitem>
-                    <para id="perl-business-isbn-data"><ulink
-                    url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
-                    Business-ISBN-Data-&Business-ISBN-Data-version;</ulink></para>
-                    <indexterm zone="perl-modules perl-business-isbn-data">
-                      <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
-                    </indexterm>
-
-                    <itemizedlist>
-                      <listitem>
-                        <para><xref linkend="perl-test-pod"/></para>
-                      </listitem>
-                      <listitem>
-                        <para id="perl-test-prereq"><ulink
-                        url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
-                        Test-Prereq-&Test-Prereq-version;</ulink></para>
-                        <indexterm zone="perl-modules perl-test-prereq">
-                          <primary sortas="g-Test-Prereq">Test::Prereq</primary>
-                        </indexterm>
-
-                        <itemizedlist>
-                          <listitem>
-                            <para><xref linkend="perl-module-info"/></para>
-                          </listitem>
-                          <listitem>
-                            <para><xref linkend="perl-module-build"/> (optional)</para>
-                          </listitem>
-                          <listitem>
-                            <para id="perl-module-corelist"><ulink
-                            url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
-                            Module-CoreList-&Module-Corelist-version;</ulink></para>
-                            <indexterm zone="perl-modules perl-module-corelist">
-                              <primary sortas="g-Module-Corelist">Module::Corelist</primary>
-                            </indexterm>
-                          </listitem>
-                        </itemizedlist>
-
-                      </listitem>
-                    </itemizedlist>
-
-                  </listitem>
-                </itemizedlist>
-
               </listitem>
             </itemizedlist>
 
           </listitem>
           <listitem>
-            <para><xref linkend="perl-html-parser"/></para>
+            <para><xref linkend="perl-test-simple"/></para>
           </listitem>
-          <listitem>
-            <para><xref linkend="perl-compress-zlib"/></para>
-          </listitem>
-          <listitem>
-            <para id="perl-crypt-ssleay"><ulink
-            url="http://cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
-            Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
-            support)</para>
-            <indexterm zone="perl-modules perl-crypt-ssleay">
-              <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
-            </indexterm>
-
-            <itemizedlist>
-              <listitem>
-                <para><xref linkend="openssl"/></para>
-              </listitem>
-            </itemizedlist>
-
-          </listitem>
         </itemizedlist>
 
       </listitem>
     </itemizedlist>
 
-    <!-- Date::Manip -->
-    <bridgehead renderas="sect3" id="perl-date-manip"
-    xreflabel="Date::Manip">The Date::Manip Module</bridgehead>
+    <!-- Test::Simple -->
+    <bridgehead renderas="sect3" id="perl-test-simple"
+    xreflabel="Test::Simple">The Test::Simple Module</bridgehead>
 
-    <indexterm zone="perl-modules perl-date-manip">
-      <primary sortas="g-Date-Manip">Date::Manip</primary>
+    <indexterm zone="perl-modules perl-test-simple">
+      <primary sortas="g-Test-Simple">Test::Simple</primary>
     </indexterm>
 
-    <para>Date::Manip is a set of routines designed to make any common
-    date/time manipulation easy to do. Operations such as comparing two times,
-    calculating a time a given amount of time from another, or parsing
-    international times are all easily done. From the very beginning, the
-    main focus of Date::Manip has been to be able to do ANY desired date/time
-    operation easily.</para>
+    <para>The Test::Simple module contains utilities designed to assist
+    developers in creating tests. A version of Test::Simple was installed
+    during LFS with the <application>Perl</application>-&LFS-Perl-version;
+    installation, however, some of the sub-modules contained in Test::Simple
+    have been updated (notably, the Test::More module) and these updated
+    modules are now required by other modules. This updated version of
+    Test::Simple also now includes the Test:Builder:Tester module, required by
+    many of the modules on this page. Note that installing this updated
+    version of Test::Simple will overwrite some files from the original
+    <application>Perl</application> installation, but there's really nothing to
+    be alarmed about as these modules are only used by developers creating
+    tests, or for running the test suites during additional module
+    installations.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
-        DateManip-&DateManip-version;</ulink>
+        url="http://cpan.org/authors/id/M/MS/MSCHWERN/Test-Simple-&Test-Simple-version;.tar.gz">
+        Test-Simple-&Test-Simple-version;</ulink>
         (<xref linkend="perl-standard-install"/>)</para>
       </listitem>
     </itemizedlist>
 
-    <!-- Finance::Quote -->
-    <bridgehead renderas="sect3" id="perl-finance-quote"
-    xreflabel="Finance::Quote">The Finance::Quote Module</bridgehead>
+    <!-- XML::Parser -->
+    <bridgehead renderas="sect3" id="perl-xml-parser"
+    xreflabel="XML::Parser">The XML::Parser Module</bridgehead>
 
-    <indexterm zone="perl-modules perl-finance-quote">
-      <primary sortas="g-Finance-Quote">Finance::Quote</primary>
+    <indexterm zone="perl-modules perl-xml-parser">
+      <primary sortas="g-XML-Parser">XML::Parser</primary>
     </indexterm>
 
-    <para>Finance::Quote is used to get stock quotes from various Internet
-    sources, including Yahoo! Finance, Fidelity Investments, and the Australian
-    Stock Exchange. There are two methods of using this module – a
-    functional interface that is depreciated, and an object-orientated method
-    that provides greater flexibility and stability. With the exception of
-    straight currency exchange rates, all information is returned as a
-    two-dimensional hash (or a reference to such a hash, if called in a scalar
-    context).</para>
-
-    <para>After you've installed the package, issue
-    <command>perldoc Finance::Quote</command> for full information.
-    Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
-    after unpacking the distribution tarball and changing into the top-level
-    directory. The module and dependencies can be installed using the
-    <application>Perl</application> module
+    <para>The XML::Parser module is a <application>Perl</application> extension
+    interface to James Clark's XML parser,
+    <application>expat</application>. The module can be installed using the
+    <application>Perl</application> Module
     <xref linkend="perl-standard-install"/>.</para>
 
-    <note>
-      <para>To run the regression test suite, you'll need to create a
-      symbolic link to the <filename class='directory'>test</filename>
-      directory using the following command after unpacking the tarball
-      and changing into the root directory of the sources:</para>
-
-<screen><userinput>ln -s test t</userinput></screen>
-
-      <para>Some tests will fail depending on certain conditions. See the
-      <filename>INSTALL</filename> file for full details.</para>
-    </note>
-
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
-        Finance-Quote-&Finance-Quote-version;</ulink></para>
+        url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
+        XML-Parser-&XML-Parser-version;</ulink></para>
 
         <itemizedlist>
           <listitem>
-            <para><xref linkend="perl-html-tableextract"/></para>
+            <para><xref linkend="expat"/></para>
           </listitem>
-          <listitem>
-            <para><xref linkend="perl-lwp"/></para>
-          </listitem>
         </itemizedlist>
 
       </listitem>
     </itemizedlist>
 
-    <!-- Finance::QuoteHist -->
-    <bridgehead renderas="sect3" id="perl-finance-quotehist"
-    xreflabel="Finance::QuoteHist">The Finance::QuoteHist Module</bridgehead>
+    <!-- SGMLSpm -->
+    <bridgehead renderas="sect3" id="perl-sgmlspm"
+    xreflabel="SGMLSpm">The SGMLSpm Module</bridgehead>
 
-    <indexterm zone="perl-modules perl-finance-quotehist">
-      <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
+    <indexterm zone="perl-modules perl-sgmlspm">
+      <primary sortas="g-SGMLSpm">SGMLSpm</primary>
     </indexterm>
 
-    <para>The Finance::QuoteHist bundle is several modules designed to fetch
-    historical stock quotes from the web. The module and dependencies can be
-    installed using the <application>Perl</application> module
-    <xref linkend="perl-standard-install"/>.</para>
+    <para>The SGMLSpm module is a <application>Perl</application> library
+    used for parsing the output from James Clark's SGMLS and NSGMLS
+    parsers. This module requires modified installation instructions, shown
+    below.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
-        Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
-
-        <itemizedlist>
-          <listitem>
-            <para><xref linkend="perl-html-tableextract"/></para>
-          </listitem>
-          <listitem>
-            <para><xref linkend="perl-lwp"/></para>
-          </listitem>
-          <listitem>
-            <para><xref linkend="perl-date-manip"/></para>
-          </listitem>
-          <listitem>
-            <para id="perl-text-csv_xs"><ulink
-            url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
-            Text-CSV_XS-&Text-CSV_XS-version;</ulink></para>
-            <indexterm zone="perl-modules perl-text-csv_xs">
-              <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
-            </indexterm>
-          </listitem>
-        </itemizedlist>
-
+        url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
+        SGMLSpm-&SGMLSpm-version;</ulink></para>
       </listitem>
     </itemizedlist>
 
-    <!-- Archive::Zip -->
-    <bridgehead renderas="sect3" id="perl-archive-zip"
-    xreflabel="Archive::Zip">The Archive::Zip Module</bridgehead>
+    <para>If your system's <application>Perl</application> version is different
+    than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
+    command below to reflect the version you have installed.</para>
 
-    <indexterm zone="perl-modules perl-archive-zip">
-      <primary sortas="g-Archive-Zip">Archive::Zip</primary>
+<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
+       -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
+       -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
+    Makefile</userinput></screen>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &&
+install -v -d -m755 /usr/share/doc/perl5 &&
+make install_html &&
+rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &&
+install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
+
+    <!-- Tk -->
+    <bridgehead renderas="sect3" id="perl-tk"
+    xreflabel="Perl-Tk">The Tk Module</bridgehead>
+
+    <indexterm zone="perl-modules perl-tk">
+      <primary sortas="g-Tk">Tk</primary>
     </indexterm>
 
-    <para>The Archive::Zip module allows a <application>Perl</application>
-    program to create, manipulate, read, and write Zip archive files. The
-    two modules listed below can be installed using the
-    <application>Perl</application> module
+    <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-&Perl-Tk-version;
+    builds and loads into a threaded <application>Perl</application> but is NOT
+    yet thread safe. The module can be installed using the
+    <application>Perl</application> Module
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
-        Archive-Zip-&Archive-Zip-version;</ulink></para>
+        url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
+        Tk-&Perl-Tk-version;</ulink></para>
 
         <itemizedlist>
           <listitem>
-            <para><xref linkend="perl-compress-zlib"/></para>
+            <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
           </listitem>
         </itemizedlist>
 




More information about the blfs-book mailing list