source: general/prog/perl-modules.xml@ 717a0d0

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
Last change on this file since 717a0d0 was 717a0d0, checked in by Randy McMurchy <randy@…>, 18 years ago

Added three new Perl Modules as dependencies of the Digest::SHA module: Devel::Symdump, Pod::Coverage and Test::Pod::Coverage

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5568 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 46.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY perl_modules_md5sums_download_http "http://anduin.linuxfromscratch.org/sources/BLFS/SVN/Perl_Modules/Perl_Modules.gz.md5sums">
8 <!ENTITY perl_modules_md5sums_download_ftp "ftp://anduin.linuxfromscratch.org/BLFS/SVN/Perl_Modules/Perl_Modules.gz.md5sums">
9]>
10
11<sect1 id="perl-modules" xreflabel="Perl modules">
12 <?dbhtml filename="perl-modules.html" ?>
13
14 <sect1info>
15 <othername>$LastChangedBy$</othername>
16 <date>$Date$</date>
17 </sect1info>
18
19 <title>Perl Modules</title>
20
21 <indexterm zone="perl-modules">
22 <primary sortas="a-Perl-modules">Perl modules</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Perl Modules</title>
27
28 <para>The <application>Perl</application> module packages add useful
29 objects to the <application>Perl</application> language. Modules utilized
30 by packages throughout BLFS are listed here, along with their dependencies.
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
38 names.</para>
39
40 <note>
41 <para>Some dependencies, such as the <xref linkend="perl-test-pod"/>
42 module, are used by several of the listed dependencies and perhaps also
43 the module being installed. Dependencies such as this are only listed
44 once in the dependency chain for each module to avoid redundancy and
45 additional clutter in the instructions.</para>
46 </note>
47
48 <!-- This section commented out now because the new organization of files
49 on the Anduin server do not include md5sums for the .tar.gz Perl
50 module sources
51
52 <itemizedlist spacing="compact">
53 <listitem>
54 <para>Download MD5 sums (HTTP):
55 <ulink url="&perl_modules_md5sums_download_http;"/></para>
56 </listitem>
57 <listitem>
58 <para>Download MD5 sums (FTP):
59 <ulink url="&perl_modules_md5sums_download_ftp;"/></para>
60 </listitem>
61 </itemizedlist>
62 -->
63
64 <!-- This is info for the Test::Builder::Tester module which may very well
65 be obsolete now. The packages that need it apparently also now need
66 Test::More-0.62 which is a core Perl module in an updated version. To
67 install the Test::More-0.62 version you must install the
68 Test::Simple-0.62 module which will overwrite the Perl core stuff.
69 The Test::Simple-0.62 module now includes the Test::Builder::Tester
70 module. Perl versions starting with Perl-5.9.x will have this module
71 include in the core at which time Test::Builder::Tester can be forever
72 removed from this page as it will then also be a core module.
73
74 <para id="perl-test-builder-tester"><ulink
75 url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
76 Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
77 <indexterm zone="perl-modules perl-test-builder-tester">
78 <primary sortas="g-Test-Builder-Tester">Test::Builder::Tester</primary>
79 </indexterm>
80 -->
81
82 <!-- Archive::Zip -->
83 <bridgehead renderas="sect3" id="perl-archive-zip"
84 xreflabel="Archive::Zip-&Archive-Zip-version;">
85 Archive::Zip-&Archive-Zip-version;</bridgehead>
86
87 <indexterm zone="perl-modules perl-archive-zip">
88 <primary sortas="g-Archive-Zip">Archive::Zip</primary>
89 </indexterm>
90
91 <para>The Archive::Zip module allows a <application>Perl</application>
92 program to create, manipulate, read, and write Zip archive files. The
93 modules listed below can be installed using the standard
94 <application>Perl</application> module
95 <xref linkend="perl-standard-install"/>.</para>
96
97 <itemizedlist spacing='compact'>
98 <listitem>
99 <para><ulink
100 url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
101 Archive-Zip-&Archive-Zip-version;</ulink></para>
102
103 <itemizedlist>
104 <listitem>
105 <para><xref linkend="perl-compress-zlib"/></para>
106 </listitem>
107 <listitem>
108 <para><xref linkend="perl-test-pod"/> (optionally used during the
109 tests)</para>
110 </listitem>
111 </itemizedlist>
112
113 </listitem>
114 </itemizedlist>
115
116 <!-- Compress::Zlib -->
117 <bridgehead renderas="sect3" id="perl-compress-zlib"
118 xreflabel="Compress::Zlib-&Compress-Zlib-version;">
119 Compress::Zlib-&Compress-Zlib-version;</bridgehead>
120
121 <indexterm zone="perl-modules perl-compress-zlib">
122 <primary sortas="g-Compress-Zlib">Compress::Zlib</primary>
123 </indexterm>
124
125 <para>The Compress::Zlib module provides a <application>Perl</application>
126 interface to the <application>Zlib</application> compression library. Most
127 of the functionality provided by <application>Zlib</application> is
128 available in Compress::Zlib. The module can be split into two general areas
129 of functionality, namely in-memory compression/decompression and read/write
130 access to gzip files.</para>
131
132 <note>
133 <para>The Compress::Zlib module requires the following
134 <command>sed</command> after untarring the distribution tarball (before
135 any other build commands) to use the system-installed copy of
136 <application>Zlib</application>.</para>
137
138<screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \
139 -e "s|INCLUDE = ./zlib-src|INCLUDE = /usr/include|" \
140 -e "s|LIB = ./zlib-src|LIB = /usr/lib|" \
141 config.in</userinput></screen>
142 </note>
143
144 <itemizedlist spacing='compact'>
145 <listitem>
146 <para><ulink
147 url="http://cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz">
148 Compress-Zlib-&Compress-Zlib-version;</ulink>
149 (<xref linkend="perl-standard-install"/>)</para>
150 </listitem>
151 </itemizedlist>
152
153 <!-- Date::Manip -->
154 <bridgehead renderas="sect3" id="perl-date-manip"
155 xreflabel="Date::Manip-&DateManip-version;">
156 Date::Manip-&DateManip-version;</bridgehead>
157
158 <indexterm zone="perl-modules perl-date-manip">
159 <primary sortas="g-Date-Manip">Date::Manip</primary>
160 </indexterm>
161
162 <para>Date::Manip is a set of routines designed to make any common
163 date/time manipulation easy to do. Operations such as comparing two times,
164 calculating a time a given amount of time from another, or parsing
165 international times are all easily done. From the very beginning, the
166 main focus of Date::Manip has been to be able to do ANY desired date/time
167 operation easily.</para>
168
169 <itemizedlist spacing='compact'>
170 <listitem>
171 <para><ulink
172 url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
173 DateManip-&DateManip-version;</ulink>
174 (<xref linkend="perl-standard-install"/>)</para>
175 </listitem>
176 </itemizedlist>
177
178 <!-- Finance::Quote -->
179 <bridgehead renderas="sect3" id="perl-finance-quote"
180 xreflabel="Finance::Quote-&Finance-Quote-version;">
181 Finance::Quote-&Finance-Quote-version;</bridgehead>
182
183 <indexterm zone="perl-modules perl-finance-quote">
184 <primary sortas="g-Finance-Quote">Finance::Quote</primary>
185 </indexterm>
186
187 <para>Finance::Quote is used to get stock quotes from various Internet
188 sources, including Yahoo! Finance, Fidelity Investments, and the Australian
189 Stock Exchange. There are two methods of using this module &ndash; a
190 functional interface that is depreciated, and an object-orientated method
191 that provides greater flexibility and stability. With the exception of
192 straight currency exchange rates, all information is returned as a
193 two-dimensional hash (or a reference to such a hash, if called in a scalar
194 context).</para>
195
196 <para>After you've installed the package, issue
197 <command>perldoc Finance::Quote</command> for full information.
198 Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
199 after unpacking the distribution tarball and changing into the top-level
200 directory. The module and dependencies can be installed using the
201 standard <application>Perl</application> module
202 <xref linkend="perl-standard-install"/>.</para>
203
204 <note>
205 <para>To run the regression test suite, you'll need to create a
206 symbolic link to the <filename class='directory'>test</filename>
207 directory using the following command after unpacking the tarball
208 and changing into the root directory of the sources:</para>
209
210<screen><userinput>ln -s test t</userinput></screen>
211
212 <para>Some tests will fail depending on certain conditions. See the
213 <filename>INSTALL</filename> file for full details.</para>
214 </note>
215
216 <itemizedlist spacing='compact'>
217 <listitem>
218 <para><ulink
219 url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
220 Finance-Quote-&Finance-Quote-version;</ulink></para>
221
222 <itemizedlist>
223 <listitem>
224 <para><xref linkend="perl-html-tableextract"/></para>
225 </listitem>
226 <listitem>
227 <para><xref linkend="perl-lwp"/></para>
228 </listitem>
229 </itemizedlist>
230
231 </listitem>
232 </itemizedlist>
233
234 <!-- Finance::QuoteHist -->
235 <bridgehead renderas="sect3" id="perl-finance-quotehist"
236 xreflabel="Finance::QuoteHist-&Finance-QuoteHist-version;">
237 Finance::QuoteHist-&Finance-QuoteHist-version;</bridgehead>
238
239 <indexterm zone="perl-modules perl-finance-quotehist">
240 <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
241 </indexterm>
242
243 <para>The Finance::QuoteHist bundle is several modules designed to fetch
244 historical stock quotes from the web. The module and dependencies can be
245 installed using the standard <application>Perl</application> module
246 <xref linkend="perl-standard-install"/>.</para>
247
248 <itemizedlist spacing='compact'>
249 <listitem>
250 <para><ulink
251 url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
252 Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
253
254 <itemizedlist>
255 <listitem>
256 <para><xref linkend="perl-html-tableextract"/></para>
257 </listitem>
258 <listitem>
259 <para><xref linkend="perl-lwp"/></para>
260 </listitem>
261 <listitem>
262 <para><xref linkend="perl-date-manip"/></para>
263 </listitem>
264 <listitem>
265 <para id="perl-text-csv_xs"><ulink
266 url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
267 Text-CSV_XS-&Text-CSV_XS-version;</ulink></para>
268 <indexterm zone="perl-modules perl-text-csv_xs">
269 <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
270 </indexterm>
271 </listitem>
272 </itemizedlist>
273
274 </listitem>
275 </itemizedlist>
276
277 <!-- HTML::Parser -->
278 <bridgehead renderas="sect3" id="perl-html-parser"
279 xreflabel="HTML::Parser-&HTML-Parser-version;">
280 HTML::Parser-&HTML-Parser-version;</bridgehead>
281
282 <indexterm zone="perl-modules perl-html-parser">
283 <primary sortas="g-HTML-Parser">HTML::Parser</primary>
284 </indexterm>
285
286 <para>The HTML::Parser distribution is a collection of modules that parse
287 and extract information from HTML documents. In order to use the included
288 HTML::HeadParser module, you will also need to install
289 <xref linkend="perl-lwp"/>. The two modules listed below can be installed
290 using the standard <application>Perl</application> Module
291 <xref linkend="perl-standard-install"/>.</para>
292
293 <itemizedlist spacing='compact'>
294 <listitem>
295 <para><ulink
296 url="http://cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
297 HTML-Parser-&HTML-Parser-version;</ulink></para>
298
299 <itemizedlist>
300 <listitem>
301 <para id="perl-html-tagset"><ulink
302 url="http://cpan.org/authors/id/P/PE/PETDANCE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
303 HTML-Tagset-&HTML-Tagset-version;</ulink></para>
304 <indexterm zone="perl-modules perl-html-tagset">
305 <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
306 </indexterm>
307
308 <itemizedlist>
309 <listitem>
310 <para><xref linkend="perl-test-pod"/> (optionally used during the
311 tests)</para>
312 </listitem>
313 </itemizedlist>
314
315 </listitem>
316 </itemizedlist>
317
318 </listitem>
319 </itemizedlist>
320
321 <!-- HTML::TableExtract -->
322 <bridgehead renderas="sect3" id="perl-html-tableextract"
323 xreflabel="HTML::TableExtract-&HTML-TableExtract-version;">
324 HTML::TableExtract-&HTML-TableExtract-version;</bridgehead>
325
326 <indexterm zone="perl-modules perl-html-tableextract">
327 <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary>
328 </indexterm>
329
330 <para></para>
331
332 <itemizedlist spacing='compact'>
333 <listitem>
334 <para><ulink
335 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
336 HTML-TableExtract-&HTML-TableExtract-version;</ulink></para>
337
338 <itemizedlist>
339 <listitem>
340 <para><xref linkend="perl-html-parser"/></para>
341 </listitem>
342 </itemizedlist>
343
344 </listitem>
345 </itemizedlist>
346
347 <!-- LWP -->
348 <bridgehead renderas="sect3" id="perl-lwp"
349 xreflabel="LWP-&LWP-version;">
350 LWP-&LWP-version;</bridgehead>
351
352 <indexterm zone="perl-modules perl-lwp">
353 <primary sortas="g-LWP">LWP</primary>
354 </indexterm>
355
356 <para>The libwww-perl (LWP) collection is a set of
357 <application>Perl</application> modules which provides a simple and
358 consistent application programming interface to the World-Wide Web. The
359 main focus of the library is to provide classes and functions that allow
360 you to write WWW clients. The library also contains modules that are of
361 more general use and even classes that help you implement simple HTTP
362 servers. The LWP modules and all its <application>Perl</application>
363 module dependencies can be installed using the standard
364 <application>Perl</application> Module
365 <xref linkend="perl-standard-install"/>.</para>
366
367 <itemizedlist spacing='compact'>
368 <listitem>
369 <para><ulink
370 url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
371 LWP-&LWP-version;</ulink></para>
372
373 <itemizedlist>
374 <listitem>
375 <para id="perl-uri"><ulink
376 url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
377 URI-&URI-version;</ulink></para>
378 <indexterm zone="perl-modules perl-uri">
379 <primary sortas="g-URI">URI</primary>
380 </indexterm>
381
382 <itemizedlist>
383 <listitem>
384 <para id="perl-business-isbn"><ulink
385 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
386 Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
387 used during the test suite)</para>
388 <indexterm zone="perl-modules perl-business-isbn">
389 <primary sortas="g-Business-ISBN">Business::ISBN</primary>
390 </indexterm>
391
392 <itemizedlist>
393 <listitem>
394 <para id="perl-business-isbn-data"><ulink
395 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
396 Business-ISBN-Data-&Business-ISBN-Data-version;</ulink></para>
397 <indexterm zone="perl-modules perl-business-isbn-data">
398 <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
399 </indexterm>
400
401 <itemizedlist>
402 <listitem>
403 <para><xref linkend="perl-test-pod"/></para>
404 </listitem>
405 <listitem>
406 <para id="perl-test-prereq"><ulink
407 url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
408 Test-Prereq-&Test-Prereq-version;</ulink></para>
409 <indexterm zone="perl-modules perl-test-prereq">
410 <primary sortas="g-Test-Prereq">Test::Prereq</primary>
411 </indexterm>
412
413 <itemizedlist>
414 <listitem>
415 <para><xref linkend="perl-module-info"/></para>
416 </listitem>
417 <listitem>
418 <para><xref linkend="perl-module-build"/> (optional)</para>
419 </listitem>
420 <listitem>
421 <para id="perl-module-corelist"><ulink
422 url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
423 Module-CoreList-&Module-Corelist-version;</ulink></para>
424 <indexterm zone="perl-modules perl-module-corelist">
425 <primary sortas="g-Module-Corelist">Module::Corelist</primary>
426 </indexterm>
427 </listitem>
428 </itemizedlist>
429
430 </listitem>
431 </itemizedlist>
432
433 </listitem>
434 </itemizedlist>
435
436 </listitem>
437 </itemizedlist>
438
439 </listitem>
440 <listitem>
441 <para><xref linkend="perl-html-parser"/></para>
442 </listitem>
443 <listitem>
444 <para><xref linkend="perl-compress-zlib"/></para>
445 </listitem>
446 <listitem>
447 <para id="perl-crypt-ssleay"><ulink
448 url="http://cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
449 Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
450 support)</para>
451 <indexterm zone="perl-modules perl-crypt-ssleay">
452 <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
453 </indexterm>
454
455 <itemizedlist>
456 <listitem>
457 <para><xref linkend="openssl"/></para>
458 </listitem>
459 </itemizedlist>
460
461 </listitem>
462 </itemizedlist>
463
464 </listitem>
465 </itemizedlist>
466
467 <!-- Module::Build -->
468 <bridgehead renderas="sect3" id="perl-module-build"
469 xreflabel="Module::Build-&Module-Build-version;">
470 Module::Build-&Module-Build-version;</bridgehead>
471
472 <indexterm zone="perl-modules perl-module-build">
473 <primary sortas="g-Module-Build">Module::Build</primary>
474 </indexterm>
475
476 <para>The Module::Build module is a system for building, testing, and
477 installing <application>Perl</application> modules. It is meant to be an
478 alternative to ExtUtils::MakeMaker. Developers may alter the behavior of
479 the module through subclassing in a much more straightforward way than with
480 MakeMaker. It also does not require a <command>make</command> command on
481 your system. Most of the Module::Build code is
482 pure-<application>Perl</application> and written in a very cross-platform
483 way.</para>
484
485 <para>The Module::Build module (as well as any other
486 <application>Perl</application> module that uses the Module::Build build
487 system) uses <xref linkend="perl-module-build-install"/>. All the
488 dependencies can be installed using the standard
489 <application>Perl</application> module
490 <xref linkend="perl-standard-install"/>.</para>
491
492 <itemizedlist spacing='compact'>
493 <listitem>
494 <para><ulink
495 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz">
496 Module-Build-&Module-Build-version;</ulink></para>
497
498 <itemizedlist>
499 <listitem>
500 <para id="perl-extutils-parsexs"><ulink
501 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
502 ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para>
503 <indexterm zone="perl-modules perl-extutils-parsexs">
504 <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary>
505 </indexterm>
506
507 <itemizedlist>
508 <listitem>
509 <para id="perl-extutils-cbuilder"><ulink
510 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
511 ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para>
512 <indexterm zone="perl-modules perl-extutils-cbuilder">
513 <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary>
514 </indexterm>
515 </listitem>
516 </itemizedlist>
517
518 </listitem>
519 <listitem>
520 <para id="perl-archive-tar"><ulink
521 url="http://cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
522 Archive-Tar-&Archive-Tar-version;</ulink></para>
523 <indexterm zone="perl-modules perl-archive-tar">
524 <primary sortas="g-Archive-Tar">Archive::Tar</primary>
525 </indexterm>
526
527 <itemizedlist>
528 <listitem>
529 <para id="perl-io-zlib"><ulink
530 url="http://cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
531 IO-Zlib-&IO-Zlib-version;</ulink></para>
532 <indexterm zone="perl-modules perl-io-zlib">
533 <primary sortas="g-IO-Zlib">IO::Zlib</primary>
534 </indexterm>
535
536 <itemizedlist>
537 <listitem>
538 <para><xref linkend="perl-compress-zlib"/></para>
539 </listitem>
540 </itemizedlist>
541
542 </listitem>
543 <listitem>
544 <para><xref linkend="perl-text-diff"/></para>
545 </listitem>
546 <listitem>
547 <para><xref linkend="perl-test-pod"/> (optionally used during
548 the tests)</para>
549 </listitem>
550 </itemizedlist>
551
552 </listitem>
553 <listitem>
554 <para><xref linkend="perl-module-signature"/> (required to use the
555 Module::Build <quote>distsign</quote> run-time method and
556 optionally used during the tests)</para>
557 </listitem>
558 <listitem>
559 <para><ulink
560 url="http://cpan.org/authors/id/I/IN/INGY/YAML-0.39.tar.gz">
561 YAML-0.39</ulink> (Optional &mdash; adds an additional feature to
562 Module::Build. Note that this version of YAML is older than the
563 existing <xref linkend="perl-yaml"/> listed on this page. The newer
564 version is not compatible with this version of Module::Build.
565 Also note that you cannot have both YAML-0.39 and another version
566 exist together.)</para>
567 </listitem>
568 </itemizedlist>
569
570 </listitem>
571 </itemizedlist>
572
573 <bridgehead renderas="sect4" id="perl-module-build-install"
574 xreflabel="modified build instructions">Module::Build Build and
575 Installation Instructions</bridgehead>
576
577<screen><userinput>perl Build.PL &amp;&amp;
578./Build &amp;&amp;
579./Build test</userinput></screen>
580
581 <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
582
583<screen role='root'><userinput>./Build install</userinput></screen>
584
585 <!-- Module::Info -->
586 <bridgehead renderas="sect3" id="perl-module-info"
587 xreflabel="Module::Info-&Module-Info-version;">
588 Module::Info-&Module-Info-version;</bridgehead>
589
590 <indexterm zone="perl-modules perl-module-info">
591 <primary sortas="g-Module-Info">Module::Info</primary>
592 </indexterm>
593
594 <para>The Module::Info module is quite useful for tasks other than just
595 support of other modules. It can be used from the command-line to tell you
596 if a particular module is included in, or has been installed into your
597 <application>Perl</application> installation. Additionally, Module::Info
598 can tell you what version of a module is installed and what dependencies
599 are required for it. You can even use Module::Info to gather dependencies
600 of uninstalled modules. The Module::Info module installs using the standard
601 <application>Perl</application> module
602 <xref linkend="perl-standard-install"/>. The version module requires using
603 the Module::Build installation method.</para>
604
605 <itemizedlist spacing='compact'>
606 <listitem>
607 <para><ulink
608 url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
609 Module-Info-&Module-Info-version;</ulink></para>
610
611 <itemizedlist>
612 <listitem>
613 <para id="perl-version-module"><ulink
614 url="http://cpan.org/authors/id/J/JP/JPEACOCK/version-&version-perl-version;.tar.gz">
615 version-&version-perl-version;</ulink>
616 (optionally used during the tests)</para>
617 <indexterm zone="perl-modules perl-version-module">
618 <primary sortas="g-version">version</primary>
619 </indexterm>
620
621 <itemizedlist>
622 <listitem>
623 <para><xref linkend="perl-module-build"/></para>
624 </listitem>
625 </itemizedlist>
626
627 </listitem>
628 <listitem>
629 <para><xref linkend="perl-test-pod"/>
630 (optionally used during the tests)</para>
631 </listitem>
632 </itemizedlist>
633
634 </listitem>
635 </itemizedlist>
636
637 <!-- Module::Signature -->
638 <bridgehead renderas="sect3" id="perl-module-signature"
639 xreflabel="Module::Signature-&Module-Signature-version;">
640 Module::Signature-&Module-Signature-version;</bridgehead>
641
642 <indexterm zone="perl-modules perl-module-signature">
643 <primary sortas="g-Module-Signature">Module::Signature</primary>
644 </indexterm>
645
646 <para>The Module::Signature module is used to check and create
647 <filename>SIGNATURE</filename> files for CPAN distributions. After
648 installing Module::Signature you can verify the content of a distribution
649 tarball (if it includes a <filename>SIGNATURE</filename> file) by unpacking
650 the tarball, changing into the newly created directory and issuing the
651 command <command>cpansign -v</command>. It will check each file's
652 integrity, as well as the signature's validity. Some of the dependencies
653 appear to be circular, however, they are only run-time conflicts and you
654 should be able to fully utilize them as long as everything is
655 installed.</para>
656
657 <itemizedlist spacing='compact'>
658 <listitem>
659 <para><ulink
660 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
661 Module-Signature-&Module-Signature-version;</ulink></para>
662
663 <itemizedlist>
664 <listitem>
665 <para><xref linkend="perl-text-diff"/></para>
666 </listitem>
667 <listitem>
668 <para id="perl-par-dist"><ulink
669 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz">
670 PAR-Dist-&PAR-Dist-version;</ulink></para>
671 <indexterm zone="perl-modules perl-par-dist">
672 <primary sortas="g-PAR-Dist">PAR::Dist</primary>
673 </indexterm>
674
675 <itemizedlist>
676 <listitem>
677 <para><xref linkend="perl-archive-zip"/></para>
678 </listitem>
679 <listitem>
680 <para><xref linkend="perl-lwp"/></para>
681 </listitem>
682 <listitem>
683 <para><xref linkend="perl-module-signature"/></para>
684 </listitem>
685 </itemizedlist>
686
687 </listitem>
688 <listitem>
689 <para id="perl-digest-sha"><ulink
690 url="http://cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
691 Digest-SHA-&Digest-SHA-version;</ulink></para>
692 <indexterm zone="perl-modules perl-digest-sha">
693 <primary sortas="g-Digest-SHA">Digest::SHA</primary>
694 </indexterm>
695
696 <itemizedlist>
697 <listitem>
698 <para id="perl-test-pod-coverage"><ulink
699 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-Coverage-&Test-Pod-Coverage-version;.tar.gz">
700 Test-Pod-Coverage-&Test-Pod-Coverage-version;</ulink>
701 (optionally used during the tests).</para>
702 <indexterm zone="perl-modules perl-test-pod-coverage">
703 <primary sortas="g-Test-Pod-Coverage">Test::Pod::Coverage</primary>
704 </indexterm>
705
706 <itemizedlist>
707 <listitem>
708 <para id="perl-test-builder-tester">
709 <xref linkend="perl-test-simple"/> or
710 <ulink
711 url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
712 Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
713 <indexterm zone="perl-modules perl-test-builder-tester">
714 <primary sortas="g-Test-Builder-Tester">Test::Builder::Tester</primary>
715 </indexterm>
716 </listitem>
717 <listitem>
718 <para id="perl-pod-coverage"><ulink
719 url="http://cpan.org/authors/id/R/RC/RCLAMP/Pod-Coverage-0.17.tar.gz">
720 Pod-Coverage-&Pod-Coverage-version;</ulink></para>
721 <indexterm zone="perl-modules perl-pod-coverage">
722 <primary sortas="g-Pod-Coverage">Pod::Coverage</primary>
723 </indexterm>
724
725 <itemizedlist>
726 <listitem>
727 <para id="perl-devel-symdump"><ulink
728 url="http://cpan.org/authors/id/A/AN/ANDK/Devel-Symdump-&Devel-Symdump-version;.tar.gz">
729 Devel-Symdump-&Devel-Symdump-version;</ulink></para>
730 <indexterm zone="perl-modules perl-devel-symdump">
731 <primary sortas="g-Devel-Symdump">Devel::Symdump</primary>
732 </indexterm>
733
734 <itemizedlist>
735 <listitem>
736 <para><xref linkend="perl-test-pod"/> (optionally
737 used during the tests)</para>
738 </listitem>
739 </itemizedlist>
740
741 </listitem>
742 <listitem>
743 <para><xref linkend="perl-module-build"/></para>
744 </listitem>
745 </itemizedlist>
746
747 </listitem>
748 </itemizedlist>
749
750 </listitem>
751 </itemizedlist>
752
753 </listitem>
754 <listitem>
755 <para><xref linkend="gnupg"/></para>
756 </listitem>
757 </itemizedlist>
758
759 </listitem>
760 </itemizedlist>
761
762 <!-- Net::DNS -->
763 <bridgehead renderas="sect3" id="perl-net-dns"
764 xreflabel="Net-DNS-&Net-DNS-version;">
765 Net::DNS-&Net-DNS-version;</bridgehead>
766
767 <indexterm zone="perl-modules perl-net-dns">
768 <primary sortas="g-Net-DNS">Net::DNS</primary>
769 </indexterm>
770
771 <para>Net::DNS is a DNS resolver implemented in
772 <application>Perl</application>. It can be used to perform nearly any type
773 of DNS query from a <application>Perl</application> script. The Net::DNS
774 module and all its dependencies can be installed using the standard
775 <application>Perl</application> Module
776 <xref linkend="perl-standard-install"/>.</para>
777
778 <itemizedlist spacing='compact'>
779 <listitem>
780 <para><ulink
781 url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
782 Net-DNS-&Net-DNS-version;</ulink></para>
783
784 <itemizedlist>
785 <listitem>
786 <para id="perl-digest-hmac"><ulink
787 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
788 Digest-HMAC-&Digest-HMAC-version;</ulink></para>
789 <indexterm zone="perl-modules perl-digest-hmac">
790 <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
791 </indexterm>
792
793 <itemizedlist>
794 <listitem>
795 <para id="perl-digest-sha1"><ulink
796 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
797 Digest-SHA1-&Digest-SHA1-version;</ulink></para>
798 <indexterm zone="perl-modules perl-digest-sha1">
799 <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
800 </indexterm>
801 </listitem>
802 </itemizedlist>
803
804 </listitem>
805 <listitem>
806 <para id="perl-net-ip"><ulink
807 url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
808 Net-IP-&Net-IP-version;</ulink></para>
809 <indexterm zone="perl-modules perl-net-ip">
810 <primary sortas="g-Net-IP">Net::IP</primary>
811 </indexterm>
812 </listitem>
813 <listitem>
814 <para id="perl-io-socket-inet6"><ulink
815 url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
816 IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
817 IPv6 support)</para>
818 <indexterm zone="perl-modules perl-io-socket-inet6">
819 <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
820 </indexterm>
821
822 <itemizedlist>
823 <listitem>
824 <para id="perl-socket6"><ulink
825 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
826 Socket6-&Socket6-version;</ulink></para>
827 <indexterm zone="perl-modules perl-socket6">
828 <primary sortas="g-Socket6">Socket6</primary>
829 </indexterm>
830 </listitem>
831 </itemizedlist>
832
833 </listitem>
834 <listitem>
835 <para id="perl-digest-bubblebabble"><ulink
836 url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
837 Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink>
838 (optional, only used during the test suite)</para>
839 <indexterm zone="perl-modules perl-digest-bubblebabble">
840 <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
841 </indexterm>
842 </listitem>
843 </itemizedlist>
844
845 </listitem>
846 </itemizedlist>
847
848 <!-- SGMLSpm -->
849 <bridgehead renderas="sect3" id="perl-sgmlspm"
850 xreflabel="SGMLSpm-&SGMLSpm-version;">
851 SGMLSpm-&SGMLSpm-version;</bridgehead>
852
853 <indexterm zone="perl-modules perl-sgmlspm">
854 <primary sortas="g-SGMLSpm">SGMLSpm</primary>
855 </indexterm>
856
857 <para>The SGMLSpm module is a <application>Perl</application> library
858 used for parsing the output from James Clark's SGMLS and NSGMLS
859 parsers. This module requires modified installation instructions, shown
860 below.</para>
861
862 <itemizedlist spacing='compact'>
863 <listitem>
864 <para><ulink
865 url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
866 SGMLSpm-&SGMLSpm-version;</ulink></para>
867 </listitem>
868 </itemizedlist>
869
870 <para>If your system's <application>Perl</application> version is different
871 than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
872 command below to reflect the version you have installed.</para>
873
874<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
875 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
876 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
877 Makefile</userinput></screen>
878
879 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
880
881<screen role="root"><userinput>make install &amp;&amp;
882install -v -m755 -d /usr/share/doc/perl5 &amp;&amp;
883make install_html &amp;&amp;
884rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
885install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
886
887 <!-- Test::Pod -->
888 <bridgehead renderas="sect3" id="perl-test-pod"
889 xreflabel="Test::Pod-&Test-Pod-version;">
890 Test::Pod-&Test-Pod-version;</bridgehead>
891
892 <indexterm zone="perl-modules perl-test-pod">
893 <primary sortas="g-Test-Pod">Test::Pod</primary>
894 </indexterm>
895
896 <para>The Test:Pod module is (most of the time, optionally) used by other
897 modules during the build process to check the validity of POD (Plain Old
898 Documentation) files. The Test::Pod module is typically included by module
899 authors to automatically find and check all POD files in a module
900 distribution. This module and all the dependencies can be installed using
901 the standard <application>Perl</application> Module
902 <xref linkend="perl-standard-install"/>.</para>
903
904 <itemizedlist spacing='compact'>
905 <listitem>
906 <para><ulink
907 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
908 Test-Pod-&Test-Pod-version;</ulink></para>
909
910 <itemizedlist>
911 <listitem>
912 <para id="perl-pod-simple"><ulink
913 url="http://cpan.org/authors/id/A/AR/ARANDAL/Pod-Simple-&Pod-Simple-version;.tar.gz">
914 Pod-Simple-&Pod-Simple-version;</ulink></para>
915 <indexterm zone="perl-modules perl-pod-simple">
916 <primary sortas="g-Pod-Simple">Pod::Simple</primary>
917 </indexterm>
918
919 <itemizedlist>
920 <listitem>
921 <para id="perl-pod-escapes"><ulink
922 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
923 Pod-Escapes-&Pod-Escapes-version;</ulink></para>
924 <indexterm zone="perl-modules perl-pod-escapes">
925 <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
926 </indexterm>
927 </listitem>
928 </itemizedlist>
929
930 </listitem>
931 <listitem>
932 <para><xref linkend="perl-test-simple"/></para>
933 </listitem>
934 </itemizedlist>
935
936 </listitem>
937 </itemizedlist>
938
939 <!-- Test::Simple -->
940 <bridgehead renderas="sect3" id="perl-test-simple"
941 xreflabel="Test::Simple-&Test-Simple-version;">
942 Test::Simple-&Test-Simple-version;</bridgehead>
943
944 <indexterm zone="perl-modules perl-test-simple">
945 <primary sortas="g-Test-Simple">Test::Simple</primary>
946 </indexterm>
947
948 <para>The Test::Simple module contains utilities designed to assist
949 developers in creating tests. A version of Test::Simple was installed
950 during LFS with the <application>Perl</application>-&LFS-Perl-version;
951 installation, however, some of the sub-modules contained in Test::Simple
952 have been updated (notably, the Test::More module) and these updated
953 modules are now required by other modules. This updated version of
954 Test::Simple also now includes the Test:Builder:Tester module, required by
955 many of the modules on this page. Note that installing this updated
956 version of Test::Simple will overwrite some files from the original
957 <application>Perl</application> installation, but there's really nothing to
958 be alarmed about as these modules are only used by developers creating
959 tests, or for running the test suites during additional module
960 installations.</para>
961
962 <itemizedlist spacing='compact'>
963 <listitem>
964 <para><ulink
965 url="http://cpan.org/authors/id/M/MS/MSCHWERN/Test-Simple-&Test-Simple-version;.tar.gz">
966 Test-Simple-&Test-Simple-version;</ulink>
967 (<xref linkend="perl-standard-install"/>)</para>
968
969 <itemizedlist>
970 <listitem>
971 <para><xref linkend="perl-module-signature"/> (optionally used
972 during the tests)</para>
973 </listitem>
974 </itemizedlist>
975
976 </listitem>
977 </itemizedlist>
978
979 <!-- Text::Diff -->
980 <bridgehead renderas="sect3" id="perl-text-diff"
981 xreflabel="Text::Diff-&Text-Diff-version;">
982 Text::Diff-&Text-Diff-version;</bridgehead>
983
984 <indexterm zone="perl-modules perl-text-diff">
985 <primary sortas="g-Text-Diff">Text::Diff</primary>
986 </indexterm>
987
988 <para>Text::Diff is used to perform diffs on files and record sets. It
989 provides a basic set of services akin to the GNU <command>diff</command>
990 utility. It is not anywhere near as feature complete as GNU
991 <command>diff</command>, but it is better integrated with
992 <application>Perl</application> and available on all platforms. Text::Diff
993 is often faster than shelling out to a system's <command>diff</command>
994 executable for small files, and generally slower on larger files.</para>
995
996 <itemizedlist spacing='compact'>
997 <listitem>
998 <para><ulink
999 url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
1000 Text-Diff-&Text-Diff-version;</ulink></para>
1001
1002 <itemizedlist>
1003 <listitem>
1004 <para id="perl-algorithm-diff"><ulink
1005 url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.zip">
1006 Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
1007 <indexterm zone="perl-modules perl-algorithm-diff">
1008 <primary sortas="g-Algorithm-Diff">Algorithm::Diff</primary>
1009 </indexterm>
1010
1011 <itemizedlist>
1012 <listitem>
1013 <para><xref linkend="unzip"/></para>
1014 </listitem>
1015 </itemizedlist>
1016
1017 </listitem>
1018 </itemizedlist>
1019
1020 </listitem>
1021 </itemizedlist>
1022
1023 <!-- Tk -->
1024 <bridgehead renderas="sect3" id="tk-perl"
1025 xreflabel="Tk-Perl-&Tk-Perl-version;">
1026 Tk-&Tk-Perl-version;</bridgehead>
1027
1028 <indexterm zone="perl-modules tk-perl">
1029 <primary sortas="g-Tk">Tk</primary>
1030 </indexterm>
1031
1032 <para>The <application>Tk</application> module is a
1033 <application>Perl</application> interface to the
1034 <application>Tk</application> package. The goal of this release is Unicode
1035 support via <application>Perl</application>'s and
1036 core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
1037 builds and loads into a threaded <application>Perl</application> but is NOT
1038 yet thread safe. The module can be installed using the standard
1039 <application>Perl</application> Module
1040 <xref linkend="perl-standard-install"/>.</para>
1041
1042 <itemizedlist spacing='compact'>
1043 <listitem>
1044 <para><ulink
1045 url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Tk-Perl-version;.tar.gz">
1046 Tk-&Tk-Perl-version;</ulink></para>
1047
1048 <itemizedlist>
1049 <listitem>
1050 <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
1051 </listitem>
1052 </itemizedlist>
1053
1054 </listitem>
1055 </itemizedlist>
1056
1057 <!-- XML::Parser -->
1058 <bridgehead renderas="sect3" id="perl-xml-parser"
1059 xreflabel="XML::Parser-&XML-Parser-version;">
1060 XML::Parser-&XML-Parser-version;</bridgehead>
1061
1062 <indexterm zone="perl-modules perl-xml-parser">
1063 <primary sortas="g-XML-Parser">XML::Parser</primary>
1064 </indexterm>
1065
1066 <para>The XML::Parser module is a <application>Perl</application> extension
1067 interface to James Clark's XML parser,
1068 <application>expat</application>. The module can be installed using the
1069 standard <application>Perl</application> Module
1070 <xref linkend="perl-standard-install"/>.</para>
1071
1072 <itemizedlist spacing='compact'>
1073 <listitem>
1074 <para><ulink
1075 url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
1076 XML-Parser-&XML-Parser-version;</ulink></para>
1077
1078 <itemizedlist>
1079 <listitem>
1080 <para><xref linkend="expat"/></para>
1081 </listitem>
1082 </itemizedlist>
1083
1084 </listitem>
1085 </itemizedlist>
1086
1087 <!-- YAML -->
1088 <bridgehead renderas="sect3" id="perl-yaml"
1089 xreflabel="YAML-&YAML-version;">
1090 YAML-&YAML-version;</bridgehead>
1091
1092 <indexterm zone="perl-modules perl-yaml">
1093 <primary sortas="g-YAML">YAML</primary>
1094 </indexterm>
1095
1096 <para></para>
1097
1098 <itemizedlist spacing='compact'>
1099 <listitem>
1100 <para><ulink
1101 url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
1102 YAML-&YAML-version;</ulink></para>
1103
1104 <itemizedlist>
1105 <listitem>
1106 <para>Dependency list will be added</para>
1107 </listitem>
1108 </itemizedlist>
1109
1110 </listitem>
1111 </itemizedlist>
1112
1113 </sect2>
1114
1115 <sect2 role="installation" id="perl-standard-install"
1116 xreflabel="build and installation instructions">
1117 <title>Standard Installation of Perl Modules</title>
1118
1119 <para>Install <application>Perl</application> modules by running the
1120 following commands:</para>
1121
1122<screen><userinput>perl Makefile.PL &amp;&amp;
1123make &amp;&amp;
1124make test</userinput></screen>
1125
1126 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
1127
1128<screen role="root"><userinput>make install</userinput></screen>
1129
1130 </sect2>
1131
1132 <sect2 role="installation">
1133 <title>(Alternate) Auto Installation of Perl Modules.</title>
1134
1135 <para>There is an alternate way of installing the modules using
1136 <application>Perl</application>'s built-in <command>install</command>
1137 command. The command automatically downloads the source from the CPAN
1138 archive, extracts it, runs the commands mentioned above, and removes the
1139 build source tree. You may still need to install dependent library
1140 packages before running the automated installation method.</para>
1141
1142 <para>The first time you run this command, you'll be prompted to enter some
1143 information regarding download locations and methods. This information is
1144 retained in files located in <filename class='directory'>~/.cpan</filename>.
1145 Start the perl shell with the following command as the
1146 <systemitem class="username">root</systemitem> user:</para>
1147
1148<screen role="root"><userinput>perl -MCPAN -e shell</userinput></screen>
1149
1150 <para>Each module may now be installed from this shell with the
1151 command:</para>
1152
1153<screen role="root"><userinput>install <replaceable>[Module::Name]</replaceable></userinput></screen>
1154
1155 <para>For additional commands and help, type <command>help</command>.</para>
1156
1157 <para>Alternatively, for scripted or non-interactive installations, use the
1158 following syntax as the
1159 <systemitem class="username">root</systemitem> user:</para>
1160
1161<screen role="root"><userinput>perl -MCPAN -e 'install <replaceable>[Module::Name]</replaceable>'</userinput></screen>
1162
1163 </sect2>
1164
1165</sect1>
Note: See TracBrowser for help on using the repository browser.