Ignore:
Timestamp:
01/15/2006 09:03:05 PM (18 years ago)
Author:
Randy McMurchy <randy@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
d9afe96
Parents:
51f154b
Message:

Minor textual fixes and alphabetized the Perl Modules instructions (1 of 2)

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5558 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/prog/perl-modules.xml

    r51f154b r231e47d7  
    2929    objects to the <application>Perl</application> language. Modules utilized
    3030    by packages throughout BLFS are listed here, along with their dependencies.
    31     Most references to <application>Perl</application> modules are in the form
    32     of Module, Module::SubName or Module::Sub::Name, however occasionally
    33     you'll also see Module, Module-SubName or Module-Sub-Name. Most references
    34     on this page are in the latter form, as these are the official package
     31    Installation of the modules shown on this page should be accomplished by
     32    installing the listed dependencies (from the bottom and working up to the
     33    top) and then the desired module. Most references to
     34    <application>Perl</application> modules are in the form of Module,
     35    Module::SubName or Module::Sub::Name, though sometimes you'll see Module,
     36    Module-SubName or Module-Sub-Name. The references on this page that reflect
     37    an external URL are in the latter form, as these are the official package
    3538    names.</para>
    3639
    … …  
    4952      </listitem>
    5053    </itemizedlist>
    51 
    5254    -->
    5355
    … …  
    7072    -->
    7173
    72     <!-- Module::Info -->
    73     <bridgehead renderas="sect3" id="perl-module-info"
    74     xreflabel="Module::Info">The Module::Info Module</bridgehead>
    75 
    76     <indexterm zone="perl-modules perl-module-info">
    77       <primary sortas="g-Module-Info">Module::Info</primary>
    78     </indexterm>
    79 
    80     <para>One module in particular is shown first, as this module's usefulness
    81     warrants installation, even though it won't be required by many other
    82     modules. The Module::Info module can tell you if a particular module is
    83     included in, or has been installed into your <application>Perl</application>
    84     installation. Additionally, Module::Info can tell you what versions are
    85     installed and what dependencies are required for them. You can even use
    86     Module::Info to gather dependencies of uninstalled modules.</para>
    87 
    88     <itemizedlist spacing='compact'>
    89       <listitem>
    90         <para><ulink
    91         url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
    92         Module-Info-&Module-Info-version;</ulink>
    93         (<xref linkend="perl-standard-install"/>)</para>
    94       </listitem>
    95     </itemizedlist>
    96 
    97     <!-- Test::Pod -->
    98     <bridgehead renderas="sect3" id="perl-test-pod"
    99     xreflabel="Test::Pod">The Test::Pod Module</bridgehead>
    100 
    101     <indexterm zone="perl-modules perl-test-pod">
    102       <primary sortas="g-Test-Pod">Test::Pod</primary>
    103     </indexterm>
    104 
    105     <para>Another useful module, and one which is (typically optionally) used
    106     by other modules during the build process is the Test:Pod module. This
    107     module is used to check the validity of POD (Plain Old Documentation)
    108     files. The Test::Pod module is typically included by module authors to
    109     automatically find and check all POD files in a module distribution. This
    110     module and all the dependencies can be installed using the
     74    <!-- Archive::Zip -->
     75    <bridgehead renderas="sect3" id="perl-archive-zip"
     76    xreflabel="Archive::Zip-&Archive-Zip-version;">
     77    Archive::Zip-&Archive-Zip-version;</bridgehead>
     78
     79    <indexterm zone="perl-modules perl-archive-zip">
     80      <primary sortas="g-Archive-Zip">Archive::Zip</primary>
     81    </indexterm>
     82
     83    <para>The Archive::Zip module allows a <application>Perl</application>
     84    program to create, manipulate, read, and write Zip archive files. The
     85    two modules listed below can be installed using the
     86    <application>Perl</application> module
    11187    <xref linkend="perl-standard-install"/>.</para>
    11288
    … …  
    11490      <listitem>
    11591        <para><ulink
    116         url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
    117         Test-Pod-&Test-Pod-version;</ulink></para>
    118 
    119         <itemizedlist>
    120           <listitem>
    121             <para id="perl-pod-simple"><ulink
    122             url="http://cpan.org/authors/id/A/AR/ARANDAL/Pod-Simple-&Pod-Simple-version;.tar.gz">
    123             Pod-Simple-&Pod-Simple-version;</ulink></para>
    124             <indexterm zone="perl-modules perl-pod-simple">
    125               <primary sortas="g-Pod-Simple">Pod::Simple</primary>
    126             </indexterm>
    127 
    128             <itemizedlist>
    129               <listitem>
    130                 <para id="perl-pod-escapes"><ulink
    131                 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
    132                 Pod-Escapes-&Pod-Escapes-version;</ulink></para>
    133                 <indexterm zone="perl-modules perl-pod-escapes">
    134                   <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
    135                 </indexterm>
    136               </listitem>
    137             </itemizedlist>
    138 
    139           </listitem>
    140           <listitem>
    141             <para><xref linkend="perl-test-simple"/></para>
    142           </listitem>
    143         </itemizedlist>
    144 
    145       </listitem>
    146     </itemizedlist>
    147 
    148     <!-- Module::Build -->
    149     <bridgehead renderas="sect3" id="perl-module-build"
    150     xreflabel="Module::Build">The Module::Build Module</bridgehead>
    151 
    152     <indexterm zone="perl-modules perl-module-build">
    153       <primary sortas="g-Module-Build">Module::Build</primary>
    154     </indexterm>
    155 
    156     <para>The Module::Build module is a system for building, testing, and
    157     installing <application>Perl</application> modules. It is meant to be an
    158     alternative to ExtUtils::MakeMaker. Developers may alter the behavior of
    159     the module through subclassing in a much more straightforward way than with
    160     MakeMaker. It also does not require a <command>make</command> command on
    161     your system. Most of the Module::Build code is
    162     pure-<application>Perl</application> and written in a very cross-platform
    163     way.</para>
    164 
    165     <para>The Module::Build module (as well as any other
    166     <application>Perl</application> module that uses the Module::Build build
    167     system) uses <xref linkend="perl-module-build-install"/>. All the
    168     dependencies can be installed using the
    169     <xref linkend="perl-standard-install"/>.</para>
    170 
    171     <itemizedlist spacing='compact'>
    172       <listitem>
    173         <para><ulink
    174         url="http://cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz">
    175         Module-Build-&Module-Build-version;</ulink></para>
    176 
    177         <itemizedlist>
    178           <listitem>
    179             <para id="perl-module-signature"><ulink
    180             url="http://cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
    181             Module-Signature-&Module-Signature-version;</ulink> (optional)</para>
    182             <indexterm zone="perl-modules perl-module-signature">
    183               <primary sortas="g-Module-Signature">Module::Signature</primary>
    184             </indexterm>
    185 
    186             <itemizedlist>
    187               <listitem>
    188                 <para id="perl-digest-sha"><ulink
    189                 url="http://cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
    190                 Digest-SHA-&Digest-SHA-version;</ulink></para>
    191                 <indexterm zone="perl-modules perl-digest-sha">
    192                   <primary sortas="g-Digest-SHA">Digest::SHA</primary>
    193                 </indexterm>
    194               </listitem>
    195               <listitem>
    196                 <para id="perl-par-dist"><ulink
    197                 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz">
    198                 PAR-Dist-&PAR-Dist-version;</ulink></para>
    199                 <indexterm zone="perl-modules perl-par-dist">
    200                   <primary sortas="g-PAR-Dist">PAR::Dist</primary>
    201                 </indexterm>
    202               </listitem>
    203               <listitem>
    204                 <para><xref linkend="gnupg"/></para>
    205               </listitem>
    206             </itemizedlist>
    207 
    208           </listitem>
    209           <listitem>
    210             <para id="perl-extutils-parsexs"><ulink
    211             url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
    212             ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para>
    213             <indexterm zone="perl-modules perl-extutils-parsexs">
    214               <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary>
    215             </indexterm>
    216 
    217             <itemizedlist>
    218               <listitem>
    219                 <para id="perl-extutils-cbuilder"><ulink
    220                 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
    221                 ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para>
    222                 <indexterm zone="perl-modules perl-extutils-cbuilder">
    223                   <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary>
    224                 </indexterm>
    225               </listitem>
    226             </itemizedlist>
    227 
    228           </listitem>
    229           <listitem>
    230             <para id="perl-archive-tar"><ulink
    231             url="http://cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
    232             Archive-Tar-&Archive-Tar-version;</ulink></para>
    233             <indexterm zone="perl-modules perl-archive-tar">
    234               <primary sortas="g-Archive-Tar">Archive::Tar</primary>
    235             </indexterm>
    236 
    237             <itemizedlist>
    238               <listitem>
    239                 <para id="perl-io-zlib"><ulink
    240                 url="http://cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
    241                 IO-Zlib-&IO-Zlib-version;</ulink></para>
    242                 <indexterm zone="perl-modules perl-io-zlib">
    243                   <primary sortas="g-IO-Zlib">IO::Zlib</primary>
    244                 </indexterm>
    245 
    246                 <itemizedlist>
    247                   <listitem>
    248                     <para><xref linkend="perl-compress-zlib"/></para>
    249                   </listitem>
    250                 </itemizedlist>
    251 
    252               </listitem>
    253               <listitem>
    254                 <para><xref linkend="perl-test-pod"/></para>
    255               </listitem>
    256               <listitem>
    257                 <para id="perl-text-diff"><ulink
    258                 url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
    259                 Text-Diff-&Text-Diff-version;</ulink></para>
    260                 <indexterm zone="perl-modules perl-text-diff">
    261                   <primary sortas="g-Text-Diff">Text::Diff</primary>
    262                 </indexterm>
    263 
    264                 <itemizedlist>
    265                   <listitem>
    266                     <para id="perl-algorithm-diff"><ulink
    267                     url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.zip">
    268                     Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
    269                     <indexterm zone="perl-modules perl-algorithm-diff">
    270                       <primary sortas="g-Algorithm-Diff">Algorithm::Diff</primary>
    271                     </indexterm>
    272 
    273                     <itemizedlist>
    274                       <listitem>
    275                         <para><xref linkend="unzip"/></para>
    276                       </listitem>
    277                     </itemizedlist>
    278 
    279                   </listitem>
    280                 </itemizedlist>
    281 
    282               </listitem>
    283             </itemizedlist>
    284 
    285           </listitem>
    286           <listitem>
    287             <para id="perl-yaml"><ulink
    288             url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
    289             YAML-&YAML-version;</ulink></para>
    290             <indexterm zone="perl-modules perl-yaml">
    291               <primary sortas="g-YAML">YAML</primary>
    292             </indexterm>
    293           </listitem>
    294         </itemizedlist>
    295 
    296       </listitem>
    297     </itemizedlist>
    298 
    299     <bridgehead renderas="sect4" id="perl-module-build-install"
    300     xreflabel="modified build instructions">Module::Build Build and
    301     Installation Instructions</bridgehead>
    302 
    303 <screen><userinput>perl Build.PL &amp;&amp;
    304 ./Build test</userinput></screen>
    305 
    306     <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
    307 
    308 <screen role='root'><userinput>./Build install</userinput></screen>
     92        url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
     93        Archive-Zip-&Archive-Zip-version;</ulink></para>
     94
     95        <itemizedlist>
     96          <listitem>
     97            <para><xref linkend="perl-compress-zlib"/></para>
     98          </listitem>
     99        </itemizedlist>
     100
     101      </listitem>
     102    </itemizedlist>
    309103
    310104    <!-- Compress::Zlib -->
    311105    <bridgehead renderas="sect3" id="perl-compress-zlib"
    312     xreflabel="Compress::Zlib">The Compress::Zlib Module</bridgehead>
     106    xreflabel="Compress::Zlib-&Compress-Zlib-version;">
     107    Compress::Zlib-&Compress-Zlib-version;</bridgehead>
    313108
    314109    <indexterm zone="perl-modules perl-compress-zlib">
    … …  
    344139    </itemizedlist>
    345140
     141    <!-- Date::Manip -->
     142    <bridgehead renderas="sect3" id="perl-date-manip"
     143    xreflabel="Date::Manip-&DateManip-version;">
     144    Date::Manip-&DateManip-version;</bridgehead>
     145
     146    <indexterm zone="perl-modules perl-date-manip">
     147      <primary sortas="g-Date-Manip">Date::Manip</primary>
     148    </indexterm>
     149
     150    <para>Date::Manip is a set of routines designed to make any common
     151    date/time manipulation easy to do. Operations such as comparing two times,
     152    calculating a time a given amount of time from another, or parsing
     153    international times are all easily done. From the very beginning, the
     154    main focus of Date::Manip has been to be able to do ANY desired date/time
     155    operation easily.</para>
     156
     157    <itemizedlist spacing='compact'>
     158      <listitem>
     159        <para><ulink
     160        url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
     161        DateManip-&DateManip-version;</ulink>
     162        (<xref linkend="perl-standard-install"/>)</para>
     163      </listitem>
     164    </itemizedlist>
     165
     166    <!-- Finance::Quote -->
     167    <bridgehead renderas="sect3" id="perl-finance-quote"
     168    xreflabel="Finance::Quote-&Finance-Quote-version;">
     169    Finance::Quote-&Finance-Quote-version;</bridgehead>
     170
     171    <indexterm zone="perl-modules perl-finance-quote">
     172      <primary sortas="g-Finance-Quote">Finance::Quote</primary>
     173    </indexterm>
     174
     175    <para>Finance::Quote is used to get stock quotes from various Internet
     176    sources, including Yahoo! Finance, Fidelity Investments, and the Australian
     177    Stock Exchange. There are two methods of using this module &ndash; a
     178    functional interface that is depreciated, and an object-orientated method
     179    that provides greater flexibility and stability. With the exception of
     180    straight currency exchange rates, all information is returned as a
     181    two-dimensional hash (or a reference to such a hash, if called in a scalar
     182    context).</para>
     183
     184    <para>After you've installed the package, issue
     185    <command>perldoc Finance::Quote</command> for full information.
     186    Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
     187    after unpacking the distribution tarball and changing into the top-level
     188    directory. The module and dependencies can be installed using the
     189    <application>Perl</application> module
     190    <xref linkend="perl-standard-install"/>.</para>
     191
     192    <note>
     193      <para>To run the regression test suite, you'll need to create a
     194      symbolic link to the <filename class='directory'>test</filename>
     195      directory using the following command after unpacking the tarball
     196      and changing into the root directory of the sources:</para>
     197
     198<screen><userinput>ln -s test t</userinput></screen>
     199
     200      <para>Some tests will fail depending on certain conditions. See the
     201      <filename>INSTALL</filename> file for full details.</para>
     202    </note>
     203
     204    <itemizedlist spacing='compact'>
     205      <listitem>
     206        <para><ulink
     207        url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
     208        Finance-Quote-&Finance-Quote-version;</ulink></para>
     209
     210        <itemizedlist>
     211          <listitem>
     212            <para><xref linkend="perl-html-tableextract"/></para>
     213          </listitem>
     214          <listitem>
     215            <para><xref linkend="perl-lwp"/></para>
     216          </listitem>
     217        </itemizedlist>
     218
     219      </listitem>
     220    </itemizedlist>
     221
     222    <!-- Finance::QuoteHist -->
     223    <bridgehead renderas="sect3" id="perl-finance-quotehist"
     224    xreflabel="Finance::QuoteHist-&Finance-QuoteHist-version;">
     225    Finance::QuoteHist-&Finance-QuoteHist-version;</bridgehead>
     226
     227    <indexterm zone="perl-modules perl-finance-quotehist">
     228      <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
     229    </indexterm>
     230
     231    <para>The Finance::QuoteHist bundle is several modules designed to fetch
     232    historical stock quotes from the web. The module and dependencies can be
     233    installed using the <application>Perl</application> module
     234    <xref linkend="perl-standard-install"/>.</para>
     235
     236    <itemizedlist spacing='compact'>
     237      <listitem>
     238        <para><ulink
     239        url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
     240        Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
     241
     242        <itemizedlist>
     243          <listitem>
     244            <para><xref linkend="perl-html-tableextract"/></para>
     245          </listitem>
     246          <listitem>
     247            <para><xref linkend="perl-lwp"/></para>
     248          </listitem>
     249          <listitem>
     250            <para><xref linkend="perl-date-manip"/></para>
     251          </listitem>
     252          <listitem>
     253            <para id="perl-text-csv_xs"><ulink
     254            url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
     255            Text-CSV_XS-&Text-CSV_XS-version;</ulink></para>
     256            <indexterm zone="perl-modules perl-text-csv_xs">
     257              <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
     258            </indexterm>
     259          </listitem>
     260        </itemizedlist>
     261
     262      </listitem>
     263    </itemizedlist>
     264
    346265    <!-- HTML::Parser -->
    347266    <bridgehead renderas="sect3" id="perl-html-parser"
    348     xreflabel="HTML::Parser">The HTML::Parser Module</bridgehead>
     267    xreflabel="HTML::Parser-&HTML-Parser-version;">
     268    HTML::Parser-&HTML-Parser-version;</bridgehead>
    349269
    350270    <indexterm zone="perl-modules perl-html-parser">
    … …  
    381301    <!-- HTML::TableExtract -->
    382302    <bridgehead renderas="sect3" id="perl-html-tableextract"
    383     xreflabel="HTML::TableExtract">The HTML::TableExtract Module</bridgehead>
     303    xreflabel="HTML::TableExtract-&HTML-TableExtract-version;">
     304    HTML::TableExtract-&HTML-TableExtract-version;</bridgehead>
    384305
    385306    <indexterm zone="perl-modules perl-html-tableextract">
    … …  
    404325    </itemizedlist>
    405326
    406     <!-- Test::Simple -->
    407     <bridgehead renderas="sect3" id="perl-test-simple"
    408     xreflabel="Test::Simple">The Test::Simple Module</bridgehead>
    409 
    410     <indexterm zone="perl-modules perl-test-simple">
    411       <primary sortas="g-Test-Simple">Test::Simple</primary>
    412     </indexterm>
    413 
    414     <para>The Test::Simple module contains utilities designed to assist
    415     developers in creating tests. A version of Test::Simple was installed
    416     during LFS with the <application>Perl</application>-&LFS-Perl-version;
    417     installation, however, some of the sub-modules contained in Test::Simple
    418     have been updated (notably, the Test::More module) and these updated
    419     modules are now required by other modules. This updated version of
    420     Test::Simple also now includes the Test:Builder:Tester module, required by
    421     many of the modules on this page. Note that installing this updated
    422     version of Test::Simple will overwrite some files from the original
    423     <application>Perl</application> installation, but there's really nothing to
    424     be alarmed about as these modules are only used by developers creating
    425     tests, or for running the test suites during additional module
    426     installations.</para>
    427 
    428     <itemizedlist spacing='compact'>
    429       <listitem>
    430         <para><ulink
    431         url="http://cpan.org/authors/id/M/MS/MSCHWERN/Test-Simple-&Test-Simple-version;.tar.gz">
    432         Test-Simple-&Test-Simple-version;</ulink>
    433         (<xref linkend="perl-standard-install"/>)</para>
    434       </listitem>
    435     </itemizedlist>
    436 
    437     <!-- XML::Parser -->
    438     <bridgehead renderas="sect3" id="perl-xml-parser"
    439     xreflabel="XML::Parser">The XML::Parser Module</bridgehead>
    440 
    441     <indexterm zone="perl-modules perl-xml-parser">
    442       <primary sortas="g-XML-Parser">XML::Parser</primary>
    443     </indexterm>
    444 
    445     <para>The XML::Parser module is a <application>Perl</application> extension
    446     interface to James Clark's XML parser,
    447     <application>expat</application>. The module can be installed using the
    448     <application>Perl</application> Module
    449     <xref linkend="perl-standard-install"/>.</para>
    450 
    451     <itemizedlist spacing='compact'>
    452       <listitem>
    453         <para><ulink
    454         url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
    455         XML-Parser-&XML-Parser-version;</ulink></para>
    456 
    457         <itemizedlist>
    458           <listitem>
    459             <para><xref linkend="expat"/></para>
    460           </listitem>
    461         </itemizedlist>
    462 
    463       </listitem>
    464     </itemizedlist>
    465 
    466     <!-- SGMLSpm -->
    467     <bridgehead renderas="sect3" id="perl-sgmlspm"
    468     xreflabel="SGMLSpm">The SGMLSpm Module</bridgehead>
    469 
    470     <indexterm zone="perl-modules perl-sgmlspm">
    471       <primary sortas="g-SGMLSpm">SGMLSpm</primary>
    472     </indexterm>
    473 
    474     <para>The SGMLSpm module is a <application>Perl</application> library
    475     used for parsing the output from James Clark's SGMLS and NSGMLS
    476     parsers. This module requires modified installation instructions, shown
    477     below.</para>
    478 
    479     <itemizedlist spacing='compact'>
    480       <listitem>
    481         <para><ulink
    482         url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
    483         SGMLSpm-&SGMLSpm-version;</ulink></para>
    484       </listitem>
    485     </itemizedlist>
    486 
    487     <para>If your system's <application>Perl</application> version is different
    488     than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
    489     command below to reflect the version you have installed.</para>
    490 
    491 <screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
    492        -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
    493        -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
    494     Makefile</userinput></screen>
    495 
    496     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    497 
    498 <screen role="root"><userinput>make install &amp;&amp;
    499 install -v -d -m755 /usr/share/doc/perl5 &amp;&amp;
    500 make install_html &amp;&amp;
    501 rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
    502 install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
    503 
    504     <!-- Tk -->
    505     <bridgehead renderas="sect3" id="perl-tk"
    506     xreflabel="Perl-Tk">The Tk Module</bridgehead>
    507 
    508     <indexterm zone="perl-modules perl-tk">
    509       <primary sortas="g-Tk">Tk</primary>
    510     </indexterm>
    511 
    512     <para>The <application>Tk</application> module is a
    513     <application>Perl</application> interface to the
    514     <application>Tk</application> package. The goal of this release is Unicode
    515     support via <application>Perl</application>'s and
    516     core-<application>Tk</application>'s use of UTF-8. Tk-&Perl-Tk-version;
    517     builds and loads into a threaded <application>Perl</application> but is NOT
    518     yet thread safe. The module can be installed using the
    519     <application>Perl</application> Module
    520     <xref linkend="perl-standard-install"/>.</para>
    521 
    522     <itemizedlist spacing='compact'>
    523       <listitem>
    524         <para><ulink
    525         url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
    526         Tk-&Perl-Tk-version;</ulink></para>
    527 
    528         <itemizedlist>
    529           <listitem>
    530             <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
    531           </listitem>
    532         </itemizedlist>
    533 
    534       </listitem>
    535     </itemizedlist>
    536 
    537     <!-- Net::DNS -->
    538     <bridgehead renderas="sect3" id="perl-net-dns"
    539     xreflabel="Net-DNS">The Net::DNS Module</bridgehead>
    540 
    541     <indexterm zone="perl-modules perl-net-dns">
    542       <primary sortas="g-Net-DNS">Net::DNS</primary>
    543     </indexterm>
    544 
    545     <para>Net::DNS is a DNS resolver implemented in
    546     <application>Perl</application>. It can be used to perform nearly any type
    547     of DNS query from a <application>Perl</application> script. The Net::DNS
    548     module and all its dependencies can be installed using the
    549     <application>Perl</application> Module
    550     <xref linkend="perl-standard-install"/>.</para>
    551 
    552     <itemizedlist spacing='compact'>
    553       <listitem>
    554         <para><ulink
    555         url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
    556         Net-DNS-&Net-DNS-version;</ulink></para>
    557 
    558         <itemizedlist>
    559           <listitem>
    560             <para id="perl-digest-hmac"><ulink
    561             url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
    562             Digest-HMAC-&Digest-HMAC-version;</ulink></para>
    563             <indexterm zone="perl-modules perl-digest-hmac">
    564               <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
    565             </indexterm>
    566 
    567             <itemizedlist>
    568               <listitem>
    569                 <para id="perl-digest-sha1"><ulink
    570                 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
    571                 Digest-SHA1-&Digest-SHA1-version;</ulink></para>
    572                 <indexterm zone="perl-modules perl-digest-sha1">
    573                   <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
    574                 </indexterm>
    575               </listitem>
    576             </itemizedlist>
    577 
    578           </listitem>
    579           <listitem>
    580             <para id="perl-net-ip"><ulink
    581             url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
    582             Net-IP-&Net-IP-version;</ulink></para>
    583             <indexterm zone="perl-modules perl-net-ip">
    584               <primary sortas="g-Net-IP">Net::IP</primary>
    585             </indexterm>
    586           </listitem>
    587           <listitem>
    588             <para id="perl-io-socket-inet6"><ulink
    589             url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
    590             IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
    591             IPv6 support)</para>
    592             <indexterm zone="perl-modules perl-io-socket-inet6">
    593               <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
    594             </indexterm>
    595 
    596             <itemizedlist>
    597               <listitem>
    598                 <para id="perl-socket6"><ulink
    599                 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
    600                 Socket6-&Socket6-version;</ulink></para>
    601                 <indexterm zone="perl-modules perl-socket6">
    602                   <primary sortas="g-Socket6">Socket6</primary>
    603                 </indexterm>
    604               </listitem>
    605             </itemizedlist>
    606 
    607           </listitem>
    608           <listitem>
    609             <para id="perl-digest-bubblebabble"><ulink
    610             url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
    611             Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink>
    612             (optional, only used during the test suite)</para>
    613             <indexterm zone="perl-modules perl-digest-bubblebabble">
    614               <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
    615             </indexterm>
    616           </listitem>
    617         </itemizedlist>
    618 
    619       </listitem>
    620     </itemizedlist>
    621 
    622327    <!-- LWP -->
    623328    <bridgehead renderas="sect3" id="perl-lwp"
    624     xreflabel="LWP">The LWP Module</bridgehead>
     329    xreflabel="LWP-&LWP-version;">
     330    LWP-&LWP-version;</bridgehead>
    625331
    626332    <indexterm zone="perl-modules perl-lwp">
    … …  
    739445    </itemizedlist>
    740446
    741     <!-- Date::Manip -->
    742     <bridgehead renderas="sect3" id="perl-date-manip"
    743     xreflabel="Date::Manip">The Date::Manip Module</bridgehead>
    744 
    745     <indexterm zone="perl-modules perl-date-manip">
    746       <primary sortas="g-Date-Manip">Date::Manip</primary>
    747     </indexterm>
    748 
    749     <para>Date::Manip is a set of routines designed to make any common
    750     date/time manipulation easy to do. Operations such as comparing two times,
    751     calculating a time a given amount of time from another, or parsing
    752     international times are all easily done. From the very beginning, the
    753     main focus of Date::Manip has been to be able to do ANY desired date/time
    754     operation easily.</para>
    755 
    756     <itemizedlist spacing='compact'>
    757       <listitem>
    758         <para><ulink
    759         url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
    760         DateManip-&DateManip-version;</ulink>
     447    <!-- Module::Build -->
     448    <bridgehead renderas="sect3" id="perl-module-build"
     449    xreflabel="Module::Build-&Module-Build-version;">
     450    Module::Build-&Module-Build-version;</bridgehead>
     451
     452    <indexterm zone="perl-modules perl-module-build">
     453      <primary sortas="g-Module-Build">Module::Build</primary>
     454    </indexterm>
     455
     456    <para>The Module::Build module is a system for building, testing, and
     457    installing <application>Perl</application> modules. It is meant to be an
     458    alternative to ExtUtils::MakeMaker. Developers may alter the behavior of
     459    the module through subclassing in a much more straightforward way than with
     460    MakeMaker. It also does not require a <command>make</command> command on
     461    your system. Most of the Module::Build code is
     462    pure-<application>Perl</application> and written in a very cross-platform
     463    way.</para>
     464
     465    <para>The Module::Build module (as well as any other
     466    <application>Perl</application> module that uses the Module::Build build
     467    system) uses <xref linkend="perl-module-build-install"/>. All the
     468    dependencies can be installed using the
     469    <xref linkend="perl-standard-install"/>.</para>
     470
     471    <itemizedlist spacing='compact'>
     472      <listitem>
     473        <para><ulink
     474        url="http://cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz">
     475        Module-Build-&Module-Build-version;</ulink></para>
     476
     477        <itemizedlist>
     478          <listitem>
     479            <para id="perl-module-signature"><ulink
     480            url="http://cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
     481            Module-Signature-&Module-Signature-version;</ulink> (optional)</para>
     482            <indexterm zone="perl-modules perl-module-signature">
     483              <primary sortas="g-Module-Signature">Module::Signature</primary>
     484            </indexterm>
     485
     486            <itemizedlist>
     487              <listitem>
     488                <para id="perl-digest-sha"><ulink
     489                url="http://cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
     490                Digest-SHA-&Digest-SHA-version;</ulink></para>
     491                <indexterm zone="perl-modules perl-digest-sha">
     492                  <primary sortas="g-Digest-SHA">Digest::SHA</primary>
     493                </indexterm>
     494              </listitem>
     495              <listitem>
     496                <para id="perl-par-dist"><ulink
     497                url="http://cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz">
     498                PAR-Dist-&PAR-Dist-version;</ulink></para>
     499                <indexterm zone="perl-modules perl-par-dist">
     500                  <primary sortas="g-PAR-Dist">PAR::Dist</primary>
     501                </indexterm>
     502              </listitem>
     503              <listitem>
     504                <para><xref linkend="gnupg"/></para>
     505              </listitem>
     506            </itemizedlist>
     507
     508          </listitem>
     509          <listitem>
     510            <para id="perl-extutils-parsexs"><ulink
     511            url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
     512            ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para>
     513            <indexterm zone="perl-modules perl-extutils-parsexs">
     514              <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary>
     515            </indexterm>
     516
     517            <itemizedlist>
     518              <listitem>
     519                <para id="perl-extutils-cbuilder"><ulink
     520                url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
     521                ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para>
     522                <indexterm zone="perl-modules perl-extutils-cbuilder">
     523                  <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary>
     524                </indexterm>
     525              </listitem>
     526            </itemizedlist>
     527
     528          </listitem>
     529          <listitem>
     530            <para id="perl-archive-tar"><ulink
     531            url="http://cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
     532            Archive-Tar-&Archive-Tar-version;</ulink></para>
     533            <indexterm zone="perl-modules perl-archive-tar">
     534              <primary sortas="g-Archive-Tar">Archive::Tar</primary>
     535            </indexterm>
     536
     537            <itemizedlist>
     538              <listitem>
     539                <para id="perl-io-zlib"><ulink
     540                url="http://cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
     541                IO-Zlib-&IO-Zlib-version;</ulink></para>
     542                <indexterm zone="perl-modules perl-io-zlib">
     543                  <primary sortas="g-IO-Zlib">IO::Zlib</primary>
     544                </indexterm>
     545
     546                <itemizedlist>
     547                  <listitem>
     548                    <para><xref linkend="perl-compress-zlib"/></para>
     549                  </listitem>
     550                </itemizedlist>
     551
     552              </listitem>
     553              <listitem>
     554                <para><xref linkend="perl-test-pod"/></para>
     555              </listitem>
     556              <listitem>
     557                <para id="perl-text-diff"><ulink
     558                url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
     559                Text-Diff-&Text-Diff-version;</ulink></para>
     560                <indexterm zone="perl-modules perl-text-diff">
     561                  <primary sortas="g-Text-Diff">Text::Diff</primary>
     562                </indexterm>
     563
     564                <itemizedlist>
     565                  <listitem>
     566                    <para id="perl-algorithm-diff"><ulink
     567                    url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.zip">
     568                    Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
     569                    <indexterm zone="perl-modules perl-algorithm-diff">
     570                      <primary sortas="g-Algorithm-Diff">Algorithm::Diff</primary>
     571                    </indexterm>
     572
     573                    <itemizedlist>
     574                      <listitem>
     575                        <para><xref linkend="unzip"/></para>
     576                      </listitem>
     577                    </itemizedlist>
     578
     579                  </listitem>
     580                </itemizedlist>
     581
     582              </listitem>
     583            </itemizedlist>
     584
     585          </listitem>
     586          <listitem>
     587            <para id="perl-yaml"><ulink
     588            url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
     589            YAML-&YAML-version;</ulink></para>
     590            <indexterm zone="perl-modules perl-yaml">
     591              <primary sortas="g-YAML">YAML</primary>
     592            </indexterm>
     593          </listitem>
     594        </itemizedlist>
     595
     596      </listitem>
     597    </itemizedlist>
     598
     599    <bridgehead renderas="sect4" id="perl-module-build-install"
     600    xreflabel="modified build instructions">Module::Build Build and
     601    Installation Instructions</bridgehead>
     602
     603<screen><userinput>perl Build.PL &amp;&amp;
     604./Build test</userinput></screen>
     605
     606    <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
     607
     608<screen role='root'><userinput>./Build install</userinput></screen>
     609
     610    <!-- Module::Info -->
     611    <bridgehead renderas="sect3" id="perl-module-info"
     612    xreflabel="Module::Info-&Module-Info-version;">
     613    Module::Info-&Module-Info-version;</bridgehead>
     614
     615    <indexterm zone="perl-modules perl-module-info">
     616      <primary sortas="g-Module-Info">Module::Info</primary>
     617    </indexterm>
     618
     619    <para>The Module::Info module is quite useful for tasks other than just
     620    support of other modules. It can be used from the command-line to tell you
     621    if a particular module is included in, or has been installed into your
     622    <application>Perl</application> installation. Additionally, Module::Info
     623    can tell you what version of a module is installed and what dependencies
     624    are required for it. You can even use Module::Info to gather dependencies
     625    of uninstalled modules.</para>
     626
     627    <itemizedlist spacing='compact'>
     628      <listitem>
     629        <para><ulink
     630        url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
     631        Module-Info-&Module-Info-version;</ulink>
    761632        (<xref linkend="perl-standard-install"/>)</para>
    762633      </listitem>
    763634    </itemizedlist>
    764635
    765     <!-- Finance::Quote -->
    766     <bridgehead renderas="sect3" id="perl-finance-quote"
    767     xreflabel="Finance::Quote">The Finance::Quote Module</bridgehead>
    768 
    769     <indexterm zone="perl-modules perl-finance-quote">
    770       <primary sortas="g-Finance-Quote">Finance::Quote</primary>
    771     </indexterm>
    772 
    773     <para>Finance::Quote is used to get stock quotes from various Internet
    774     sources, including Yahoo! Finance, Fidelity Investments, and the Australian
    775     Stock Exchange. There are two methods of using this module &ndash; a
    776     functional interface that is depreciated, and an object-orientated method
    777     that provides greater flexibility and stability. With the exception of
    778     straight currency exchange rates, all information is returned as a
    779     two-dimensional hash (or a reference to such a hash, if called in a scalar
    780     context).</para>
    781 
    782     <para>After you've installed the package, issue
    783     <command>perldoc Finance::Quote</command> for full information.
    784     Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
    785     after unpacking the distribution tarball and changing into the top-level
    786     directory. The module and dependencies can be installed using the
    787     <application>Perl</application> module
     636    <!-- Net::DNS -->
     637    <bridgehead renderas="sect3" id="perl-net-dns"
     638    xreflabel="Net-DNS-&Net-DNS-version;">
     639    Net::DNS-&Net-DNS-version;</bridgehead>
     640
     641    <indexterm zone="perl-modules perl-net-dns">
     642      <primary sortas="g-Net-DNS">Net::DNS</primary>
     643    </indexterm>
     644
     645    <para>Net::DNS is a DNS resolver implemented in
     646    <application>Perl</application>. It can be used to perform nearly any type
     647    of DNS query from a <application>Perl</application> script. The Net::DNS
     648    module and all its dependencies can be installed using the
     649    <application>Perl</application> Module
    788650    <xref linkend="perl-standard-install"/>.</para>
    789651
    790     <note>
    791       <para>To run the regression test suite, you'll need to create a
    792       symbolic link to the <filename class='directory'>test</filename>
    793       directory using the following command after unpacking the tarball
    794       and changing into the root directory of the sources:</para>
    795 
    796 <screen><userinput>ln -s test t</userinput></screen>
    797 
    798       <para>Some tests will fail depending on certain conditions. See the
    799       <filename>INSTALL</filename> file for full details.</para>
    800     </note>
    801 
    802     <itemizedlist spacing='compact'>
    803       <listitem>
    804         <para><ulink
    805         url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
    806         Finance-Quote-&Finance-Quote-version;</ulink></para>
    807 
    808         <itemizedlist>
    809           <listitem>
    810             <para><xref linkend="perl-html-tableextract"/></para>
    811           </listitem>
    812           <listitem>
    813             <para><xref linkend="perl-lwp"/></para>
    814           </listitem>
    815         </itemizedlist>
    816 
    817       </listitem>
    818     </itemizedlist>
    819 
    820     <!-- Finance::QuoteHist -->
    821     <bridgehead renderas="sect3" id="perl-finance-quotehist"
    822     xreflabel="Finance::QuoteHist">The Finance::QuoteHist Module</bridgehead>
    823 
    824     <indexterm zone="perl-modules perl-finance-quotehist">
    825       <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
    826     </indexterm>
    827 
    828     <para>The Finance::QuoteHist bundle is several modules designed to fetch
    829     historical stock quotes from the web. The module and dependencies can be
    830     installed using the <application>Perl</application> module
     652    <itemizedlist spacing='compact'>
     653      <listitem>
     654        <para><ulink
     655        url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
     656        Net-DNS-&Net-DNS-version;</ulink></para>
     657
     658        <itemizedlist>
     659          <listitem>
     660            <para id="perl-digest-hmac"><ulink
     661            url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
     662            Digest-HMAC-&Digest-HMAC-version;</ulink></para>
     663            <indexterm zone="perl-modules perl-digest-hmac">
     664              <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
     665            </indexterm>
     666
     667            <itemizedlist>
     668              <listitem>
     669                <para id="perl-digest-sha1"><ulink
     670                url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
     671                Digest-SHA1-&Digest-SHA1-version;</ulink></para>
     672                <indexterm zone="perl-modules perl-digest-sha1">
     673                  <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
     674                </indexterm>
     675              </listitem>
     676            </itemizedlist>
     677
     678          </listitem>
     679          <listitem>
     680            <para id="perl-net-ip"><ulink
     681            url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
     682            Net-IP-&Net-IP-version;</ulink></para>
     683            <indexterm zone="perl-modules perl-net-ip">
     684              <primary sortas="g-Net-IP">Net::IP</primary>
     685            </indexterm>
     686          </listitem>
     687          <listitem>
     688            <para id="perl-io-socket-inet6"><ulink
     689            url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
     690            IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
     691            IPv6 support)</para>
     692            <indexterm zone="perl-modules perl-io-socket-inet6">
     693              <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
     694            </indexterm>
     695
     696            <itemizedlist>
     697              <listitem>
     698                <para id="perl-socket6"><ulink
     699                url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
     700                Socket6-&Socket6-version;</ulink></para>
     701                <indexterm zone="perl-modules perl-socket6">
     702                  <primary sortas="g-Socket6">Socket6</primary>
     703                </indexterm>
     704              </listitem>
     705            </itemizedlist>
     706
     707          </listitem>
     708          <listitem>
     709            <para id="perl-digest-bubblebabble"><ulink
     710            url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
     711            Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink>
     712            (optional, only used during the test suite)</para>
     713            <indexterm zone="perl-modules perl-digest-bubblebabble">
     714              <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
     715            </indexterm>
     716          </listitem>
     717        </itemizedlist>
     718
     719      </listitem>
     720    </itemizedlist>
     721
     722    <!-- Test::Pod -->
     723    <bridgehead renderas="sect3" id="perl-test-pod"
     724    xreflabel="Test::Pod">The Test::Pod Module</bridgehead>
     725
     726    <indexterm zone="perl-modules perl-test-pod">
     727      <primary sortas="g-Test-Pod">Test::Pod</primary>
     728    </indexterm>
     729
     730    <para>Another useful module, and one which is (typically optionally) used
     731    by other modules during the build process is the Test:Pod module. This
     732    module is used to check the validity of POD (Plain Old Documentation)
     733    files. The Test::Pod module is typically included by module authors to
     734    automatically find and check all POD files in a module distribution. This
     735    module and all the dependencies can be installed using the
    831736    <xref linkend="perl-standard-install"/>.</para>
    832737
    … …  
    834739      <listitem>
    835740        <para><ulink
    836         url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
    837         Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
    838 
    839         <itemizedlist>
    840           <listitem>
    841             <para><xref linkend="perl-html-tableextract"/></para>
    842           </listitem>
    843           <listitem>
    844             <para><xref linkend="perl-lwp"/></para>
    845           </listitem>
    846           <listitem>
    847             <para><xref linkend="perl-date-manip"/></para>
    848           </listitem>
    849           <listitem>
    850             <para id="perl-text-csv_xs"><ulink
    851             url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
    852             Text-CSV_XS-&Text-CSV_XS-version;</ulink></para>
    853             <indexterm zone="perl-modules perl-text-csv_xs">
    854               <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
    855             </indexterm>
    856           </listitem>
    857         </itemizedlist>
    858 
    859       </listitem>
    860     </itemizedlist>
    861 
    862     <!-- Archive::Zip -->
    863     <bridgehead renderas="sect3" id="perl-archive-zip"
    864     xreflabel="Archive::Zip">The Archive::Zip Module</bridgehead>
    865 
    866     <indexterm zone="perl-modules perl-archive-zip">
    867       <primary sortas="g-Archive-Zip">Archive::Zip</primary>
    868     </indexterm>
    869 
    870     <para>The Archive::Zip module allows a <application>Perl</application>
    871     program to create, manipulate, read, and write Zip archive files. The
    872     two modules listed below can be installed using the
    873     <application>Perl</application> module
     741        url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
     742        Test-Pod-&Test-Pod-version;</ulink></para>
     743
     744        <itemizedlist>
     745          <listitem>
     746            <para id="perl-pod-simple"><ulink
     747            url="http://cpan.org/authors/id/A/AR/ARANDAL/Pod-Simple-&Pod-Simple-version;.tar.gz">
     748            Pod-Simple-&Pod-Simple-version;</ulink></para>
     749            <indexterm zone="perl-modules perl-pod-simple">
     750              <primary sortas="g-Pod-Simple">Pod::Simple</primary>
     751            </indexterm>
     752
     753            <itemizedlist>
     754              <listitem>
     755                <para id="perl-pod-escapes"><ulink
     756                url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
     757                Pod-Escapes-&Pod-Escapes-version;</ulink></para>
     758                <indexterm zone="perl-modules perl-pod-escapes">
     759                  <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
     760                </indexterm>
     761              </listitem>
     762            </itemizedlist>
     763
     764          </listitem>
     765          <listitem>
     766            <para><xref linkend="perl-test-simple"/></para>
     767          </listitem>
     768        </itemizedlist>
     769
     770      </listitem>
     771    </itemizedlist>
     772
     773    <!-- Test::Simple -->
     774    <bridgehead renderas="sect3" id="perl-test-simple"
     775    xreflabel="Test::Simple">The Test::Simple Module</bridgehead>
     776
     777    <indexterm zone="perl-modules perl-test-simple">
     778      <primary sortas="g-Test-Simple">Test::Simple</primary>
     779    </indexterm>
     780
     781    <para>The Test::Simple module contains utilities designed to assist
     782    developers in creating tests. A version of Test::Simple was installed
     783    during LFS with the <application>Perl</application>-&LFS-Perl-version;
     784    installation, however, some of the sub-modules contained in Test::Simple
     785    have been updated (notably, the Test::More module) and these updated
     786    modules are now required by other modules. This updated version of
     787    Test::Simple also now includes the Test:Builder:Tester module, required by
     788    many of the modules on this page. Note that installing this updated
     789    version of Test::Simple will overwrite some files from the original
     790    <application>Perl</application> installation, but there's really nothing to
     791    be alarmed about as these modules are only used by developers creating
     792    tests, or for running the test suites during additional module
     793    installations.</para>
     794
     795    <itemizedlist spacing='compact'>
     796      <listitem>
     797        <para><ulink
     798        url="http://cpan.org/authors/id/M/MS/MSCHWERN/Test-Simple-&Test-Simple-version;.tar.gz">
     799        Test-Simple-&Test-Simple-version;</ulink>
     800        (<xref linkend="perl-standard-install"/>)</para>
     801      </listitem>
     802    </itemizedlist>
     803
     804    <!-- XML::Parser -->
     805    <bridgehead renderas="sect3" id="perl-xml-parser"
     806    xreflabel="XML::Parser">The XML::Parser Module</bridgehead>
     807
     808    <indexterm zone="perl-modules perl-xml-parser">
     809      <primary sortas="g-XML-Parser">XML::Parser</primary>
     810    </indexterm>
     811
     812    <para>The XML::Parser module is a <application>Perl</application> extension
     813    interface to James Clark's XML parser,
     814    <application>expat</application>. The module can be installed using the
     815    <application>Perl</application> Module
    874816    <xref linkend="perl-standard-install"/>.</para>
    875817
    … …  
    877819      <listitem>
    878820        <para><ulink
    879         url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
    880         Archive-Zip-&Archive-Zip-version;</ulink></para>
    881 
    882         <itemizedlist>
    883           <listitem>
    884             <para><xref linkend="perl-compress-zlib"/></para>
     821        url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
     822        XML-Parser-&XML-Parser-version;</ulink></para>
     823
     824        <itemizedlist>
     825          <listitem>
     826            <para><xref linkend="expat"/></para>
     827          </listitem>
     828        </itemizedlist>
     829
     830      </listitem>
     831    </itemizedlist>
     832
     833    <!-- SGMLSpm -->
     834    <bridgehead renderas="sect3" id="perl-sgmlspm"
     835    xreflabel="SGMLSpm">The SGMLSpm Module</bridgehead>
     836
     837    <indexterm zone="perl-modules perl-sgmlspm">
     838      <primary sortas="g-SGMLSpm">SGMLSpm</primary>
     839    </indexterm>
     840
     841    <para>The SGMLSpm module is a <application>Perl</application> library
     842    used for parsing the output from James Clark's SGMLS and NSGMLS
     843    parsers. This module requires modified installation instructions, shown
     844    below.</para>
     845
     846    <itemizedlist spacing='compact'>
     847      <listitem>
     848        <para><ulink
     849        url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
     850        SGMLSpm-&SGMLSpm-version;</ulink></para>
     851      </listitem>
     852    </itemizedlist>
     853
     854    <para>If your system's <application>Perl</application> version is different
     855    than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
     856    command below to reflect the version you have installed.</para>
     857
     858<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
     859       -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
     860       -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
     861    Makefile</userinput></screen>
     862
     863    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     864
     865<screen role="root"><userinput>make install &amp;&amp;
     866install -v -d -m755 /usr/share/doc/perl5 &amp;&amp;
     867make install_html &amp;&amp;
     868rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
     869install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
     870
     871    <!-- Tk -->
     872    <bridgehead renderas="sect3" id="perl-tk"
     873    xreflabel="Perl-Tk">The Tk Module</bridgehead>
     874
     875    <indexterm zone="perl-modules perl-tk">
     876      <primary sortas="g-Tk">Tk</primary>
     877    </indexterm>
     878
     879    <para>The <application>Tk</application> module is a
     880    <application>Perl</application> interface to the
     881    <application>Tk</application> package. The goal of this release is Unicode
     882    support via <application>Perl</application>'s and
     883    core-<application>Tk</application>'s use of UTF-8. Tk-&Perl-Tk-version;
     884    builds and loads into a threaded <application>Perl</application> but is NOT
     885    yet thread safe. The module can be installed using the
     886    <application>Perl</application> Module
     887    <xref linkend="perl-standard-install"/>.</para>
     888
     889    <itemizedlist spacing='compact'>
     890      <listitem>
     891        <para><ulink
     892        url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
     893        Tk-&Perl-Tk-version;</ulink></para>
     894
     895        <itemizedlist>
     896          <listitem>
     897            <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
    885898          </listitem>
    886899        </itemizedlist>
Note: See TracChangeset for help on using the changeset viewer.