source: general/prog/perl-modules.xml@ 9f765338

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 9f765338 was 9f765338, checked in by Randy McMurchy <randy@…>, 18 years ago

Updated to the Module::Signature-0.51 Perl Module and singled it out in the instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5565 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 42.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY perl_modules_md5sums_download_http "http://anduin.linuxfromscratch.org/sources/BLFS/SVN/Perl_Modules/Perl_Modules.gz.md5sums">
8 <!ENTITY perl_modules_md5sums_download_ftp "ftp://anduin.linuxfromscratch.org/BLFS/SVN/Perl_Modules/Perl_Modules.gz.md5sums">
9]>
10
11<sect1 id="perl-modules" xreflabel="Perl modules">
12 <?dbhtml filename="perl-modules.html" ?>
13
14 <sect1info>
15 <othername>$LastChangedBy$</othername>
16 <date>$Date$</date>
17 </sect1info>
18
19 <title>Perl Modules</title>
20
21 <indexterm zone="perl-modules">
22 <primary sortas="a-Perl-modules">Perl modules</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Perl Modules</title>
27
28 <para>The <application>Perl</application> module packages add useful
29 objects to the <application>Perl</application> language. Modules utilized
30 by packages throughout BLFS are listed here, along with their dependencies.
31 Installation of the modules shown on this page should be accomplished by
32 installing the listed dependencies (from the bottom and working up to the
33 top) and then the desired module. Most references to
34 <application>Perl</application> modules are in the form of Module,
35 Module::SubName or Module::Sub::Name, though sometimes you'll see Module,
36 Module-SubName or Module-Sub-Name. The references on this page that reflect
37 an external URL are in the latter form, as these are the official package
38 names.</para>
39
40 <note>
41 <para>Some dependencies, such as the <xref linkend="perl-test-pod"/>
42 module, are used by several of the listed dependencies and perhaps also
43 the module being installed. Dependencies such as this are only listed
44 once in the dependency chain for each module to avoid redundancy and
45 additional clutter in the instructions.</para>
46 </note>
47
48 <!-- This section commented out now because the new organization of files
49 on the Anduin server do not include md5sums for the .tar.gz Perl
50 module sources
51
52 <itemizedlist spacing="compact">
53 <listitem>
54 <para>Download MD5 sums (HTTP):
55 <ulink url="&perl_modules_md5sums_download_http;"/></para>
56 </listitem>
57 <listitem>
58 <para>Download MD5 sums (FTP):
59 <ulink url="&perl_modules_md5sums_download_ftp;"/></para>
60 </listitem>
61 </itemizedlist>
62 -->
63
64 <!-- This is info for the Test::Builder::Tester module which may very well
65 be obsolete now. The packages that need it apparently also now need
66 Test::More-0.62 which is a core Perl module in an updated version. To
67 install the Test::More-0.62 version you must install the
68 Test::Simple-0.62 module which will overwrite the Perl core stuff.
69 The Test::Simple-0.62 module now includes the Test::Builder::Tester
70 module. Perl versions starting with Perl-5.9.x will have this module
71 include in the core at which time Test::Builder::Tester can be forever
72 removed from this page as it will then also be a core module.
73
74 <para id="perl-test-builder-tester"><ulink
75 url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
76 Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
77 <indexterm zone="perl-modules perl-test-builder-tester">
78 <primary sortas="g-Test-Builder-Tester">Test::Builder::Tester</primary>
79 </indexterm>
80 -->
81
82 <!-- Archive::Zip -->
83 <bridgehead renderas="sect3" id="perl-archive-zip"
84 xreflabel="Archive::Zip-&Archive-Zip-version;">
85 Archive::Zip-&Archive-Zip-version;</bridgehead>
86
87 <indexterm zone="perl-modules perl-archive-zip">
88 <primary sortas="g-Archive-Zip">Archive::Zip</primary>
89 </indexterm>
90
91 <para>The Archive::Zip module allows a <application>Perl</application>
92 program to create, manipulate, read, and write Zip archive files. The
93 two modules listed below can be installed using the
94 <application>Perl</application> module
95 <xref linkend="perl-standard-install"/>.</para>
96
97 <itemizedlist spacing='compact'>
98 <listitem>
99 <para><ulink
100 url="http://cpan.org/authors/id/S/SM/SMPETERS/Archive-Zip-&Archive-Zip-version;.tar.gz">
101 Archive-Zip-&Archive-Zip-version;</ulink></para>
102
103 <itemizedlist>
104 <listitem>
105 <para><xref linkend="perl-compress-zlib"/></para>
106 </listitem>
107 <listitem>
108 <para><xref linkend="perl-test-pod"/> (optionally used during the
109 tests)</para>
110 </listitem>
111 </itemizedlist>
112
113 </listitem>
114 </itemizedlist>
115
116 <!-- Compress::Zlib -->
117 <bridgehead renderas="sect3" id="perl-compress-zlib"
118 xreflabel="Compress::Zlib-&Compress-Zlib-version;">
119 Compress::Zlib-&Compress-Zlib-version;</bridgehead>
120
121 <indexterm zone="perl-modules perl-compress-zlib">
122 <primary sortas="g-Compress-Zlib">Compress::Zlib</primary>
123 </indexterm>
124
125 <para>The Compress::Zlib module provides a <application>Perl</application>
126 interface to the <application>Zlib</application> compression library. Most
127 of the functionality provided by <application>Zlib</application> is
128 available in Compress::Zlib. The module can be split into two general areas
129 of functionality, namely in-memory compression/decompression and read/write
130 access to gzip files.</para>
131
132 <note>
133 <para>The Compress::Zlib module requires the following
134 <command>sed</command> after untarring the distribution tarball (before
135 any other build commands) to use the system-installed copy of
136 <application>Zlib</application>.</para>
137
138<screen><userinput>sed -i -e "s|BUILD_ZLIB = True|BUILD_ZLIB = False|" \
139 -e "s|INCLUDE = ./zlib-src|INCLUDE = /usr/include|" \
140 -e "s|LIB = ./zlib-src|LIB = /usr/lib|" \
141 config.in</userinput></screen>
142 </note>
143
144 <itemizedlist spacing='compact'>
145 <listitem>
146 <para><ulink
147 url="http://cpan.org/authors/id/P/PM/PMQS/Compress-Zlib-&Compress-Zlib-version;.tar.gz">
148 Compress-Zlib-&Compress-Zlib-version;</ulink>
149 (<xref linkend="perl-standard-install"/>)</para>
150 </listitem>
151 </itemizedlist>
152
153 <!-- Date::Manip -->
154 <bridgehead renderas="sect3" id="perl-date-manip"
155 xreflabel="Date::Manip-&DateManip-version;">
156 Date::Manip-&DateManip-version;</bridgehead>
157
158 <indexterm zone="perl-modules perl-date-manip">
159 <primary sortas="g-Date-Manip">Date::Manip</primary>
160 </indexterm>
161
162 <para>Date::Manip is a set of routines designed to make any common
163 date/time manipulation easy to do. Operations such as comparing two times,
164 calculating a time a given amount of time from another, or parsing
165 international times are all easily done. From the very beginning, the
166 main focus of Date::Manip has been to be able to do ANY desired date/time
167 operation easily.</para>
168
169 <itemizedlist spacing='compact'>
170 <listitem>
171 <para><ulink
172 url="http://cpan.org/authors/id/S/SB/SBECK/DateManip-&DateManip-version;.tar.gz">
173 DateManip-&DateManip-version;</ulink>
174 (<xref linkend="perl-standard-install"/>)</para>
175 </listitem>
176 </itemizedlist>
177
178 <!-- Finance::Quote -->
179 <bridgehead renderas="sect3" id="perl-finance-quote"
180 xreflabel="Finance::Quote-&Finance-Quote-version;">
181 Finance::Quote-&Finance-Quote-version;</bridgehead>
182
183 <indexterm zone="perl-modules perl-finance-quote">
184 <primary sortas="g-Finance-Quote">Finance::Quote</primary>
185 </indexterm>
186
187 <para>Finance::Quote is used to get stock quotes from various Internet
188 sources, including Yahoo! Finance, Fidelity Investments, and the Australian
189 Stock Exchange. There are two methods of using this module &ndash; a
190 functional interface that is depreciated, and an object-orientated method
191 that provides greater flexibility and stability. With the exception of
192 straight currency exchange rates, all information is returned as a
193 two-dimensional hash (or a reference to such a hash, if called in a scalar
194 context).</para>
195
196 <para>After you've installed the package, issue
197 <command>perldoc Finance::Quote</command> for full information.
198 Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
199 after unpacking the distribution tarball and changing into the top-level
200 directory. The module and dependencies can be installed using the
201 <application>Perl</application> module
202 <xref linkend="perl-standard-install"/>.</para>
203
204 <note>
205 <para>To run the regression test suite, you'll need to create a
206 symbolic link to the <filename class='directory'>test</filename>
207 directory using the following command after unpacking the tarball
208 and changing into the root directory of the sources:</para>
209
210<screen><userinput>ln -s test t</userinput></screen>
211
212 <para>Some tests will fail depending on certain conditions. See the
213 <filename>INSTALL</filename> file for full details.</para>
214 </note>
215
216 <itemizedlist spacing='compact'>
217 <listitem>
218 <para><ulink
219 url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
220 Finance-Quote-&Finance-Quote-version;</ulink></para>
221
222 <itemizedlist>
223 <listitem>
224 <para><xref linkend="perl-html-tableextract"/></para>
225 </listitem>
226 <listitem>
227 <para><xref linkend="perl-lwp"/></para>
228 </listitem>
229 </itemizedlist>
230
231 </listitem>
232 </itemizedlist>
233
234 <!-- Finance::QuoteHist -->
235 <bridgehead renderas="sect3" id="perl-finance-quotehist"
236 xreflabel="Finance::QuoteHist-&Finance-QuoteHist-version;">
237 Finance::QuoteHist-&Finance-QuoteHist-version;</bridgehead>
238
239 <indexterm zone="perl-modules perl-finance-quotehist">
240 <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
241 </indexterm>
242
243 <para>The Finance::QuoteHist bundle is several modules designed to fetch
244 historical stock quotes from the web. The module and dependencies can be
245 installed using the <application>Perl</application> module
246 <xref linkend="perl-standard-install"/>.</para>
247
248 <itemizedlist spacing='compact'>
249 <listitem>
250 <para><ulink
251 url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
252 Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
253
254 <itemizedlist>
255 <listitem>
256 <para><xref linkend="perl-html-tableextract"/></para>
257 </listitem>
258 <listitem>
259 <para><xref linkend="perl-lwp"/></para>
260 </listitem>
261 <listitem>
262 <para><xref linkend="perl-date-manip"/></para>
263 </listitem>
264 <listitem>
265 <para id="perl-text-csv_xs"><ulink
266 url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
267 Text-CSV_XS-&Text-CSV_XS-version;</ulink></para>
268 <indexterm zone="perl-modules perl-text-csv_xs">
269 <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
270 </indexterm>
271 </listitem>
272 </itemizedlist>
273
274 </listitem>
275 </itemizedlist>
276
277 <!-- HTML::Parser -->
278 <bridgehead renderas="sect3" id="perl-html-parser"
279 xreflabel="HTML::Parser-&HTML-Parser-version;">
280 HTML::Parser-&HTML-Parser-version;</bridgehead>
281
282 <indexterm zone="perl-modules perl-html-parser">
283 <primary sortas="g-HTML-Parser">HTML::Parser</primary>
284 </indexterm>
285
286 <para>The HTML::Parser distribution is a collection of modules that parse
287 and extract information from HTML documents. In order to use the included
288 HTML::HeadParser module, you will also need to install
289 <xref linkend="perl-lwp"/>. The two modules listed below can be installed
290 using the <application>Perl</application> Module
291 <xref linkend="perl-standard-install"/>.</para>
292
293 <itemizedlist spacing='compact'>
294 <listitem>
295 <para><ulink
296 url="http://cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
297 HTML-Parser-&HTML-Parser-version;</ulink></para>
298
299 <itemizedlist>
300 <listitem>
301 <para id="perl-html-tagset"><ulink
302 url="http://cpan.org/authors/id/P/PE/PETDANCE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
303 HTML-Tagset-&HTML-Tagset-version;</ulink></para>
304 <indexterm zone="perl-modules perl-html-tagset">
305 <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
306 </indexterm>
307
308 <itemizedlist>
309 <listitem>
310 <para><xref linkend="perl-test-pod"/> (optionally used during the
311 tests)</para>
312 </listitem>
313 </itemizedlist>
314
315 </listitem>
316 </itemizedlist>
317
318 </listitem>
319 </itemizedlist>
320
321 <!-- HTML::TableExtract -->
322 <bridgehead renderas="sect3" id="perl-html-tableextract"
323 xreflabel="HTML::TableExtract-&HTML-TableExtract-version;">
324 HTML::TableExtract-&HTML-TableExtract-version;</bridgehead>
325
326 <indexterm zone="perl-modules perl-html-tableextract">
327 <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary>
328 </indexterm>
329
330 <para></para>
331
332 <itemizedlist spacing='compact'>
333 <listitem>
334 <para><ulink
335 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
336 HTML-TableExtract-&HTML-TableExtract-version;</ulink></para>
337
338 <itemizedlist>
339 <listitem>
340 <para><xref linkend="perl-html-parser"/></para>
341 </listitem>
342 </itemizedlist>
343
344 </listitem>
345 </itemizedlist>
346
347 <!-- LWP -->
348 <bridgehead renderas="sect3" id="perl-lwp"
349 xreflabel="LWP-&LWP-version;">
350 LWP-&LWP-version;</bridgehead>
351
352 <indexterm zone="perl-modules perl-lwp">
353 <primary sortas="g-LWP">LWP</primary>
354 </indexterm>
355
356 <para>The libwww-perl (LWP) collection is a set of
357 <application>Perl</application> modules which provides a simple and
358 consistent application programming interface to the World-Wide Web. The
359 main focus of the library is to provide classes and functions that allow
360 you to write WWW clients. The library also contains modules that are of
361 more general use and even classes that help you implement simple HTTP
362 servers. The LWP modules and all its <application>Perl</application>
363 module dependencies can be installed using the
364 <application>Perl</application> Module
365 <xref linkend="perl-standard-install"/>.</para>
366
367 <itemizedlist spacing='compact'>
368 <listitem>
369 <para><ulink
370 url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
371 LWP-&LWP-version;</ulink></para>
372
373 <itemizedlist>
374 <listitem>
375 <para id="perl-uri"><ulink
376 url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
377 URI-&URI-version;</ulink></para>
378 <indexterm zone="perl-modules perl-uri">
379 <primary sortas="g-URI">URI</primary>
380 </indexterm>
381
382 <itemizedlist>
383 <listitem>
384 <para id="perl-business-isbn"><ulink
385 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
386 Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
387 used during the test suite)</para>
388 <indexterm zone="perl-modules perl-business-isbn">
389 <primary sortas="g-Business-ISBN">Business::ISBN</primary>
390 </indexterm>
391
392 <itemizedlist>
393 <listitem>
394 <para id="perl-business-isbn-data"><ulink
395 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
396 Business-ISBN-Data-&Business-ISBN-Data-version;</ulink></para>
397 <indexterm zone="perl-modules perl-business-isbn-data">
398 <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
399 </indexterm>
400
401 <itemizedlist>
402 <listitem>
403 <para><xref linkend="perl-test-pod"/></para>
404 </listitem>
405 <listitem>
406 <para id="perl-test-prereq"><ulink
407 url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
408 Test-Prereq-&Test-Prereq-version;</ulink></para>
409 <indexterm zone="perl-modules perl-test-prereq">
410 <primary sortas="g-Test-Prereq">Test::Prereq</primary>
411 </indexterm>
412
413 <itemizedlist>
414 <listitem>
415 <para><xref linkend="perl-module-info"/></para>
416 </listitem>
417 <listitem>
418 <para><xref linkend="perl-module-build"/> (optional)</para>
419 </listitem>
420 <listitem>
421 <para id="perl-module-corelist"><ulink
422 url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
423 Module-CoreList-&Module-Corelist-version;</ulink></para>
424 <indexterm zone="perl-modules perl-module-corelist">
425 <primary sortas="g-Module-Corelist">Module::Corelist</primary>
426 </indexterm>
427 </listitem>
428 </itemizedlist>
429
430 </listitem>
431 </itemizedlist>
432
433 </listitem>
434 </itemizedlist>
435
436 </listitem>
437 </itemizedlist>
438
439 </listitem>
440 <listitem>
441 <para><xref linkend="perl-html-parser"/></para>
442 </listitem>
443 <listitem>
444 <para><xref linkend="perl-compress-zlib"/></para>
445 </listitem>
446 <listitem>
447 <para id="perl-crypt-ssleay"><ulink
448 url="http://cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
449 Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
450 support)</para>
451 <indexterm zone="perl-modules perl-crypt-ssleay">
452 <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
453 </indexterm>
454
455 <itemizedlist>
456 <listitem>
457 <para><xref linkend="openssl"/></para>
458 </listitem>
459 </itemizedlist>
460
461 </listitem>
462 </itemizedlist>
463
464 </listitem>
465 </itemizedlist>
466
467 <!-- Module::Build -->
468 <bridgehead renderas="sect3" id="perl-module-build"
469 xreflabel="Module::Build-&Module-Build-version;">
470 Module::Build-&Module-Build-version;</bridgehead>
471
472 <indexterm zone="perl-modules perl-module-build">
473 <primary sortas="g-Module-Build">Module::Build</primary>
474 </indexterm>
475
476 <para>The Module::Build module is a system for building, testing, and
477 installing <application>Perl</application> modules. It is meant to be an
478 alternative to ExtUtils::MakeMaker. Developers may alter the behavior of
479 the module through subclassing in a much more straightforward way than with
480 MakeMaker. It also does not require a <command>make</command> command on
481 your system. Most of the Module::Build code is
482 pure-<application>Perl</application> and written in a very cross-platform
483 way.</para>
484
485 <para>The Module::Build module (as well as any other
486 <application>Perl</application> module that uses the Module::Build build
487 system) uses <xref linkend="perl-module-build-install"/>. All the
488 dependencies can be installed using the standard
489 <xref linkend="perl-standard-install"/>.</para>
490
491 <itemizedlist spacing='compact'>
492 <listitem>
493 <para><ulink
494 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz">
495 Module-Build-&Module-Build-version;</ulink></para>
496
497 <itemizedlist>
498 <listitem>
499 <para id="perl-extutils-parsexs"><ulink
500 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
501 ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para>
502 <indexterm zone="perl-modules perl-extutils-parsexs">
503 <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary>
504 </indexterm>
505
506 <itemizedlist>
507 <listitem>
508 <para id="perl-extutils-cbuilder"><ulink
509 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
510 ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para>
511 <indexterm zone="perl-modules perl-extutils-cbuilder">
512 <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary>
513 </indexterm>
514 </listitem>
515 </itemizedlist>
516
517 </listitem>
518 <listitem>
519 <para id="perl-archive-tar"><ulink
520 url="http://cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
521 Archive-Tar-&Archive-Tar-version;</ulink></para>
522 <indexterm zone="perl-modules perl-archive-tar">
523 <primary sortas="g-Archive-Tar">Archive::Tar</primary>
524 </indexterm>
525
526 <itemizedlist>
527 <listitem>
528 <para id="perl-io-zlib"><ulink
529 url="http://cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
530 IO-Zlib-&IO-Zlib-version;</ulink></para>
531 <indexterm zone="perl-modules perl-io-zlib">
532 <primary sortas="g-IO-Zlib">IO::Zlib</primary>
533 </indexterm>
534
535 <itemizedlist>
536 <listitem>
537 <para><xref linkend="perl-compress-zlib"/></para>
538 </listitem>
539 </itemizedlist>
540
541 </listitem>
542 <listitem>
543 <para id="perl-text-diff"><ulink
544 url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
545 Text-Diff-&Text-Diff-version;</ulink></para>
546 <indexterm zone="perl-modules perl-text-diff">
547 <primary sortas="g-Text-Diff">Text::Diff</primary>
548 </indexterm>
549
550 <itemizedlist>
551 <listitem>
552 <para id="perl-algorithm-diff"><ulink
553 url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.zip">
554 Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
555 <indexterm zone="perl-modules perl-algorithm-diff">
556 <primary sortas="g-Algorithm-Diff">Algorithm::Diff</primary>
557 </indexterm>
558
559 <itemizedlist>
560 <listitem>
561 <para><xref linkend="unzip"/></para>
562 </listitem>
563 </itemizedlist>
564
565 </listitem>
566 </itemizedlist>
567
568 </listitem>
569 <listitem>
570 <para><xref linkend="perl-test-pod"/> (optionally used during
571 the tests)</para>
572 </listitem>
573 </itemizedlist>
574
575 </listitem>
576 <listitem>
577 <para><xref linkend="perl-module-signature"/> (optionally used
578 during the tests)</para>
579 </listitem>
580 <listitem>
581 <para><ulink
582 url="http://cpan.org/authors/id/I/IN/INGY/YAML-0.39.tar.gz">
583 YAML-0.39</ulink> (Optional- adds an addditional feature to
584 Module::Build. Note that this version of YAML is older than the
585 existing <xref linkend="perl-yaml"/> listed on this page. The newer
586 version is not compatible with this version of Module::Build.
587 Also note that you cannot have both YAML-0.39 and another version
588 exist together.)</para>
589 </listitem>
590 </itemizedlist>
591
592 </listitem>
593 </itemizedlist>
594
595 <bridgehead renderas="sect4" id="perl-module-build-install"
596 xreflabel="modified build instructions">Module::Build Build and
597 Installation Instructions</bridgehead>
598
599<screen><userinput>perl Build.PL &amp;&amp;
600./Build &amp;&amp;
601./Build test</userinput></screen>
602
603 <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
604
605<screen role='root'><userinput>./Build install</userinput></screen>
606
607 <!-- Module::Info -->
608 <bridgehead renderas="sect3" id="perl-module-info"
609 xreflabel="Module::Info-&Module-Info-version;">
610 Module::Info-&Module-Info-version;</bridgehead>
611
612 <indexterm zone="perl-modules perl-module-info">
613 <primary sortas="g-Module-Info">Module::Info</primary>
614 </indexterm>
615
616 <para>The Module::Info module is quite useful for tasks other than just
617 support of other modules. It can be used from the command-line to tell you
618 if a particular module is included in, or has been installed into your
619 <application>Perl</application> installation. Additionally, Module::Info
620 can tell you what version of a module is installed and what dependencies
621 are required for it. You can even use Module::Info to gather dependencies
622 of uninstalled modules. The Module::Info module installs using the standard
623 <xref linkend="perl-standard-install"/>. The version module requires using
624 the Module::Build installation method.</para>
625
626 <itemizedlist spacing='compact'>
627 <listitem>
628 <para><ulink
629 url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
630 Module-Info-&Module-Info-version;</ulink></para>
631
632 <itemizedlist>
633 <listitem>
634 <para id="perl-version-module"><ulink
635 url="http://cpan.org/authors/id/J/JP/JPEACOCK/version-&version-perl-version;.tar.gz">
636 version-&version-perl-version;</ulink>
637 (optionally used during the tests)</para>
638 <indexterm zone="perl-modules perl-version-module">
639 <primary sortas="g-version">version</primary>
640 </indexterm>
641
642 <itemizedlist>
643 <listitem>
644 <para><xref linkend="perl-module-build"/></para>
645 </listitem>
646 </itemizedlist>
647
648 </listitem>
649 <listitem>
650 <para><xref linkend="perl-test-pod"/>
651 (optionally used during the tests)</para>
652 </listitem>
653 </itemizedlist>
654
655 </listitem>
656 </itemizedlist>
657
658 <!-- Module::Signature -->
659 <bridgehead renderas="sect3" id="perl-module-signature"
660 xreflabel="Module::Signature-&Module-Signature-version;">
661 Module::Signature-&Module-Signature-version;</bridgehead>
662
663 <indexterm zone="perl-modules perl-module-signature">
664 <primary sortas="g-Module-Signature">Module::Signature</primary>
665 </indexterm>
666
667 <para>The Module::Signature module is used to check and create
668 <filename>SIGNATURE</filename> files for CPAN distributions. After
669 installing Module::Signature you can verify the content of a distribution
670 tarball (if it includes a <filename>SIGNATURE</filename> file) by unpacking
671 the tarball, changing into the newly created directory and issuing the
672 command <command>cpansign -v</command>. It will check each file's
673 integrity, as well as the signature's validity.</para>
674
675 <itemizedlist spacing='compact'>
676 <listitem>
677 <para><ulink
678 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
679 Module-Signature-&Module-Signature-version;</ulink></para>
680
681 <itemizedlist>
682 <listitem>
683 <para id="perl-digest-sha"><ulink
684 url="http://cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
685 Digest-SHA-&Digest-SHA-version;</ulink></para>
686 <indexterm zone="perl-modules perl-digest-sha">
687 <primary sortas="g-Digest-SHA">Digest::SHA</primary>
688 </indexterm>
689 </listitem>
690 <listitem>
691 <para id="perl-par-dist"><ulink
692 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz">
693 PAR-Dist-&PAR-Dist-version;</ulink></para>
694 <indexterm zone="perl-modules perl-par-dist">
695 <primary sortas="g-PAR-Dist">PAR::Dist</primary>
696 </indexterm>
697 </listitem>
698 <listitem>
699 <para><xref linkend="gnupg"/></para>
700 </listitem>
701 </itemizedlist>
702
703 </listitem>
704 </itemizedlist>
705
706 <!-- Net::DNS -->
707 <bridgehead renderas="sect3" id="perl-net-dns"
708 xreflabel="Net-DNS-&Net-DNS-version;">
709 Net::DNS-&Net-DNS-version;</bridgehead>
710
711 <indexterm zone="perl-modules perl-net-dns">
712 <primary sortas="g-Net-DNS">Net::DNS</primary>
713 </indexterm>
714
715 <para>Net::DNS is a DNS resolver implemented in
716 <application>Perl</application>. It can be used to perform nearly any type
717 of DNS query from a <application>Perl</application> script. The Net::DNS
718 module and all its dependencies can be installed using the
719 <application>Perl</application> Module
720 <xref linkend="perl-standard-install"/>.</para>
721
722 <itemizedlist spacing='compact'>
723 <listitem>
724 <para><ulink
725 url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
726 Net-DNS-&Net-DNS-version;</ulink></para>
727
728 <itemizedlist>
729 <listitem>
730 <para id="perl-digest-hmac"><ulink
731 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
732 Digest-HMAC-&Digest-HMAC-version;</ulink></para>
733 <indexterm zone="perl-modules perl-digest-hmac">
734 <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
735 </indexterm>
736
737 <itemizedlist>
738 <listitem>
739 <para id="perl-digest-sha1"><ulink
740 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
741 Digest-SHA1-&Digest-SHA1-version;</ulink></para>
742 <indexterm zone="perl-modules perl-digest-sha1">
743 <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
744 </indexterm>
745 </listitem>
746 </itemizedlist>
747
748 </listitem>
749 <listitem>
750 <para id="perl-net-ip"><ulink
751 url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
752 Net-IP-&Net-IP-version;</ulink></para>
753 <indexterm zone="perl-modules perl-net-ip">
754 <primary sortas="g-Net-IP">Net::IP</primary>
755 </indexterm>
756 </listitem>
757 <listitem>
758 <para id="perl-io-socket-inet6"><ulink
759 url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
760 IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
761 IPv6 support)</para>
762 <indexterm zone="perl-modules perl-io-socket-inet6">
763 <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
764 </indexterm>
765
766 <itemizedlist>
767 <listitem>
768 <para id="perl-socket6"><ulink
769 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
770 Socket6-&Socket6-version;</ulink></para>
771 <indexterm zone="perl-modules perl-socket6">
772 <primary sortas="g-Socket6">Socket6</primary>
773 </indexterm>
774 </listitem>
775 </itemizedlist>
776
777 </listitem>
778 <listitem>
779 <para id="perl-digest-bubblebabble"><ulink
780 url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
781 Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink>
782 (optional, only used during the test suite)</para>
783 <indexterm zone="perl-modules perl-digest-bubblebabble">
784 <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
785 </indexterm>
786 </listitem>
787 </itemizedlist>
788
789 </listitem>
790 </itemizedlist>
791
792 <!-- SGMLSpm -->
793 <bridgehead renderas="sect3" id="perl-sgmlspm"
794 xreflabel="SGMLSpm-&SGMLSpm-version;">
795 SGMLSpm-&SGMLSpm-version;</bridgehead>
796
797 <indexterm zone="perl-modules perl-sgmlspm">
798 <primary sortas="g-SGMLSpm">SGMLSpm</primary>
799 </indexterm>
800
801 <para>The SGMLSpm module is a <application>Perl</application> library
802 used for parsing the output from James Clark's SGMLS and NSGMLS
803 parsers. This module requires modified installation instructions, shown
804 below.</para>
805
806 <itemizedlist spacing='compact'>
807 <listitem>
808 <para><ulink
809 url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
810 SGMLSpm-&SGMLSpm-version;</ulink></para>
811 </listitem>
812 </itemizedlist>
813
814 <para>If your system's <application>Perl</application> version is different
815 than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
816 command below to reflect the version you have installed.</para>
817
818<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
819 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
820 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
821 Makefile</userinput></screen>
822
823 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
824
825<screen role="root"><userinput>make install &amp;&amp;
826install -v -m755 -d /usr/share/doc/perl5 &amp;&amp;
827make install_html &amp;&amp;
828rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
829install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
830
831 <!-- Test::Pod -->
832 <bridgehead renderas="sect3" id="perl-test-pod"
833 xreflabel="Test::Pod-&Test-Pod-version;">
834 Test::Pod-&Test-Pod-version;</bridgehead>
835
836 <indexterm zone="perl-modules perl-test-pod">
837 <primary sortas="g-Test-Pod">Test::Pod</primary>
838 </indexterm>
839
840 <para>The Test:Pod module is (most of the time, optionally) used by other
841 modules during the build process to check the validity of POD (Plain Old
842 Documentation) files. The Test::Pod module is typically included by module
843 authors to automatically find and check all POD files in a module
844 distribution. This module and all the dependencies can be installed using the
845 <xref linkend="perl-standard-install"/>.</para>
846
847 <itemizedlist spacing='compact'>
848 <listitem>
849 <para><ulink
850 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
851 Test-Pod-&Test-Pod-version;</ulink></para>
852
853 <itemizedlist>
854 <listitem>
855 <para id="perl-pod-simple"><ulink
856 url="http://cpan.org/authors/id/A/AR/ARANDAL/Pod-Simple-&Pod-Simple-version;.tar.gz">
857 Pod-Simple-&Pod-Simple-version;</ulink></para>
858 <indexterm zone="perl-modules perl-pod-simple">
859 <primary sortas="g-Pod-Simple">Pod::Simple</primary>
860 </indexterm>
861
862 <itemizedlist>
863 <listitem>
864 <para id="perl-pod-escapes"><ulink
865 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
866 Pod-Escapes-&Pod-Escapes-version;</ulink></para>
867 <indexterm zone="perl-modules perl-pod-escapes">
868 <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
869 </indexterm>
870 </listitem>
871 </itemizedlist>
872
873 </listitem>
874 <listitem>
875 <para><xref linkend="perl-test-simple"/></para>
876 </listitem>
877 </itemizedlist>
878
879 </listitem>
880 </itemizedlist>
881
882 <!-- Test::Simple -->
883 <bridgehead renderas="sect3" id="perl-test-simple"
884 xreflabel="Test::Simple-&Test-Simple-version;">
885 Test::Simple-&Test-Simple-version;</bridgehead>
886
887 <indexterm zone="perl-modules perl-test-simple">
888 <primary sortas="g-Test-Simple">Test::Simple</primary>
889 </indexterm>
890
891 <para>The Test::Simple module contains utilities designed to assist
892 developers in creating tests. A version of Test::Simple was installed
893 during LFS with the <application>Perl</application>-&LFS-Perl-version;
894 installation, however, some of the sub-modules contained in Test::Simple
895 have been updated (notably, the Test::More module) and these updated
896 modules are now required by other modules. This updated version of
897 Test::Simple also now includes the Test:Builder:Tester module, required by
898 many of the modules on this page. Note that installing this updated
899 version of Test::Simple will overwrite some files from the original
900 <application>Perl</application> installation, but there's really nothing to
901 be alarmed about as these modules are only used by developers creating
902 tests, or for running the test suites during additional module
903 installations.</para>
904
905 <itemizedlist spacing='compact'>
906 <listitem>
907 <para><ulink
908 url="http://cpan.org/authors/id/M/MS/MSCHWERN/Test-Simple-&Test-Simple-version;.tar.gz">
909 Test-Simple-&Test-Simple-version;</ulink>
910 (<xref linkend="perl-standard-install"/>)</para>
911 </listitem>
912 </itemizedlist>
913
914 <!-- Tk -->
915 <bridgehead renderas="sect3" id="tk-perl"
916 xreflabel="Tk-Perl-&Tk-Perl-version;">
917 Tk-&Tk-Perl-version;</bridgehead>
918
919 <indexterm zone="perl-modules tk-perl">
920 <primary sortas="g-Tk">Tk</primary>
921 </indexterm>
922
923 <para>The <application>Tk</application> module is a
924 <application>Perl</application> interface to the
925 <application>Tk</application> package. The goal of this release is Unicode
926 support via <application>Perl</application>'s and
927 core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
928 builds and loads into a threaded <application>Perl</application> but is NOT
929 yet thread safe. The module can be installed using the
930 <application>Perl</application> Module
931 <xref linkend="perl-standard-install"/>.</para>
932
933 <itemizedlist spacing='compact'>
934 <listitem>
935 <para><ulink
936 url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Tk-Perl-version;.tar.gz">
937 Tk-&Tk-Perl-version;</ulink></para>
938
939 <itemizedlist>
940 <listitem>
941 <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
942 </listitem>
943 </itemizedlist>
944
945 </listitem>
946 </itemizedlist>
947
948 <!-- XML::Parser -->
949 <bridgehead renderas="sect3" id="perl-xml-parser"
950 xreflabel="XML::Parser-&XML-Parser-version;">
951 XML::Parser-&XML-Parser-version;</bridgehead>
952
953 <indexterm zone="perl-modules perl-xml-parser">
954 <primary sortas="g-XML-Parser">XML::Parser</primary>
955 </indexterm>
956
957 <para>The XML::Parser module is a <application>Perl</application> extension
958 interface to James Clark's XML parser,
959 <application>expat</application>. The module can be installed using the
960 <application>Perl</application> Module
961 <xref linkend="perl-standard-install"/>.</para>
962
963 <itemizedlist spacing='compact'>
964 <listitem>
965 <para><ulink
966 url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
967 XML-Parser-&XML-Parser-version;</ulink></para>
968
969 <itemizedlist>
970 <listitem>
971 <para><xref linkend="expat"/></para>
972 </listitem>
973 </itemizedlist>
974
975 </listitem>
976 </itemizedlist>
977
978 <!-- YAML -->
979 <bridgehead renderas="sect3" id="perl-yaml"
980 xreflabel="YAML-&YAML-version;">
981 YAML-&YAML-version;</bridgehead>
982
983 <indexterm zone="perl-modules perl-yaml">
984 <primary sortas="g-YAML">YAML</primary>
985 </indexterm>
986
987 <para></para>
988
989 <itemizedlist spacing='compact'>
990 <listitem>
991 <para><ulink
992 url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
993 YAML-&YAML-version;</ulink></para>
994
995 <itemizedlist>
996 <listitem>
997 <para>Dependency list will be added</para>
998 </listitem>
999 </itemizedlist>
1000
1001 </listitem>
1002 </itemizedlist>
1003
1004 </sect2>
1005
1006 <sect2 role="installation" id="perl-standard-install"
1007 xreflabel="build and installation instructions">
1008 <title>Standard Installation of Perl Modules</title>
1009
1010 <para>Install <application>Perl</application> modules by running the
1011 following commands:</para>
1012
1013<screen><userinput>perl Makefile.PL &amp;&amp;
1014make &amp;&amp;
1015make test</userinput></screen>
1016
1017 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
1018
1019<screen role="root"><userinput>make install</userinput></screen>
1020
1021 </sect2>
1022
1023 <sect2 role="installation">
1024 <title>(Alternate) Auto Installation of Perl Modules.</title>
1025
1026 <para>There is an alternate way of installing the modules using
1027 <application>Perl</application>'s built-in <command>install</command>
1028 command. The command automatically downloads the source from the CPAN
1029 archive, extracts it, runs the commands mentioned above, and removes the
1030 build source tree. You may still need to install dependent library
1031 packages before running the automated installation method.</para>
1032
1033 <para>The first time you run this command, you'll be prompted to enter some
1034 information regarding download locations and methods. This information is
1035 retained in files located in <filename class='directory'>~/.cpan</filename>.
1036 Start the perl shell with the following command as the
1037 <systemitem class="username">root</systemitem> user:</para>
1038
1039<screen role="root"><userinput>perl -MCPAN -e shell</userinput></screen>
1040
1041 <para>Each module may now be installed from this shell with the
1042 command:</para>
1043
1044<screen role="root"><userinput>install <replaceable>[Module::Name]</replaceable></userinput></screen>
1045
1046 <para>For additional commands and help, type <command>help</command>.</para>
1047
1048 <para>Alternatively, for scripted or non-interactive installations, use the
1049 following syntax as the
1050 <systemitem class="username">root</systemitem> user:</para>
1051
1052<screen role="root"><userinput>perl -MCPAN -e 'install <replaceable>[Module::Name]</replaceable>'</userinput></screen>
1053
1054 </sect2>
1055
1056</sect1>
Note: See TracBrowser for help on using the repository browser.