source: general/prog/perl-modules.xml@ 254592b

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 254592b was 254592b, checked in by Ken Moffat <ken@…>, 11 years ago

Perl modules: index those in the book as a- (packages) instead of g- (others) - this matches the treatment of python modules. Start to tag for 7.4. SGMLSpm split into two paras with tag in the middle.

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