source: general/prog/perl-modules.xml@ 603822fc

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

Updated various Perl Modules to current versions

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