source: general/prog/perl-modules.xml@ 0b9a7ab9

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 0b9a7ab9 was 0b9a7ab9, checked in by Randy McMurchy <randy@…>, 13 years ago

Removed Perl Module Module::Build as it is now a core module

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