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

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

Modified the method of using cpan in the Perl Modules instructions, thanks to William Zhou for the suggestion

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