source: general/prog/perl-modules.xml@ dc89f86

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

Removed redundant libpng dependency in the Imlib instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5881 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 49.7 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"/> (optionally used during the
105 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 to create a
202 symbolic link to the <filename class='directory'>test</filename>
203 directory using the following command after unpacking the tarball
204 and changing into the root directory of the sources:</para>
205
206<screen><userinput>ln -s test t</userinput></screen>
207
208 <para>Some tests will fail depending on certain conditions. See the
209 <filename>INSTALL</filename> file for full details.</para>
210 </note>
211
212 <itemizedlist spacing='compact'>
213 <listitem>
214 <para><ulink
215 url="http://cpan.org/authors/id/P/PJ/PJF/Finance-Quote-&Finance-Quote-version;.tar.gz">
216 Finance-Quote-&Finance-Quote-version;</ulink></para>
217
218 <itemizedlist>
219 <listitem>
220 <para><xref linkend="perl-html-tableextract"/></para>
221 </listitem>
222 <listitem>
223 <para><xref linkend="perl-lwp"/></para>
224 </listitem>
225 </itemizedlist>
226
227 </listitem>
228 </itemizedlist>
229
230 <!-- Finance::QuoteHist -->
231 <bridgehead renderas="sect3" id="perl-finance-quotehist"
232 xreflabel="Finance::QuoteHist-&Finance-QuoteHist-version;">
233 Finance::QuoteHist-&Finance-QuoteHist-version;</bridgehead>
234
235 <indexterm zone="perl-modules perl-finance-quotehist">
236 <primary sortas="g-Finance-QuoteHist">Finance::QuoteHist</primary>
237 </indexterm>
238
239 <para>The Finance::QuoteHist bundle is several modules designed to fetch
240 historical stock quotes from the web. The module and dependencies are
241 installed using the standard <application>Perl</application> module
242 <xref linkend="perl-standard-install"/>.</para>
243
244 <itemizedlist spacing='compact'>
245 <listitem>
246 <para><ulink
247 url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
248 Finance-QuoteHist-&Finance-QuoteHist-version;</ulink></para>
249
250 <itemizedlist>
251 <listitem>
252 <para><xref linkend="perl-html-tableextract"/></para>
253 </listitem>
254 <listitem>
255 <para><xref linkend="perl-lwp"/></para>
256 </listitem>
257 <listitem>
258 <para><xref linkend="perl-date-manip"/></para>
259 </listitem>
260 <listitem>
261 <para id="perl-text-csv_xs"><ulink
262 url="http://cpan.org/authors/id/J/JW/JWIED/Text-CSV_XS-&Text-CSV_XS-version;.tar.gz">
263 Text-CSV_XS-&Text-CSV_XS-version;</ulink></para>
264 <indexterm zone="perl-modules perl-text-csv_xs">
265 <primary sortas="g-Text-CSV_XS">Text::CSV_XS</primary>
266 </indexterm>
267 </listitem>
268 </itemizedlist>
269
270 </listitem>
271 </itemizedlist>
272
273 <!-- HTML::Parser -->
274 <bridgehead renderas="sect3" id="perl-html-parser"
275 xreflabel="HTML::Parser-&HTML-Parser-version;">
276 HTML::Parser-&HTML-Parser-version;</bridgehead>
277
278 <indexterm zone="perl-modules perl-html-parser">
279 <primary sortas="g-HTML-Parser">HTML::Parser</primary>
280 </indexterm>
281
282 <para>The HTML::Parser distribution is a collection of modules that parse
283 and extract information from HTML documents. The modules listed below are
284 installed using the standard <application>Perl</application> module
285 <xref linkend="perl-standard-install"/>.</para>
286
287 <itemizedlist spacing='compact'>
288 <listitem>
289 <para><ulink
290 url="http://cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
291 HTML-Parser-&HTML-Parser-version;</ulink></para>
292
293 <itemizedlist>
294 <listitem>
295 <para id="perl-html-tagset"><ulink
296 url="http://cpan.org/authors/id/P/PE/PETDANCE/HTML-Tagset-&HTML-Tagset-version;.tar.gz">
297 HTML-Tagset-&HTML-Tagset-version;</ulink></para>
298 <indexterm zone="perl-modules perl-html-tagset">
299 <primary sortas="g-HTML-Tagset">HTML::Tagset</primary>
300 </indexterm>
301
302 <itemizedlist>
303 <listitem>
304 <para><xref linkend="perl-test-pod"/> (optionally used during the
305 tests)</para>
306 </listitem>
307 </itemizedlist>
308
309 </listitem>
310 <listitem>
311 <para><xref linkend="perl-lwp"/> (run-time requirement for the
312 included HTML::HeadParser module)</para>
313 </listitem>
314 </itemizedlist>
315
316 </listitem>
317 </itemizedlist>
318
319 <!-- HTML::TableExtract -->
320 <bridgehead renderas="sect3" id="perl-html-tableextract"
321 xreflabel="HTML::TableExtract-&HTML-TableExtract-version;">
322 HTML::TableExtract-&HTML-TableExtract-version;</bridgehead>
323
324 <indexterm zone="perl-modules perl-html-tableextract">
325 <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary>
326 </indexterm>
327
328 <para>HTML::TableExtract is a module that simplifies the extraction of the
329 content contained in tables within HTML documents, extracted either as
330 text or encoded element trees. Tables of note may be specified using
331 Headers, Depth, Count, Attributes, or some combination of the four. The
332 module and dependencies are installed using the standard
333 <application>Perl</application> module
334 <xref linkend="perl-standard-install"/>.</para>
335
336 <itemizedlist spacing='compact'>
337 <listitem>
338 <para><ulink
339 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
340 HTML-TableExtract-&HTML-TableExtract-version;</ulink></para>
341
342 <itemizedlist>
343 <listitem>
344 <para id="perl-html-element-extended"><ulink
345 url="http://cpan.org/authors/id/M/MS/MSISK/HTML-Element-Extended-&HTML-Element-Extended-version;.tar.gz">
346 HTML-Element-Extended-&HTML-Element-Extended-version;</ulink></para>
347 <indexterm zone="perl-modules perl-html-element-extended">
348 <primary sortas="g-HTML-Element-Extended">HTML::Element::Extended</primary>
349 </indexterm>
350
351 <itemizedlist>
352 <listitem>
353 <para id="perl-html-tree"><ulink
354 url="http://cpan.org/authors/id/P/PE/PETDANCE/HTML-Tree-&HTML-Tree-version;.tar.gz">
355 HTML-Tree-&HTML-Tree-version;</ulink></para>
356 <indexterm zone="perl-modules perl-html-tree">
357 <primary sortas="g-HTML-Tree">HTML::Tree</primary>
358 </indexterm>
359
360 <itemizedlist>
361 <listitem>
362 <para><xref linkend="perl-html-parser"/></para>
363 </listitem>
364 <listitem>
365 <para><xref linkend="perl-test-pod"/> (optionally used
366 during the tests)</para>
367 </listitem>
368 </itemizedlist>
369
370 </listitem>
371 </itemizedlist>
372
373 </listitem>
374 <listitem>
375 <para><xref linkend="perl-test-pod-coverage"/> (optionally used
376 during the tests)</para>
377 </listitem>
378 </itemizedlist>
379
380 </listitem>
381 </itemizedlist>
382
383 <!-- LWP -->
384 <bridgehead renderas="sect3" id="perl-lwp"
385 xreflabel="LWP-&LWP-version;">
386 LWP-&LWP-version;</bridgehead>
387
388 <indexterm zone="perl-modules perl-lwp">
389 <primary sortas="g-LWP">LWP</primary>
390 </indexterm>
391
392 <para>The LWP (libwww-perl) collection is a set of
393 <application>Perl</application> modules which provide a simple and
394 consistent application programming interface to the World-Wide Web. The
395 main focus of the library is to provide classes and functions that allow
396 you to write WWW clients. The library also contains modules that are of
397 more general use and even classes that help you implement simple HTTP
398 servers. The LWP collection and all its <application>Perl</application>
399 module dependencies are installed using the standard
400 <application>Perl</application> module
401 <xref linkend="perl-standard-install"/>.</para>
402
403 <itemizedlist spacing='compact'>
404 <listitem>
405 <para><ulink
406 url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
407 LWP-&LWP-version;</ulink></para>
408
409 <itemizedlist>
410 <listitem>
411 <para id="perl-uri"><ulink
412 url="http://cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
413 URI-&URI-version;</ulink></para>
414 <indexterm zone="perl-modules perl-uri">
415 <primary sortas="g-URI">URI</primary>
416 </indexterm>
417
418 <itemizedlist>
419 <listitem>
420 <para id="perl-business-isbn"><ulink
421 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-&Business-ISBN-version;.tar.gz">
422 Business-ISBN-&Business-ISBN-version;</ulink> (optional, only
423 used during the test suite)</para>
424 <indexterm zone="perl-modules perl-business-isbn">
425 <primary sortas="g-Business-ISBN">Business::ISBN</primary>
426 </indexterm>
427
428 <itemizedlist>
429 <listitem>
430 <para id="perl-business-isbn-data"><ulink
431 url="http://cpan.org/authors/id/B/BD/BDFOY/Business-ISBN-Data-&Business-ISBN-Data-version;.tar.gz">
432 Business-ISBN-Data-&Business-ISBN-Data-version;</ulink></para>
433 <indexterm zone="perl-modules perl-business-isbn-data">
434 <primary sortas="g-Business-ISBN-Data">Business::ISBN::Data</primary>
435 </indexterm>
436
437 <itemizedlist>
438 <listitem>
439 <para id="perl-test-prereq"><ulink
440 url="http://cpan.org/authors/id/B/BD/BDFOY/Test-Prereq-&Test-Prereq-version;.tar.gz">
441 Test-Prereq-&Test-Prereq-version;</ulink> (you may need
442 to set up your CPAN access parameters by issuing the
443 command <command>perl -MCPAN -e shell</command> before
444 running the test suite, else the tests may hang)</para>
445 <indexterm zone="perl-modules perl-test-prereq">
446 <primary sortas="g-Test-Prereq">Test::Prereq</primary>
447 </indexterm>
448
449 <itemizedlist>
450 <listitem>
451 <para><xref linkend="perl-module-info"/></para>
452 </listitem>
453 <listitem>
454 <para><xref linkend="perl-module-build"/> (optional)</para>
455 </listitem>
456 <listitem>
457 <para id="perl-module-corelist"><ulink
458 url="http://cpan.org/authors/id/R/RG/RGARCIA/Module-CoreList-&Module-Corelist-version;.tar.gz">
459 Module-CoreList-&Module-Corelist-version;</ulink></para>
460 <indexterm zone="perl-modules perl-module-corelist">
461 <primary sortas="g-Module-Corelist">Module::Corelist</primary>
462 </indexterm>
463
464 <itemizedlist>
465 <listitem>
466 <para><xref linkend="perl-test-pod"/>
467 (optionally used during the test suite)</para>
468 </listitem>
469 </itemizedlist>
470
471 </listitem>
472 </itemizedlist>
473
474 </listitem>
475 </itemizedlist>
476
477 </listitem>
478 </itemizedlist>
479
480 </listitem>
481 </itemizedlist>
482
483 </listitem>
484 <listitem>
485 <para><xref linkend="perl-html-parser"/></para>
486 </listitem>
487 <listitem>
488 <para><xref linkend="perl-compress-zlib"/></para>
489 </listitem>
490 <listitem>
491 <para id="perl-crypt-ssleay"><ulink
492 url="http://cpan.org/authors/id/C/CH/CHAMAS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
493 Crypt-SSLeay-&Crypt-SSLeay-version;</ulink> (optional, for HTTPS
494 support)</para>
495 <indexterm zone="perl-modules perl-crypt-ssleay">
496 <primary sortas="g-Crypt-SSLeay">Crypt::SSLeay</primary>
497 </indexterm>
498
499 <itemizedlist>
500 <listitem>
501 <para><xref linkend="openssl"/></para>
502 </listitem>
503 </itemizedlist>
504
505 </listitem>
506 </itemizedlist>
507
508 </listitem>
509 </itemizedlist>
510
511 <!-- Module::Build -->
512 <bridgehead renderas="sect3" id="perl-module-build"
513 xreflabel="Module::Build-&Module-Build-version;">
514 Module::Build-&Module-Build-version;</bridgehead>
515
516 <indexterm zone="perl-modules perl-module-build">
517 <primary sortas="g-Module-Build">Module::Build</primary>
518 </indexterm>
519
520 <para>The Module::Build module is a system for building, testing, and
521 installing <application>Perl</application> modules. It is meant to be an
522 alternative to ExtUtils::MakeMaker. Developers may alter the behavior of
523 the module through subclassing in a much more straightforward way than with
524 MakeMaker. It also does not require a <command>make</command> command on
525 your system. Most of the Module::Build code is
526 pure-<application>Perl</application> and written in a very cross-platform
527 way.</para>
528
529 <para>The Module::Build module (as well as any other
530 <application>Perl</application> module that uses the Module::Build build
531 system) uses <xref linkend="perl-module-build-install"/>. All the
532 dependencies are installed using the standard
533 <application>Perl</application> module
534 <xref linkend="perl-standard-install"/>.</para>
535
536 <itemizedlist spacing='compact'>
537 <listitem>
538 <para><ulink
539 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/Module-Build-&Module-Build-version;.tar.gz">
540 Module-Build-&Module-Build-version;</ulink></para>
541
542 <itemizedlist>
543 <listitem>
544 <para id="perl-extutils-parsexs"><ulink
545 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-ParseXS-&ExtUtils-ParseXS-version;.tar.gz">
546 ExtUtils-ParseXS-&ExtUtils-ParseXS-version;</ulink></para>
547 <indexterm zone="perl-modules perl-extutils-parsexs">
548 <primary sortas="g-ExtUtils-ParseXS">ExtUtils::ParseXS</primary>
549 </indexterm>
550
551 <itemizedlist>
552 <listitem>
553 <para id="perl-extutils-cbuilder"><ulink
554 url="http://cpan.org/authors/id/K/KW/KWILLIAMS/ExtUtils-CBuilder-&ExtUtils-CBuilder-version;.tar.gz">
555 ExtUtils-CBuilder-&ExtUtils-CBuilder-version;</ulink></para>
556 <indexterm zone="perl-modules perl-extutils-cbuilder">
557 <primary sortas="g-ExtUtils-CBuilder">ExtUtils::CBuilder</primary>
558 </indexterm>
559 </listitem>
560 </itemizedlist>
561
562 </listitem>
563 <listitem>
564 <para id="perl-archive-tar"><ulink
565 url="http://cpan.org/authors/id/K/KA/KANE/Archive-Tar-&Archive-Tar-version;.tar.gz">
566 Archive-Tar-&Archive-Tar-version;</ulink></para>
567 <indexterm zone="perl-modules perl-archive-tar">
568 <primary sortas="g-Archive-Tar">Archive::Tar</primary>
569 </indexterm>
570
571 <itemizedlist>
572 <listitem>
573 <para id="perl-io-zlib"><ulink
574 url="http://cpan.org/authors/id/T/TO/TOMHUGHES/IO-Zlib-&IO-Zlib-version;.tar.gz">
575 IO-Zlib-&IO-Zlib-version;</ulink></para>
576 <indexterm zone="perl-modules perl-io-zlib">
577 <primary sortas="g-IO-Zlib">IO::Zlib</primary>
578 </indexterm>
579
580 <itemizedlist>
581 <listitem>
582 <para><xref linkend="perl-compress-zlib"/></para>
583 </listitem>
584 </itemizedlist>
585
586 </listitem>
587 <listitem>
588 <para><xref linkend="perl-text-diff"/></para>
589 </listitem>
590 <listitem>
591 <para><xref linkend="perl-test-pod"/> (optionally used during
592 the tests)</para>
593 </listitem>
594 </itemizedlist>
595
596 </listitem>
597 <listitem>
598 <para><xref linkend="perl-module-signature"/> (required to use the
599 Module::Build <quote>distsign</quote> run-time method and
600 optionally used during the tests)</para>
601 </listitem>
602 <listitem>
603 <para><ulink
604 url="http://cpan.org/authors/id/I/IN/INGY/YAML-0.39.tar.gz">
605 YAML-0.39</ulink> (Optional &mdash; adds an additional feature to
606 Module::Build. Note that this version of YAML is older than the
607 existing <xref linkend="perl-yaml"/> listed on this page. The newer
608 version is not compatible with this version of Module::Build.
609 Also note that you cannot have both YAML-0.39 and another version
610 exist together.)</para>
611 </listitem>
612 </itemizedlist>
613
614 </listitem>
615 </itemizedlist>
616
617 <bridgehead renderas="sect4" id="perl-module-build-install"
618 xreflabel="modified build instructions">Module::Build Build and
619 Installation Instructions</bridgehead>
620
621<screen><userinput>perl Build.PL &amp;&amp;
622./Build &amp;&amp;
623./Build test</userinput></screen>
624
625 <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
626
627<screen role='root'><userinput>./Build install</userinput></screen>
628
629 <!-- Module::Info -->
630 <bridgehead renderas="sect3" id="perl-module-info"
631 xreflabel="Module::Info-&Module-Info-version;">
632 Module::Info-&Module-Info-version;</bridgehead>
633
634 <indexterm zone="perl-modules perl-module-info">
635 <primary sortas="g-Module-Info">Module::Info</primary>
636 </indexterm>
637
638 <para>The Module::Info module is quite useful for tasks other than just
639 support of other modules. It can be used from the command-line to tell you
640 if a particular module is included in, or has been installed into your
641 <application>Perl</application> installation. Additionally, Module::Info
642 can tell you what version of a module is installed and what dependencies
643 are required for it. You can even use Module::Info to gather dependencies
644 of uninstalled modules. The Module::Info module installs using the standard
645 <application>Perl</application> module
646 <xref linkend="perl-standard-install"/>. The version module requires using
647 the Module::Build <xref linkend="perl-module-build-install"/>.</para>
648
649 <itemizedlist spacing='compact'>
650 <listitem>
651 <para><ulink
652 url="http://cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
653 Module-Info-&Module-Info-version;</ulink></para>
654
655 <itemizedlist>
656 <listitem>
657 <para id="perl-version-module"><ulink
658 url="http://cpan.org/authors/id/J/JP/JPEACOCK/version-&version-perl-version;.tar.gz">
659 version-&version-perl-version;</ulink>
660 (optionally used during the tests)</para>
661 <indexterm zone="perl-modules perl-version-module">
662 <primary sortas="g-version">version</primary>
663 </indexterm>
664
665 <itemizedlist>
666 <listitem>
667 <para><xref linkend="perl-module-build"/></para>
668 </listitem>
669 </itemizedlist>
670
671 </listitem>
672 <listitem>
673 <para><xref linkend="perl-test-pod"/>
674 (optionally used during the tests)</para>
675 </listitem>
676 </itemizedlist>
677
678 </listitem>
679 </itemizedlist>
680
681 <!-- Module::Signature -->
682 <bridgehead renderas="sect3" id="perl-module-signature"
683 xreflabel="Module::Signature-&Module-Signature-version;">
684 Module::Signature-&Module-Signature-version;</bridgehead>
685
686 <indexterm zone="perl-modules perl-module-signature">
687 <primary sortas="g-Module-Signature">Module::Signature</primary>
688 </indexterm>
689
690 <para>The Module::Signature module is used to check and create
691 <filename>SIGNATURE</filename> files for CPAN distributions. After
692 installing Module::Signature you can verify the content of a distribution
693 tarball (if it includes a <filename>SIGNATURE</filename> file) by unpacking
694 the tarball, changing into the newly created directory and issuing the
695 command <command>cpansign -v</command>. It will check each file's
696 integrity, as well as the signature's validity. Note that some of the
697 dependencies appear to be circular, however, they are only run-time
698 conflicts and you should be able to fully utilize them as long as
699 everything is installed. Module::Signature and the dependency modules are
700 installed using the standard <application>Perl</application>
701 module <xref linkend="perl-standard-install"/>.</para>
702
703 <itemizedlist spacing='compact'>
704 <listitem>
705 <para><ulink
706 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/Module-Signature-&Module-Signature-version;.tar.gz">
707 Module-Signature-&Module-Signature-version;</ulink></para>
708
709 <itemizedlist>
710 <listitem>
711 <para><xref linkend="perl-text-diff"/></para>
712 </listitem>
713 <listitem>
714 <para id="perl-par-dist"><ulink
715 url="http://cpan.org/authors/id/A/AU/AUTRIJUS/PAR-Dist-&PAR-Dist-version;.tar.gz">
716 PAR-Dist-&PAR-Dist-version;</ulink></para>
717 <indexterm zone="perl-modules perl-par-dist">
718 <primary sortas="g-PAR-Dist">PAR::Dist</primary>
719 </indexterm>
720
721 <itemizedlist>
722 <listitem>
723 <para><xref linkend="perl-archive-zip"/></para>
724 </listitem>
725 <listitem>
726 <para><xref linkend="perl-lwp"/></para>
727 </listitem>
728 <listitem>
729 <para><xref linkend="perl-module-signature"/></para>
730 </listitem>
731 </itemizedlist>
732
733 </listitem>
734 <listitem>
735 <para id="perl-digest-sha"><ulink
736 url="http://cpan.org/authors/id/M/MS/MSHELOR/Digest-SHA-&Digest-SHA-version;.tar.gz">
737 Digest-SHA-&Digest-SHA-version;</ulink></para>
738 <indexterm zone="perl-modules perl-digest-sha">
739 <primary sortas="g-Digest-SHA">Digest::SHA</primary>
740 </indexterm>
741
742 <itemizedlist>
743 <listitem>
744 <para><xref linkend="perl-test-pod-coverage"/> (optionally used
745 during the tests)</para>
746 </listitem>
747 </itemizedlist>
748
749 </listitem>
750 <listitem>
751 <para><xref linkend="gnupg"/></para>
752 </listitem>
753 </itemizedlist>
754
755 </listitem>
756 </itemizedlist>
757
758 <!-- Net::DNS -->
759 <bridgehead renderas="sect3" id="perl-net-dns"
760 xreflabel="Net-DNS-&Net-DNS-version;">
761 Net::DNS-&Net-DNS-version;</bridgehead>
762
763 <indexterm zone="perl-modules perl-net-dns">
764 <primary sortas="g-Net-DNS">Net::DNS</primary>
765 </indexterm>
766
767 <para>Net::DNS is a DNS resolver implemented in
768 <application>Perl</application>. It can be used to perform nearly any type
769 of DNS query from a <application>Perl</application> script. The Net::DNS
770 module and all its dependencies are installed using the standard
771 <application>Perl</application> module
772 <xref linkend="perl-standard-install"/>.</para>
773
774 <itemizedlist spacing='compact'>
775 <listitem>
776 <para><ulink
777 url="http://cpan.org/authors/id/O/OL/OLAF/Net-DNS-&Net-DNS-version;.tar.gz">
778 Net-DNS-&Net-DNS-version;</ulink></para>
779
780 <itemizedlist>
781 <listitem>
782 <para id="perl-digest-hmac"><ulink
783 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
784 Digest-HMAC-&Digest-HMAC-version;</ulink></para>
785 <indexterm zone="perl-modules perl-digest-hmac">
786 <primary sortas="g-Digest-HMAC">Digest::HMAC</primary>
787 </indexterm>
788
789 <itemizedlist>
790 <listitem>
791 <para id="perl-digest-sha1"><ulink
792 url="http://cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
793 Digest-SHA1-&Digest-SHA1-version;</ulink></para>
794 <indexterm zone="perl-modules perl-digest-sha1">
795 <primary sortas="g-Digest-SHA1">Digest::SHA1</primary>
796 </indexterm>
797 </listitem>
798 </itemizedlist>
799
800 </listitem>
801 <listitem>
802 <para id="perl-net-ip"><ulink
803 url="http://cpan.org/authors/id/M/MA/MANU/Net-IP-&Net-IP-version;.tar.gz">
804 Net-IP-&Net-IP-version;</ulink></para>
805 <indexterm zone="perl-modules perl-net-ip">
806 <primary sortas="g-Net-IP">Net::IP</primary>
807 </indexterm>
808 </listitem>
809 <listitem>
810 <para id="perl-io-socket-inet6"><ulink
811 url="http://cpan.org/authors/id/M/MO/MONDEJAR/IO-Socket-INET6-&IO-Socket-INET6-version;.tar.gz">
812 IO-Socket-INET6-&IO-Socket-INET6-version;</ulink> (required for
813 IPv6 support)</para>
814 <indexterm zone="perl-modules perl-io-socket-inet6">
815 <primary sortas="g-IO-Socket-INET6">IO::Socket::INET6</primary>
816 </indexterm>
817
818 <itemizedlist>
819 <listitem>
820 <para id="perl-socket6"><ulink
821 url="http://cpan.org/authors/id/U/UM/UMEMOTO/Socket6-&Socket6-version;.tar.gz">
822 Socket6-&Socket6-version;</ulink></para>
823 <indexterm zone="perl-modules perl-socket6">
824 <primary sortas="g-Socket6">Socket6</primary>
825 </indexterm>
826 </listitem>
827 </itemizedlist>
828
829 </listitem>
830 <listitem>
831 <para id="perl-digest-bubblebabble"><ulink
832 url="http://cpan.org/authors/id/B/BT/BTROTT/Digest-BubbleBabble-&Digest-BubbleBabble-version;.tar.gz">
833 Digest-BubbleBabble-&Digest-BubbleBabble-version;</ulink>
834 (optional, only used during the test suite)</para>
835 <indexterm zone="perl-modules perl-digest-bubblebabble">
836 <primary sortas="g-Digest-BubbleBabble">Digest::BubbleBabble</primary>
837 </indexterm>
838 </listitem>
839 </itemizedlist>
840
841 </listitem>
842 </itemizedlist>
843
844 <!-- SGMLSpm -->
845 <bridgehead renderas="sect3" id="perl-sgmlspm"
846 xreflabel="SGMLSpm-&SGMLSpm-version;">
847 SGMLSpm-&SGMLSpm-version;</bridgehead>
848
849 <indexterm zone="perl-modules perl-sgmlspm">
850 <primary sortas="g-SGMLSpm">SGMLSpm</primary>
851 </indexterm>
852
853 <para>The SGMLSpm module is a <application>Perl</application> library
854 used for parsing the output from James Clark's SGMLS and NSGMLS
855 parsers. This module requires modified installation instructions, shown
856 below.</para>
857
858 <itemizedlist spacing='compact'>
859 <listitem>
860 <para><ulink
861 url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
862 SGMLSpm-&SGMLSpm-version;</ulink></para>
863 </listitem>
864 </itemizedlist>
865
866 <para>If your system's <application>Perl</application> version is different
867 than &lfs-perl-version;, you'll need to modify the <command>sed</command>
868 command below to reflect the version you have installed.</para>
869
870<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
871 -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&lfs-perl-version;@" \
872 -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
873 Makefile</userinput></screen>
874
875 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
876
877<screen role="root"><userinput>make install &amp;&amp;
878install -v -m755 -d /usr/share/doc/perl5 &amp;&amp;
879make install_html &amp;&amp;
880rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &amp;&amp;
881install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
882
883 <!-- Test::Pod -->
884 <bridgehead renderas="sect3" id="perl-test-pod"
885 xreflabel="Test::Pod-&Test-Pod-version;">
886 Test::Pod-&Test-Pod-version;</bridgehead>
887
888 <indexterm zone="perl-modules perl-test-pod">
889 <primary sortas="g-Test-Pod">Test::Pod</primary>
890 </indexterm>
891
892 <para>The Test:Pod module is (most of the time, optionally) used by other
893 modules during the build process to check the validity of POD (Plain Old
894 Documentation) files. The Test::Pod module is typically included by module
895 authors to automatically find and check all POD files in a module
896 distribution. This module and all the dependencies are installed using
897 the standard <application>Perl</application> module
898 <xref linkend="perl-standard-install"/>.</para>
899
900 <itemizedlist spacing='compact'>
901 <listitem>
902 <para><ulink
903 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-&Test-Pod-version;.tar.gz">
904 Test-Pod-&Test-Pod-version;</ulink></para>
905
906 <itemizedlist>
907 <listitem>
908 <para id="perl-pod-simple"><ulink
909 url="http://cpan.org/authors/id/A/AR/ARANDAL/Pod-Simple-&Pod-Simple-version;.tar.gz">
910 Pod-Simple-&Pod-Simple-version;</ulink></para>
911 <indexterm zone="perl-modules perl-pod-simple">
912 <primary sortas="g-Pod-Simple">Pod::Simple</primary>
913 </indexterm>
914
915 <itemizedlist>
916 <listitem>
917 <para id="perl-pod-escapes"><ulink
918 url="http://cpan.org/authors/id/S/SB/SBURKE/Pod-Escapes-&Pod-Escapes-version;.tar.gz">
919 Pod-Escapes-&Pod-Escapes-version;</ulink></para>
920 <indexterm zone="perl-modules perl-pod-escapes">
921 <primary sortas="g-Pod-Escapes">Pod::Escapes</primary>
922 </indexterm>
923 </listitem>
924 </itemizedlist>
925
926 </listitem>
927 <listitem>
928 <para><xref linkend="perl-test-simple"/></para>
929 </listitem>
930 </itemizedlist>
931
932 </listitem>
933 </itemizedlist>
934
935 <!-- Test::Pod::Coverage -->
936 <bridgehead renderas="sect3" id="perl-test-pod-coverage"
937 xreflabel="Test::Pod::Coverage-&Test-Pod-Coverage-version;">
938 Test::Pod::Coverage-&Test-Pod-Coverage-version;</bridgehead>
939
940 <indexterm zone="perl-modules perl-test-pod-coverage">
941 <primary sortas="g-Test-Pod-Coverage">Test::Pod::Coverage</primary>
942 </indexterm>
943
944 <para>The Test::Pod::Coverage module is used to check files in a
945 distribution for POD coverage. It is normally used by developers to
946 ensure their projects are adequately covered with POD and it is also used
947 in the test suites of many module distributions. The Pod::Coverage module
948 requires using the Module::Build
949 <xref linkend="perl-module-build-install"/>, all the other modules are
950 installed using the standard <application>Perl</application> module
951 <xref linkend="perl-standard-install"/>.</para>
952
953 <itemizedlist spacing='compact'>
954 <listitem>
955 <para><ulink
956 url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-Coverage-&Test-Pod-Coverage-version;.tar.gz">
957 Test-Pod-Coverage-&Test-Pod-Coverage-version;</ulink></para>
958
959 <itemizedlist>
960 <listitem>
961 <para id="perl-test-builder-tester">
962 <xref linkend="perl-test-simple"/> or
963 <ulink
964 url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
965 Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
966 <indexterm zone="perl-modules perl-test-builder-tester">
967 <primary sortas="g-Test-Builder-Tester">Test::Builder::Tester</primary>
968 </indexterm>
969 </listitem>
970 <listitem>
971 <para id="perl-pod-coverage"><ulink
972 url="http://cpan.org/authors/id/R/RC/RCLAMP/Pod-Coverage-&Pod-Coverage-version;.tar.gz">
973 Pod-Coverage-&Pod-Coverage-version;</ulink></para>
974 <indexterm zone="perl-modules perl-pod-coverage">
975 <primary sortas="g-Pod-Coverage">Pod::Coverage</primary>
976 </indexterm>
977
978 <itemizedlist>
979 <listitem>
980 <para id="perl-devel-symdump"><ulink
981 url="http://cpan.org/authors/id/A/AN/ANDK/Devel-Symdump-&Devel-Symdump-version;.tar.gz">
982 Devel-Symdump-&Devel-Symdump-version;</ulink></para>
983 <indexterm zone="perl-modules perl-devel-symdump">
984 <primary sortas="g-Devel-Symdump">Devel::Symdump</primary>
985 </indexterm>
986
987 <itemizedlist>
988 <listitem>
989 <para><xref linkend="perl-test-pod"/> (optionally used
990 during the tests)</para>
991 </listitem>
992 </itemizedlist>
993
994 </listitem>
995 <listitem>
996 <para><xref linkend="perl-module-build"/></para>
997 </listitem>
998 </itemizedlist>
999
1000 </listitem>
1001 </itemizedlist>
1002
1003 </listitem>
1004 </itemizedlist>
1005
1006 <!-- Test::Simple -->
1007 <bridgehead renderas="sect3" id="perl-test-simple"
1008 xreflabel="Test::Simple-&Test-Simple-version;">
1009 Test::Simple-&Test-Simple-version;</bridgehead>
1010
1011 <indexterm zone="perl-modules perl-test-simple">
1012 <primary sortas="g-Test-Simple">Test::Simple</primary>
1013 </indexterm>
1014
1015 <para>The Test::Simple module contains utilities designed to assist
1016 developers in creating tests. A version of Test::Simple was installed
1017 during LFS with the <application>Perl</application>-&lfs-perl-version;
1018 installation, however, some of the sub-modules contained in Test::Simple
1019 have been updated (notably, the Test::More module) and these updated
1020 modules are now required by other modules. This updated version of
1021 Test::Simple also now includes the Test:Builder:Tester module, required by
1022 many of the modules on this page. Note that installing this updated
1023 version of Test::Simple will overwrite some files from the original
1024 <application>Perl</application> installation, but there's really nothing to
1025 be alarmed about as these modules are only used by developers creating
1026 tests, or for running the test suites during additional module
1027 installations.</para>
1028
1029 <itemizedlist spacing='compact'>
1030 <listitem>
1031 <para><ulink
1032 url="http://cpan.org/authors/id/M/MS/MSCHWERN/Test-Simple-&Test-Simple-version;.tar.gz">
1033 Test-Simple-&Test-Simple-version;</ulink>
1034 (<xref linkend="perl-standard-install"/>)</para>
1035
1036 <itemizedlist>
1037 <listitem>
1038 <para><xref linkend="perl-module-signature"/> (optionally used
1039 during the tests)</para>
1040 </listitem>
1041 </itemizedlist>
1042
1043 </listitem>
1044 </itemizedlist>
1045
1046 <!-- Text::Diff -->
1047 <bridgehead renderas="sect3" id="perl-text-diff"
1048 xreflabel="Text::Diff-&Text-Diff-version;">
1049 Text::Diff-&Text-Diff-version;</bridgehead>
1050
1051 <indexterm zone="perl-modules perl-text-diff">
1052 <primary sortas="g-Text-Diff">Text::Diff</primary>
1053 </indexterm>
1054
1055 <para>Text::Diff is used to perform diffs on files and record sets. It
1056 provides a basic set of services akin to the GNU <command>diff</command>
1057 utility. It is not anywhere near as feature complete as GNU
1058 <command>diff</command>, but it is better integrated with
1059 <application>Perl</application> and available on all platforms. Text::Diff
1060 is often faster than shelling out to a system's <command>diff</command>
1061 executable for small files, and generally slower on larger files. The
1062 modules listed below are installed using the standard
1063 <application>Perl</application> module
1064 <xref linkend="perl-standard-install"/>.</para>
1065
1066 <itemizedlist spacing='compact'>
1067 <listitem>
1068 <para><ulink
1069 url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
1070 Text-Diff-&Text-Diff-version;</ulink></para>
1071
1072 <itemizedlist>
1073 <listitem>
1074 <para id="perl-algorithm-diff"><ulink
1075 url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.zip">
1076 Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
1077 <indexterm zone="perl-modules perl-algorithm-diff">
1078 <primary sortas="g-Algorithm-Diff">Algorithm::Diff</primary>
1079 </indexterm>
1080
1081 <itemizedlist>
1082 <listitem>
1083 <para><xref linkend="unzip"/></para>
1084 </listitem>
1085 </itemizedlist>
1086
1087 </listitem>
1088 </itemizedlist>
1089
1090 </listitem>
1091 </itemizedlist>
1092
1093 <!-- Tk -->
1094 <bridgehead renderas="sect3" id="tk-perl"
1095 xreflabel="Tk-Perl-&Tk-Perl-version;">
1096 Tk-&Tk-Perl-version;</bridgehead>
1097
1098 <indexterm zone="perl-modules tk-perl">
1099 <primary sortas="g-Tk">Tk</primary>
1100 </indexterm>
1101
1102 <para>The <application>Tk</application> module is a
1103 <application>Perl</application> interface to the
1104 <application>Tk</application> package. The goal of this release is Unicode
1105 support via <application>Perl</application>'s and
1106 core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
1107 builds and loads into a threaded <application>Perl</application> but is NOT
1108 yet thread safe. The module is installed using the standard
1109 <application>Perl</application> module
1110 <xref linkend="perl-standard-install"/>.</para>
1111
1112 <itemizedlist spacing='compact'>
1113 <listitem>
1114 <para><ulink
1115 url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Tk-Perl-version;.tar.gz">
1116 Tk-&Tk-Perl-version;</ulink></para>
1117
1118 <itemizedlist>
1119 <listitem>
1120 <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
1121 </listitem>
1122 </itemizedlist>
1123
1124 </listitem>
1125 </itemizedlist>
1126
1127 <!-- XML::Parser -->
1128 <bridgehead renderas="sect3" id="perl-xml-parser"
1129 xreflabel="XML::Parser-&XML-Parser-version;">
1130 XML::Parser-&XML-Parser-version;</bridgehead>
1131
1132 <indexterm zone="perl-modules perl-xml-parser">
1133 <primary sortas="g-XML-Parser">XML::Parser</primary>
1134 </indexterm>
1135
1136 <para>The XML::Parser module is a <application>Perl</application> extension
1137 interface to James Clark's XML parser,
1138 <application>expat</application>. The module is installed using the
1139 standard <application>Perl</application> module
1140 <xref linkend="perl-standard-install"/>.</para>
1141
1142 <itemizedlist spacing='compact'>
1143 <listitem>
1144 <para><ulink
1145 url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
1146 XML-Parser-&XML-Parser-version;</ulink></para>
1147
1148 <itemizedlist>
1149 <listitem>
1150 <para><xref linkend="expat"/></para>
1151 </listitem>
1152 </itemizedlist>
1153 <itemizedlist>
1154 <listitem>
1155 <para><xref linkend="perl-lwp"/>
1156 (optionally used during the tests)</para>
1157 </listitem>
1158 </itemizedlist>
1159
1160 </listitem>
1161 </itemizedlist>
1162
1163 <!-- YAML -->
1164 <bridgehead renderas="sect3" id="perl-yaml"
1165 xreflabel="YAML-&YAML-version;">
1166 YAML-&YAML-version;</bridgehead>
1167
1168 <indexterm zone="perl-modules perl-yaml">
1169 <primary sortas="g-YAML">YAML</primary>
1170 </indexterm>
1171
1172 <para></para>
1173
1174 <itemizedlist spacing='compact'>
1175 <listitem>
1176 <para><ulink
1177 url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
1178 YAML-&YAML-version;</ulink></para>
1179
1180 <itemizedlist>
1181 <listitem>
1182 <para>Dependency list will be added</para>
1183 </listitem>
1184 </itemizedlist>
1185
1186 </listitem>
1187 </itemizedlist>
1188
1189 </sect2>
1190
1191 <sect2 role="installation" id="perl-standard-install"
1192 xreflabel="build and installation instructions">
1193 <title>Standard Installation of Perl Modules</title>
1194
1195 <para>Install <application>Perl</application> modules by running the
1196 following commands:</para>
1197
1198<screen><userinput>perl Makefile.PL &amp;&amp;
1199make &amp;&amp;
1200make test</userinput></screen>
1201
1202 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
1203
1204<screen role="root"><userinput>make install</userinput></screen>
1205
1206 </sect2>
1207
1208 <sect2 role="installation">
1209 <title>(Alternate) Auto Installation of Perl Modules.</title>
1210
1211 <para>There is an alternate way of installing the modules using
1212 <application>Perl</application>'s built-in <command>install</command>
1213 command. The command automatically downloads the source from the CPAN
1214 archive, extracts it, runs the commands mentioned above, and removes the
1215 build source tree. You may still need to install dependent library
1216 packages before running the automated installation method.</para>
1217
1218 <para>The first time you run this command, you'll be prompted to enter some
1219 information regarding download locations and methods. This information is
1220 retained in files located in <filename class='directory'>~/.cpan</filename>.
1221 Start the perl shell with the following command as the
1222 <systemitem class="username">root</systemitem> user:</para>
1223
1224<screen role="root"><userinput>perl -MCPAN -e shell</userinput></screen>
1225
1226 <para>Each module may now be installed from this shell with the
1227 command:</para>
1228
1229<screen role="root"><userinput>install <replaceable>&lt;Module::Name&gt;</replaceable></userinput></screen>
1230
1231 <para>For additional commands and help, type <command>help</command>.</para>
1232
1233 <para>Alternatively, for scripted or non-interactive installations, use the
1234 following syntax as the
1235 <systemitem class="username">root</systemitem> user:</para>
1236
1237<screen role="root"><userinput>perl -MCPAN -e 'install <replaceable>&lt;Module::Name&gt;</replaceable>'</userinput></screen>
1238
1239 </sect2>
1240
1241</sect1>
Note: See TracBrowser for help on using the repository browser.