source: general/prog/perl-modules.xml@ 8e2f6669

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 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 gimp3 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/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 8e2f6669 was 8e2f6669, checked in by Randy McMurchy <randy@…>, 12 years ago

Updates to Perl Modules

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