source: general/prog/perl-modules.xml@ 7eee225

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

Updated to libwww-perl-5.805 (also renamed the package from LWP)

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