source: general/prog/perl-modules.xml@ 60a31248

10.0 10.1 11.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 60a31248 was 60a31248, checked in by Randy McMurchy <randy@…>, 16 years ago

Updated all the links to files on the Anduin server to use entities

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5612 af4574ff-66df-0310-9fd7-8a98e5e911e0

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