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>
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
