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

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 9f12e36 was 9f12e36, checked in by Randy McMurchy <randy@…>, 18 years ago

Removed 'keywordset' blocks and extra spaces from the XML files (note this was by accident as I meant to do just in the gnome directory but I was in the root of BOOK when I ran the script, but this was going to happen anyway so I don't think it is a big deal)

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