source: general/prog/perl-modules.xml@ 624b17b

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 624b17b was 624b17b, checked in by Randy McMurchy <randy@…>, 13 years ago

Removed Perl Module Digest::SHA as it is now a core module

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@8725 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 46.3 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 </listitem>
487
488 <listitem>
489 <para><xref linkend="gnupg"/></para>
490 </listitem>
491 </itemizedlist>
492
493 </listitem>
494 </itemizedlist>
495
496 <!-- Net::DNS -->
497 <bridgehead renderas="sect3" id="perl-net-dns"
498 xreflabel="Net-DNS-&Net-DNS-version;">
499 Net::DNS-&Net-DNS-version;</bridgehead>
500
501 <indexterm zone="perl-modules perl-net-dns">
502 <primary sortas="g-Net-DNS">Net::DNS</primary>
503 </indexterm>
504
505 <para>Net::DNS is a DNS resolver implemented in
506 <application>Perl</application>. It can be used to perform nearly any type
507 of DNS query from a <application>Perl</application> script. The Net::DNS
508 module and all its dependencies are installed using the standard
509 <application>Perl</application> module
510 <xref linkend="perl-standard-install"/>.</para>
511
512 <itemizedlist spacing='compact'>
513 <listitem>
514 <para><ulink
515 url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
516 Net-DNS-&Net-DNS-version;</ulink></para>
517
518 <itemizedlist>
519 <listitem>
520 <para id="perl-digest-hmac"><ulink
521 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
522 Digest-HMAC-&Digest-HMAC-version;</ulink></para>
523 <indexterm zone="perl-modules perl-digest-hmac">
524 <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
525 </indexterm>
526
527 <itemizedlist>
528 <listitem>
529 <para id="perl-digest-sha1"><ulink
530 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
531 Digest-SHA1-&Digest-SHA1-version;</ulink></para>
532 <indexterm zone="perl-modules perl-digest-sha1">
533 <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
534 </indexterm>
535 </listitem>
536 </itemizedlist>
537
538 </listitem>
539 <listitem>
540 <para id="perl-net-ip"><ulink
541 url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
542 Net-IP-&Net-IP-version;</ulink></para>
543 <indexterm zone="perl-modules perl-net-ip">
544 <primary sortas="g-Net-IP">Net::IP</primary>
545 </indexterm>
546 </listitem>
547 <listitem>
548 <para id="perl-io-socket-inet6"><ulink
549 url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
550 IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
551 IPv6 support)</para>
552 <indexterm zone="perl-modules perl-io-socket-inet6">
553 <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
554 </indexterm>
555
556 <itemizedlist>
557 <listitem>
558 <para id="perl-socket6"><ulink
559 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
560 Socket6-&Socket6-version;</ulink></para>
561 <indexterm zone="perl-modules perl-socket6">
562 <primary sortas="g-Socket6">Socket6</primary>
563 </indexterm>
564 </listitem>
565 </itemizedlist>
566
567 </listitem>
568 <listitem>
569 <para id="perl-digest-bubblebabble"><ulink
570 url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
571 Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink></para>
572 <indexterm zone="perl-modules perl-digest-bubblebabble">
573 <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
574 </indexterm>
575 </listitem>
576 <listitem>
577 <para><xref linkend="perl-test-pod"/> (optional, only used during the test suite)</para>
578 </listitem>
579 </itemizedlist>
580
581 </listitem>
582 </itemizedlist>
583
584
585 <!-- Pod::Coverage -->
586 <bridgehead renderas="sect3" id="perl-pod-coverage"
587 xreflabel="Pod::Coverage-&Pod-Coverage-version;">
588 Pod::Coverage-&Pod-Coverage-version;</bridgehead>
589
590 <indexterm zone="perl-modules perl-pod-coverage">
591 <primary sortas="g-Pod-Coverage">Pod::Coverage</primary>
592 </indexterm>
593
594 <para>The Pod::Coverage module is a <application>Perl</application> library
595 used to check if the documentation of a module is comprehensive. All the
596 dependencies are installed using the standard
597 <application>Perl</application> module
598 <xref linkend="perl-standard-install"/>.</para>
599
600 <itemizedlist spacing='compact'>
601 <listitem>
602 <para><ulink
603 url="http://www.cpan.org/authors/id/R/RC/RCLAMP/Pod-Coverage-&Pod-Coverage-version;.tar.gz">
604 Pod-Coverage-&Pod-Coverage-version;</ulink></para>
605
606 <itemizedlist>
607 <listitem>
608 <para id="perl-devel-symdump"><ulink
609 url="http://www.cpan.org/authors/id/A/AN/ANDK/Devel-Symdump-&Devel-Symdump-version;.tar.gz">
610 Devel-Symdump-&Devel-Symdump-version;</ulink></para>
611 <indexterm zone="perl-modules perl-devel-symdump">
612 <primary sortas="g-Devel-Symdump">Devel::Symdump</primary>
613 </indexterm>
614
615 <itemizedlist>
616 <listitem>
617 <para><xref linkend="perl-test-pod-coverage"/>
618 (optionally used during the tests, and is a circular
619 dependency)</para>
620 </listitem>
621 <listitem>
622 <para><xref linkend="perl-test-pod"/>
623 (optionally used during the tests)</para>
624 </listitem>
625 </itemizedlist>
626
627 </listitem>
628 </itemizedlist>
629
630 </listitem>
631 </itemizedlist>
632
633 <!-- SGMLSpm -->
634 <bridgehead renderas="sect3" id="perl-sgmlspm"
635 xreflabel="SGMLSpm-&SGMLSpm-version;">
636 SGMLSpm-&SGMLSpm-version;</bridgehead>
637
638 <indexterm zone="perl-modules perl-sgmlspm">
639 <primary sortas="g-SGMLSpm">SGMLSpm</primary>
640 </indexterm>
641
642 <para>The SGMLSpm module is a <application>Perl</application> library
643 used for parsing the output from James Clark's SGMLS and NSGMLS
644 parsers. This module requires modified installation instructions, shown
645 below.</para>
646
647 <itemizedlist spacing='compact'>
648 <listitem>
649 <para><ulink
650 url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
651 SGMLSpm-&SGMLSpm-version;</ulink></para>
652 </listitem>
653 </itemizedlist>
654
655 <para>If your system's <application>Perl</application> version is different
656 than &lfs-perl-version;, you'll need to modify the <command>sed</command>
657 command below to reflect the version you have installed.</para>
658
659<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
660 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&lfs-perl-version;@" \
661 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
662 Makefile</userinput></screen>
663
664 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
665
666<screen role="root"><userinput>make install &amp;&amp;
667install -v -m755 -d /usr/share/doc/perl5 &amp;&amp;
668make install_html &amp;&amp;
669rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
670install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
671
672 <!-- Test::Pod -->
673 <bridgehead renderas="sect3" id="perl-test-pod"
674 xreflabel="Test::Pod-&Test-Pod-version;">
675 Test::Pod-&Test-Pod-version;</bridgehead>
676
677 <indexterm zone="perl-modules perl-test-pod">
678 <primary sortas="g-Test-Pod">Test::Pod</primary>
679 </indexterm>
680
681 <para>The Test:Pod module is (most of the time, optionally) used by other
682 modules during the build process to check the validity of POD (Plain Old
683 Documentation) files. The Test::Pod module is typically included by module
684 authors to automatically find and check all POD files in a module
685 distribution. This module is installed using the standard
686 <application>Perl</application> module
687 <xref linkend="perl-standard-install"/>.</para>
688
689 <itemizedlist spacing='compact'>
690 <listitem>
691 <para><ulink
692 url="http://www.cpan.org/authors/id/D/DW/DWHEELER/Test-Pod-&Test-Pod-version;.tar.gz">
693 Test-Pod-&Test-Pod-version;</ulink></para>
694 </listitem>
695 </itemizedlist>
696
697 <!-- Test::Pod::Coverage -->
698 <bridgehead renderas="sect3" id="perl-test-pod-coverage"
699 xreflabel="Test::Pod::Coverage-&Test-Pod-Coverage-version;">
700 Test::Pod::Coverage-&Test-Pod-Coverage-version;</bridgehead>
701
702 <indexterm zone="perl-modules perl-test-pod-coverage">
703 <primary sortas="g-Test-Pod-Coverage">Test::Pod::Coverage</primary>
704 </indexterm>
705
706 <para>The Test::Pod::Coverage module is used to check files in a
707 distribution for POD coverage. It is normally used by developers to
708 ensure their projects are adequately covered with POD and it is also used
709 in the test suites of many module distributions. This module and the
710 dependency are installed using the standard
711 <application>Perl</application> module
712 <xref linkend="perl-standard-install"/>.</para>
713
714 <itemizedlist spacing='compact'>
715 <listitem>
716 <para><ulink
717 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-Coverage-&Test-Pod-Coverage-version;.tar.gz">
718 Test-Pod-Coverage-&Test-Pod-Coverage-version;</ulink></para>
719
720 <itemizedlist>
721 <listitem>
722 <para><xref linkend="perl-pod-coverage"/></para>
723 </listitem>
724 </itemizedlist>
725
726 </listitem>
727 </itemizedlist>
728
729 <!-- Text::Diff -->
730 <bridgehead renderas="sect3" id="perl-text-diff"
731 xreflabel="Text::Diff-&Text-Diff-version;">
732 Text::Diff-&Text-Diff-version;</bridgehead>
733
734 <indexterm zone="perl-modules perl-text-diff">
735 <primary sortas="g-Text-Diff">Text::Diff</primary>
736 </indexterm>
737
738 <para>Text::Diff is used to perform diffs on files and record sets. It
739 provides a basic set of services akin to the GNU <command>diff</command>
740 utility. It is not anywhere near as feature complete as GNU
741 <command>diff</command>, but it is better integrated with
742 <application>Perl</application> and available on all platforms. Text::Diff
743 is often faster than shelling out to a system's <command>diff</command>
744 executable for small files, and generally slower on larger files. The
745 modules listed below are installed using the standard
746 <application>Perl</application> module
747 <xref linkend="perl-standard-install"/>.</para>
748
749 <itemizedlist spacing='compact'>
750 <listitem>
751 <para><ulink
752 url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
753 Text-Diff-&Text-Diff-version;</ulink></para>
754
755 <itemizedlist>
756 <listitem>
757 <para id="perl-algorithm-diff"><ulink
758 url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.tar.gz">
759 Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
760 <indexterm zone="perl-modules perl-algorithm-diff">
761 <primary sortas="g-Algorithm-Diff">Algorithm::Diff</primary>
762 </indexterm>
763 </listitem>
764 </itemizedlist>
765
766 </listitem>
767 </itemizedlist>
768
769 <!-- Tk -->
770 <bridgehead renderas="sect3" id="tk-perl"
771 xreflabel="Tk-Perl-&Tk-Perl-version;">
772 Tk-&Tk-Perl-version;</bridgehead>
773
774 <indexterm zone="perl-modules tk-perl">
775 <primary sortas="g-Tk">Tk</primary>
776 </indexterm>
777
778 <para>The <application>Tk</application> module is a
779 <application>Perl</application> interface to the
780 <application>Tk</application> package. The goal of this release is Unicode
781 support via <application>Perl</application>'s and
782 core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
783 builds and loads into a threaded <application>Perl</application> but is NOT
784 yet thread safe. The module is installed using the standard
785 <application>Perl</application> module
786 <xref linkend="perl-standard-install"/>.</para>
787
788 <itemizedlist spacing='compact'>
789 <listitem>
790 <para><ulink
791 url="http://www.cpan.org/authors/id/S/SR/SREZIC/Tk-&Tk-Perl-version;.tar.gz">
792 Tk-&Tk-Perl-version;</ulink></para>
793
794 <itemizedlist>
795 <listitem>
796 <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
797 </listitem>
798 </itemizedlist>
799
800 </listitem>
801 </itemizedlist>
802
803 <!-- URI -->
804 <bridgehead renderas="sect3" id="perl-uri"
805 xreflabel="URI-&URI-version;">
806 URI-&URI-version;</bridgehead>
807
808 <indexterm zone="perl-modules perl-uri">
809 <primary sortas="g-URI">URI</primary>
810 </indexterm>
811
812 <para>The URI module implements the URI class. Objects of this class
813 represent Uniform Resource Identifier references as specified in
814 RFC 2396 and updated by RFC 2732 and can be used to access and
815 manipulate the various components that make up these strings.
816 The URI module and all its dependencies are installed using
817 the standard <xref linkend="perl-standard-install"/>.</para>
818
819 <itemizedlist spacing='compact'>
820 <listitem>
821 <para><ulink
822 url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
823 URI-&URI-version;</ulink></para>
824 <indexterm zone="perl-modules perl-uri">
825 <primary sortas="g-URI">URI</primary>
826 </indexterm>
827 <itemizedlist>
828 <listitem>
829 <para id="perl-business-isbn"><ulink
830 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
831 Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
832 used during the test suite)</para>
833 <indexterm zone="perl-modules perl-business-isbn">
834 <primary sortas="g-Business-ISBN">Business::ISBN</primary>
835 </indexterm>
836
837 <itemizedlist>
838 <listitem>
839 <para>LWP::Simple is required for many of the tests. This
840 is a circular dependency.</para>
841 </listitem>
842 <listitem>
843 <para id="perl-business-isbn-data"><ulink
844 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
845 Business-ISBN-Data-&Business-ISBN-Data-version;</ulink></para>
846 <indexterm zone="perl-modules perl-business-isbn-data">
847 <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
848 </indexterm>
849
850 <itemizedlist>
851 <listitem>
852 <para id="perl-test-prereq"><ulink
853 url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
854 Test-Prereq-&Test-Prereq-version;</ulink> (you may need
855 to set up your CPAN access parameters by issuing the
856 command <command>perl -MCPAN -e shell</command> before
857 running the test suite, else the tests may hang)</para>
858 <indexterm zone="perl-modules perl-test-prereq">
859 <primary sortas="g-Test-Prereq">Test::Prereq</primary>
860 </indexterm>
861
862 <itemizedlist>
863 <listitem>
864 <para><xref linkend="perl-module-info"/></para>
865 </listitem>
866 <listitem>
867 <para id="perl-module-corelist"><ulink
868 url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
869 Module-CoreList-&Module-Corelist-version;</ulink></para>
870 <indexterm zone="perl-modules perl-module-corelist">
871 <primary sortas="g-Module-Corelist">Module::Corelist</primary>
872 </indexterm>
873 <itemizedlist>
874 <listitem>
875 <para><xref linkend="perl-test-pod"/>
876 (optionally used during the tests)</para>
877 </listitem>
878 </itemizedlist>
879
880 </listitem>
881 </itemizedlist>
882
883 </listitem>
884 <listitem>
885 <para><xref linkend="perl-test-pod-coverage"/>
886 (optionally used during the tests)</para>
887 </listitem>
888 </itemizedlist>
889
890 </listitem>
891 </itemizedlist>
892
893 </listitem>
894 </itemizedlist>
895
896 </listitem>
897 </itemizedlist>
898
899 <!-- XML::Parser -->
900 <bridgehead renderas="sect3" id="perl-xml-parser"
901 xreflabel="XML::Parser-&XML-Parser-version;">
902 XML::Parser-&XML-Parser-version;</bridgehead>
903
904 <indexterm zone="perl-modules perl-xml-parser">
905 <primary sortas="g-XML-Parser">XML::Parser</primary>
906 </indexterm>
907
908 <para>The XML::Parser module is a <application>Perl</application> extension
909 interface to James Clark's XML parser,
910 <application>expat</application>. The module is installed using the
911 standard <application>Perl</application> module
912 <xref linkend="perl-standard-install"/>.</para>
913
914 <itemizedlist spacing='compact'>
915 <listitem>
916 <para><ulink
917 url="http://www.cpan.org/authors/id/C/CH/CHORNY/XML-Parser-&XML-Parser-version;.tar.gz">
918 XML-Parser-&XML-Parser-version;</ulink></para>
919
920 <itemizedlist>
921 <listitem>
922 <para><xref linkend="expat"/></para>
923 </listitem>
924 </itemizedlist>
925 <itemizedlist>
926 <listitem>
927 <para><xref linkend="perl-lwp"/>
928 (optionally used during the tests)</para>
929 </listitem>
930 </itemizedlist>
931
932 </listitem>
933 </itemizedlist>
934
935 <!-- XML::Simple -->
936 <bridgehead renderas="sect3" id="perl-xml-simple"
937 xreflabel="XML::Simple-&XML-Simple-version;">
938 XML::Simple-&XML-Simple-version;</bridgehead>
939
940 <indexterm zone="perl-modules perl-xml-simple">
941 <primary sortas="g-XML-Simple">XML::Simple</primary>
942 </indexterm>
943
944 <para>The XML::Simple module is a <application>Perl</application> extension
945 that provides an easy API to read and write XML (especially config files).
946 The module and all dependencies are installed using the standard
947 <application>Perl</application> module
948 <xref linkend="perl-standard-install"/>.</para>
949
950 <itemizedlist spacing='compact'>
951 <listitem>
952 <para><ulink
953 url="http://cpan.org/authors/id/G/GR/GRANTM/XML-Simple-&XML-Simple-version;.tar.gz">
954 XML-Simple-&XML-Simple-version;</ulink></para>
955
956 <itemizedlist>
957 <listitem>
958 <para>One of the following four modules must be installed:</para>
959
960 <itemizedlist>
961 <listitem>
962 <para id="perl-xml-sax"><ulink
963 url="http://cpan.org/authors/id/G/GR/GRANTM/XML-SAX-&XML-SAX-version;.tar.gz">
964 XML-SAX-&XML-SAX-version;</ulink></para>
965 <indexterm zone="perl-modules perl-xml-sax">
966 <primary sortas="g-XML-SAX">XML::SAX</primary>
967 </indexterm>
968
969 <itemizedlist>
970 <listitem>
971 <para id="perl-xml-namespacesupport"><ulink
972 url="http://cpan.org/authors/id/R/RB/RBERJON/XML-NamespaceSupport-&XML-NamespaceSupport-version;.tar.gz">
973 XML-NamespaceSupport-&XML-NamespaceSupport-version;</ulink></para>
974 <indexterm zone="perl-modules perl-xml-namespacesupport">
975 <primary sortas="g-XML-NamespaceSupport">XML::NamespaceSupport</primary>
976 </indexterm>
977 </listitem>
978 </itemizedlist>
979
980 </listitem>
981 <listitem>
982 <para id="perl-xml-sax-expat"><ulink
983 url="http://cpan.org/authors/id/B/BJ/BJOERN/XML-SAX-Expat-&XML-SAX-Expat-version;.tar.gz">
984 XML-SAX-Expat-&XML-SAX-Expat-version;</ulink></para>
985 <indexterm zone="perl-modules perl-xml-sax-expat">
986 <primary sortas="g-XML-SAX-Expat">XML::SAX::Expat</primary>
987 </indexterm>
988 </listitem>
989 <listitem>
990 <para id="perl-xml-libxml"><ulink
991 url="http://cpan.org/authors/id/P/PA/PAJAS/XML-LibXML-&XML-LibXML-version;.tar.gz">
992 XML-LibXML-&XML-LibXML-version;</ulink></para>
993 <indexterm zone="perl-modules perl-xml-libxml">
994 <primary sortas="g-XML-LibXML">XML::LibXML</primary>
995 </indexterm>
996 </listitem>
997 <listitem>
998 <para><xref linkend="perl-xml-parser"/></para>
999 </listitem>
1000 </itemizedlist>
1001
1002 </listitem>
1003 <listitem>
1004 <para id="perl-tie-ixhash"><ulink
1005 url="http://cpan.org/authors/id/G/GS/GSAR/Tie-IxHash-&Tie-IxHash-version;.tar.gz">
1006 Tie-IxHash-&Tie-IxHash-version;</ulink></para>
1007 <indexterm zone="perl-modules perl-tie-ixhash">
1008 <primary sortas="g-Tie-IxHash">Tie::IxHash</primary>
1009 </indexterm>
1010 </listitem>
1011 </itemizedlist>
1012
1013 </listitem>
1014 </itemizedlist>
1015
1016 <!-- YAML -->
1017 <bridgehead renderas="sect3" id="perl-yaml"
1018 xreflabel="YAML-&YAML-version;">
1019 YAML-&YAML-version;</bridgehead>
1020
1021 <indexterm zone="perl-modules perl-yaml">
1022 <primary sortas="g-YAML">YAML</primary>
1023 </indexterm>
1024
1025 <para>The <application>YAML</application> modules implement a
1026 <application>YAML</application> Loader and Dumper based on the
1027 <application>YAML</application> 1.0 specification
1028 <ulink url="http://www.yaml.org/spec/"/>.
1029 <application>YAML</application> is a generic data serialization language
1030 that is optimized for human readability. It can be used to express the data
1031 structures of most modern programming languages. The module and
1032 dependencies are installed using the standard
1033 <application>Perl</application> module
1034 <xref linkend="perl-standard-install"/>.</para>
1035
1036 <note>
1037 <para>The <application>YAML</application>,
1038 <application>Test::Base</application> and
1039 <application>Spiffy</application> modules will install UTF-8
1040 encoded manual pages. To modify the manual pages so that non-UTF-8
1041 encoded pages are installed, issue the following commands (before
1042 any other build commands):</para>
1043
1044<screen><literal>For <application>Spiffy</application>: <command>sed -i 's,\xc3\xb6,o,' lib/Spiffy.pm</command>
1045
1046For <application>Test::Base</application>: <command>sed -i 's,\xc3\xb6,o,' \
1047 lib/Test/Base{,/Filter}.pm \
1048 lib/Module/Install/TestBase.pm</command>
1049
1050For <application>YAML</application>: <command>sed -i 's,\xc3\xb6,o,' \
1051 ysh \
1052 lib{,/Test}/YAML.pm \
1053 lib/YAML/{Types,Node,Error,Marshall,Tag,Base}.pm \
1054 lib/YAML/{Loader,Dumper}{,/Base}.pm</command></literal></screen>
1055
1056 </note>
1057
1058 <itemizedlist spacing='compact'>
1059 <listitem>
1060 <para><ulink
1061 url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
1062 YAML-&YAML-version;</ulink></para>
1063
1064 <itemizedlist>
1065 <listitem>
1066 <para id="perl-test-base"><ulink
1067 url="http://cpan.org/authors/id/I/IN/INGY/Test-Base-&Test-Base-version;.tar.gz">
1068 Test-Base-&Test-Base-version;</ulink>
1069 (optionally used during the tests)</para>
1070 <indexterm zone="perl-modules perl-test-base">
1071 <primary sortas="g-Test-Base">Test::Base</primary>
1072 </indexterm>
1073
1074 <itemizedlist>
1075 <listitem>
1076 <para id="perl-spiffy"><ulink
1077 url="http://cpan.org/authors/id/I/IN/INGY/Spiffy-&Spiffy-version;.tar.gz">
1078 Spiffy-&Spiffy-version;</ulink></para>
1079 <indexterm zone="perl-modules perl-spiffy">
1080 <primary sortas="g-Spiffy">Spiffy</primary>
1081 </indexterm>
1082 </listitem>
1083 </itemizedlist>
1084
1085 </listitem>
1086 <listitem>
1087 <para><xref linkend="perl-text-diff"/>
1088 (optionally used during the tests)</para>
1089 </listitem>
1090 </itemizedlist>
1091
1092 </listitem>
1093 </itemizedlist>
1094
1095 </sect2>
1096
1097 <sect2 role="installation" id="perl-standard-install"
1098 xreflabel="build and installation instructions">
1099 <title>Standard Installation of Perl Modules</title>
1100
1101 <para>Install <application>Perl</application> modules by running the
1102 following commands:</para>
1103
1104<screen><userinput>perl Makefile.PL &amp;&amp;
1105make &amp;&amp;
1106make test</userinput></screen>
1107
1108 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
1109
1110<screen role="root"><userinput>make install</userinput></screen>
1111
1112 <note>
1113
1114 <para>When reinstalling a <application>Perl</application> module,
1115 sometimes older versions of the module being reinstalled are in other
1116 directories specified in <parameter>@INC</parameter>. To delete all
1117 other versions of the module being reinstalled (not simply older ones)
1118 set the <varname>UNINST</varname> variable:</para>
1119
1120<screen><userinput>make install UNINST=1</userinput></screen>
1121 </note>
1122
1123 </sect2>
1124
1125 <sect2 role="installation">
1126 <title>(Alternate) Auto Installation of Perl Modules.</title>
1127
1128 <para>There is an alternate way of installing the modules using the
1129 <command>cpan</command> shell <command>install</command> command. The
1130 command automatically downloads the source from the CPAN archive, extracts
1131 it, runs the compilation, testing and installation commands mentioned
1132 above, and removes the build source tree. You may still need to install
1133 dependent library packages before running the automated installation
1134 method.</para>
1135
1136 <para>The first time you run <command>cpan</command>, you'll be prompted
1137 to enter some information regarding download locations and methods. This
1138 information is retained in files located in
1139 <filename class='directory'>~/.cpan</filename>. Start the
1140 <command>cpan</command> shell by issuing '<command>cpan</command>' as the
1141 <systemitem class="username">root</systemitem> user. Any module may now be
1142 installed from the
1143 <emphasis role='underlined'><prompt>cpan&gt;&nbsp;</prompt></emphasis>
1144 prompt with the command:</para>
1145
1146<screen role="root"><userinput>install <replaceable>&lt;Module::Name&gt;</replaceable></userinput></screen>
1147
1148 <para>For additional commands and help, issue '<command>help</command>'
1149 from the
1150 <emphasis role='underlined'><prompt>cpan&gt;&nbsp;</prompt></emphasis>
1151 prompt.</para>
1152
1153 <para>Alternatively, for scripted or non-interactive installations, use the
1154 following syntax as the
1155 <systemitem class="username">root</systemitem> user to install one or more
1156 modules:</para>
1157
1158<screen role="root"><userinput>cpan -i <replaceable>&lt;Module1::Name&gt; &lt;Module2::Name&gt;</replaceable></userinput></screen>
1159
1160 <para>Review the <filename>cpan.1</filename> man page for additional
1161 parameters you can pass to <command>cpan</command> on the command
1162 line.</para>
1163
1164 </sect2>
1165
1166</sect1>
Note: See TracBrowser for help on using the repository browser.