source: general/prog/perl-modules.xml@ 831caa1f

10.0 10.1 11.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 831caa1f was 831caa1f, checked in by Randy McMurchy <randy@…>, 9 years ago

Modified the dependencies for the XML::Simple Perl Module instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10986 af4574ff-66df-0310-9fd7-8a98e5e911e0

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