Context Navigation

perl-modules.xml@ 44fe081f

Visit:

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 44fe081f was 44fe081f, checked in by Randy McMurchy <randy@…>, 13 years ago

Updated Perl module Module::Info to 0.32

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

Property mode set to 100644

File size: 57.1 KB

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

Note: See TracBrowser for help on using the repository browser.

Context Navigation

source: general/prog/perl-modules.xml@ 44fe081f

Download in other formats: