source: general/prog/perl-modules.xml@ 56605b9

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 56605b9 was 56605b9, checked in by Bruce Dubbs <bdubbs@…>, 10 years ago

Remove XML::Parser from perl modules
Archive acl, attr, intltool, expat, gperf
Synchronize libcap with LFS.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@13004 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 32.5 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 dependencies in the order listed. The Perl Module standard
33 build and installation instructions are shown at the bottom of this page.
34 </para>
35
36 <!-- <itemizedlist spacing="compact">
37 <listitem>
38 <para>Download MD5 sums (HTTP):
39 <ulink url="&perl_modules_md5sums_download_http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download MD5 sums (FTP):
43 <ulink url="&perl_modules_md5sums_download_ftp;"/></para>
44 </listitem>
45 </itemizedlist> -->
46
47 <!-- Archive::Zip -->
48 <bridgehead renderas="sect3" id="perl-archive-zip"
49 xreflabel="Archive::Zip-&Archive-Zip-version;">
50 Archive::Zip-&Archive-Zip-version;</bridgehead>
51
52 <indexterm zone="perl-modules perl-archive-zip">
53 <primary sortas="a-Archive-Zip">Archive::Zip</primary>
54 </indexterm>
55
56 <para>The Archive::Zip module allows a <application>Perl</application>
57 program to create, manipulate, read, and write Zip archive files. This
58 module uses the standard <xref linkend="perl-standard-install"/>.</para>
59
60 &lfs75_checked;
61
62 <itemizedlist>
63 <listitem>
64 <para>
65 <ulink url="http://search.cpan.org/CPAN/authors/id/P/PH/PHRED/Archive-Zip-&Archive-Zip-version;.tar.gz">
66 Archive::Zip-&Archive-Zip-version;</ulink> (MD5 sum: e804985def2c1f0ed640ab4ca6aa85a1)
67 </para>
68 </listitem>
69 </itemizedlist>
70
71<!-- <!- Glib ->
72 <bridgehead renderas="sect3" id="perl-glib"
73 xreflabel="Glib-&Glib-perl-version;">
74 Glib-&Glib-perl-version;</bridgehead>
75
76 <indexterm zone="perl-modules perl-glib">
77 <primary sortas="a-Glib">Glib</primary>
78 </indexterm>
79
80 <para>
81 This module is a <application>Perl</application> wrapper around
82 <application>GLib</application> that attempts to provide a perlish
83 interface while remaining as true as possible to the underlying C API, so
84 that any reference materials you can find on using GLib may still apply to
85 using the libraries from Perl. This module and the dependency modules use
86 the standard <xref linkend="perl-standard-install"/>.
87 </para>
88
89 &lfs7 4_checked;
90
91 <itemizedlist>
92 <listitem>
93 <para>
94 <ulink url="http://www.cpan.org/authors/id/T/TS/TSCH/Glib-&Glib-perl-version;.tar.gz">
95 Glib-&Glib-perl-version;</ulink> (MD5 sum: 1d81a8aec5f7f1182a96cfaaf119d866)
96 </para>
97 <itemizedlist>
98 <listitem>
99 <para>
100 <ulink url="http://search.cpan.org/~xaoc/ExtUtils-PkgConfig/">ExtUtils::PkgConfig</ulink>
101 </para>
102 <itemizedlist>
103 <listitem>
104 <para>
105 <ulink url="http://search.cpan.org/~flora/ExtUtils-Depends/">ExtUtils::Depends</ulink>
106 </para>
107 </listitem>
108 </itemizedlist>
109 </listitem>
110 </itemizedlist>
111 </listitem>
112 </itemizedlist>
113-->
114 <!-- HTML::Parser -->
115 <bridgehead renderas="sect3" id="perl-html-parser"
116 xreflabel="HTML::Parser-&HTML-Parser-version;">
117 HTML::Parser-&HTML-Parser-version;</bridgehead>
118
119 <indexterm zone="perl-modules perl-html-parser">
120 <primary sortas="a-HTML-Parser">HTML::Parser</primary>
121 </indexterm>
122
123 <para>The HTML::Parser distribution is a collection of modules that parse
124 and extract information from HTML documents. This module and the dependency
125 modules use the standard
126 <xref linkend="perl-standard-install"/>.</para>
127
128 &lfs75_checked;
129
130 <itemizedlist>
131 <listitem>
132 <para>
133 <ulink url="http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
134 HTML::Parser-&HTML-Parser-version;</ulink> (MD5 sum: 9128a45893097dfa3bf03301b19c5efe)
135 </para>
136 <itemizedlist>
137 <listitem>
138 <para>
139 <ulink url="http://search.cpan.org/~petdance/HTML-Tagset/">HTML::Tagset</ulink>
140 </para>
141 </listitem>
142 <listitem>
143 <para>
144 <xref linkend="perl-lwp"/> (circular; howevever, it can
145 be installed after HTML::Parser as it is only a run-time
146 requirement for the included HTML::HeadParser module)
147 </para>
148 </listitem>
149 </itemizedlist>
150 </listitem>
151 </itemizedlist>
152
153 <!-- HTML::TableExtract
154 <bridgehead renderas="sect3" id="perl-html-tableextract"
155 xreflabel="HTML::TableExtract-&HTML-TableExtract-version;">
156 HTML::TableExtract-&HTML-TableExtract-version;</bridgehead>
157
158 <indexterm zone="perl-modules perl-html-tableextract">
159 <primary sortas="a-HTML-TableExtract">HTML::TableExtract</primary>
160 </indexterm>
161
162 <para>HTML::TableExtract is a module that simplifies the extraction of the
163 content contained in tables within HTML documents, extracted either as
164 text or encoded element trees. Tables of note may be specified using
165 Headers, Depth, Count, Attributes, or some combination of the four. This
166 module and dependency modules use the standard
167 <xref linkend="perl-standard-install"/>.</para>
168
169 <itemizedlist>
170 <listitem>
171 <para>
172 <ulink url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
173 HTML::TableExtract-&HTML-TableExtract-version;</ulink> (MD5sum: ac1b8fa092d53931a9f3fdbba330f5b0)
174 </para>
175 <itemizedlist>
176 <listitem>
177 <para>
178 <ulink url="http://search.cpan.org/~msisk/HTML-Element-Extended/">HTML::Element::Extended</ulink>
179 </para>
180 <itemizedlist>
181 <listitem>
182 <para>
183 <ulink url="http://search.cpan.org/~cjm/HTML-Tree/">HTML::Tree</ulink>
184 </para>
185 <itemizedlist>
186 <listitem>
187 <para>
188 <xref linkend="perl-html-parser"/>
189 </para>
190 </listitem>
191 <listitem>
192 <para>
193 <ulink url="http://search.cpan.org/dist/Test-Fatal/">Test::Fatal</ulink>
194 (optionally used in the test suite)
195 </para>
196 <itemizedlist>
197 <listitem>
198 <para>
199 <ulink url="http://search.cpan.org/~doy/Try-Tiny/">Try::Tiny</ulink>
200 </para>
201 </listitem>
202 </itemizedlist>
203 </listitem>
204 </itemizedlist>
205 </listitem>
206 </itemizedlist>
207 </listitem>
208 </itemizedlist>
209 </listitem>
210 </itemizedlist> -->
211
212 <!-- LWP -->
213 <bridgehead renderas="sect3" id="perl-lwp"
214 xreflabel="libwww-perl-&LWP-version;">
215 libwww-perl-&LWP-version; (a.k.a. LWP)</bridgehead>
216
217 <indexterm zone="perl-modules perl-lwp">
218 <primary sortas="a-libwww-perl">libwww-perl</primary>
219 </indexterm>
220
221 <para>The libwww-perl (LWP) collection is a set of
222 <application>Perl</application> modules which provide a simple and
223 consistent application programming interface to the World-Wide Web. The
224 main focus of the library is to provide classes and functions that allow
225 you to write WWW clients. The library also contains modules that are of
226 more general use and even classes that help you implement simple HTTP
227 servers. The LWP collection and all its dependency modules use the standard
228 <xref linkend="perl-standard-install"/>. The dependencies should be
229 installed in the order listed below. Ensure you install the dependency
230 chain for each module before installing the modules.</para>
231
232 &lfs75_checked;
233
234 <itemizedlist>
235 <listitem>
236 <para>
237 <ulink url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
238 libwww-perl-&LWP-version;</ulink> (MD5 sum: 637d5f1eb61336ca2caa6e026b382f87)
239 </para>
240 <itemizedlist>
241 <listitem>
242 <para>
243 <ulink url="http://search.cpan.org/~gaas/Encode-Locale/">Encode::Locale</ulink>
244 </para>
245 </listitem>
246 <listitem>
247 <para>
248 <ulink url="http://search.cpan.org/~gaas/HTML-Form/">HTML::Form</ulink>
249 </para>
250 <itemizedlist>
251 <listitem>
252 <para>
253 <xref linkend="perl-uri"/>
254 </para>
255 </listitem>
256 <listitem>
257 <para>
258 <xref linkend="perl-html-parser"/>
259 </para>
260 </listitem>
261 <listitem>
262 <para>
263 <ulink url="http://search.cpan.org/~gaas/HTTP-Message/">HTTP::Message</ulink>
264 </para>
265 <itemizedlist>
266 <listitem>
267 <para>
268 <ulink url="http://search.cpan.org/~gaas/HTTP-Date/">HTTP::Date</ulink>
269 </para>
270 </listitem>
271 <listitem>
272 <para>
273 <ulink url="http://search.cpan.org/~cjm/IO-HTML/">IO::HTML</ulink>
274 </para>
275 </listitem>
276 <listitem>
277 <para>
278 <ulink url="http://search.cpan.org/~gaas/LWP-MediaTypes/">LWP::MediaTypes</ulink>
279 </para>
280 </listitem>
281 </itemizedlist>
282 </listitem>
283 </itemizedlist>
284 </listitem>
285 <listitem>
286 <para>
287 <ulink url="http://search.cpan.org/~gaas/HTTP-Cookies/">HTTP::Cookies</ulink>
288 </para>
289 </listitem>
290 <listitem>
291 <para>
292 <ulink url="http://search.cpan.org/~gaas/HTTP-Negotiate/">HTTP::Negotiate</ulink>
293 </para>
294 </listitem>
295 <listitem>
296 <para>
297 <ulink url="http://search.cpan.org/~gaas/Net-HTTP/">Net::HTTP</ulink>
298 </para>
299 </listitem>
300 <listitem>
301 <para>
302 <ulink url="http://search.cpan.org/~gaas/WWW-RobotRules/">WWW::RobotRules</ulink>
303 </para>
304 </listitem>
305 <listitem>
306 <para>
307 <ulink url="http://search.cpan.org/~gaas/HTTP-Daemon/">HTTP::Daemon</ulink>
308 </para>
309 </listitem>
310 <listitem>
311 <para>
312 <ulink url="http://search.cpan.org/~gaas/File-Listing/">File::Listing</ulink>
313 </para>
314 </listitem>
315 </itemizedlist>
316 </listitem>
317 </itemizedlist>
318
319 <para>After the LWP installation, if you want HTTPS protocol support,
320 install the following (application and modules):</para>
321
322 <itemizedlist>
323 <listitem>
324 <para>
325 <xref linkend="openssl"/>
326 </para>
327 </listitem>
328 <listitem>
329 <para>
330 <ulink url="http://search.cpan.org/~gaas/LWP-Protocol-https/">LWP::Protocol::https</ulink>
331 </para>
332 <itemizedlist>
333 <listitem>
334 <para>
335 <ulink url="http://search.cpan.org/~behroozi/IO-Socket-SSL/">IO::Socket::SSL</ulink>
336 </para>
337 <itemizedlist>
338 <listitem>
339 <para>
340 <ulink url="http://search.cpan.org/dist/Net-SSLeay/">Net::SSLeay</ulink>
341 </para>
342 </listitem>
343 </itemizedlist>
344 </listitem>
345 <listitem>
346 <para>
347 <ulink url="http://search.cpan.org/~abh/Mozilla-CA/">Mozilla::CA</ulink>
348 </para>
349 </listitem>
350 </itemizedlist>
351 </listitem>
352 </itemizedlist>
353
354
355 <!-- Module::Info
356 <bridgehead renderas="sect3" id="perl-module-info"
357 xreflabel="Module::Info-&Module-Info-version;">
358 Module::Info-&Module-Info-version;</bridgehead>
359
360 <indexterm zone="perl-modules perl-module-info">
361 <primary sortas="a-Module-Info">Module::Info</primary>
362 </indexterm>
363
364 <para>The Module::Info module is quite useful for tasks other than just
365 support of other modules. It can be used from the command-line to tell you
366 if a particular module is included in, or has been installed into your
367 <application>Perl</application> installation. Additionally, Module::Info
368 can tell you what version of a module is installed and what dependencies
369 are required for it. You can even use Module::Info to gather dependencies
370 of uninstalled modules. The Module::Info module and dependencies install
371 using the standard <application>Perl</application> module
372 <xref linkend="perl-standard-install"/>.</para>
373
374 <itemizedlist>
375 <listitem>
376 <para>
377 <ulink url="http://www.cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
378 Module-Info-&Module-Info-version;</ulink>
379 </para>
380 </listitem>
381 </itemizedlist>
382 -->
383
384 <!-- Module::Signature
385 <bridgehead renderas="sect3" id="perl-module-signature"
386 xreflabel="Module::Signature-&Module-Signature-version;">
387 Module::Signature-&Module-Signature-version;</bridgehead>
388
389 <indexterm zone="perl-modules perl-module-signature">
390 <primary sortas="a-Module-Signature">Module::Signature</primary>
391 </indexterm>
392
393 <para>The Module::Signature module is used to check and create
394 <filename>SIGNATURE</filename> files for CPAN distributions. After
395 installing Module::Signature you can verify the content of a distribution
396 tarball (if it includes a <filename>SIGNATURE</filename> file) by unpacking
397 the tarball, changing into the newly created directory and issuing the
398 command <command>cpansign -v</command>. It will check each file's
399 integrity, as well as the signature's validity. Note that some of the
400 dependencies appear to be circular, however, they are only run-time
401 conflicts and you should be able to fully utilize them as long as
402 everything is installed. Module::Signature and the dependency modules are
403 installed using the standard <application>Perl</application>
404 module <xref linkend="perl-standard-install"/>.</para>
405
406 <itemizedlist>
407 <listitem>
408 <para>
409 <ulink url="http://cpan.org/authors/id/A/AU/AUDREYT/Module-Signature-&Module-Signature-version;.tar.gz">
410 Module-Signature-&Module-Signature-version;</ulink>
411 </para>
412 <itemizedlist>
413 <listitem>
414 <para>
415 <xref linkend="perl-text-diff"/>
416 </para>
417 </listitem>
418 <listitem>
419 <para>
420 <ulink url="http://cpan.org/authors/id/S/SM/SMUELLER/PAR-Dist-&PAR-Dist-version;.tar.gz">
421 PAR-Dist-&PAR-Dist-version;</ulink>
422 </para>
423 <itemizedlist>
424 <listitem>
425 <para>
426 <xref linkend="perl-archive-zip"/>
427 </para>
428 </listitem>
429 <listitem>
430 <para>
431 <xref linkend="perl-lwp"/>
432 </para>
433 </listitem>
434 <listitem>
435 <para>
436 <xref linkend="perl-module-signature"/>
437 </para>
438 </listitem>
439 </itemizedlist>
440 </listitem>
441 <listitem>
442 <para>
443 <xref linkend="gnupg"/>
444 </para>
445 </listitem>
446 </itemizedlist>
447 </listitem>
448 </itemizedlist>
449 -->
450
451 <!-- Net::DNS -->
452 <bridgehead renderas="sect3" id="perl-net-dns"
453 xreflabel="Net::DNS-&Net-DNS-version;">
454 Net::DNS-&Net-DNS-version;</bridgehead>
455
456 <indexterm zone="perl-modules perl-net-dns">
457 <primary sortas="a-Net-DNS">Net::DNS</primary>
458 </indexterm>
459
460 <para>Net::DNS is a DNS resolver implemented in
461 <application>Perl</application>. It can be used to perform nearly any type
462 of DNS query from a <application>Perl</application> script. The Net::DNS
463 module and all its dependencies are installed using the standard
464 <xref linkend="perl-standard-install"/>.</para>
465
466 &lfs75_checked;
467
468 <itemizedlist>
469 <listitem>
470 <para>
471 <ulink url="http://www.cpan.org/authors/id/N/NL/NLNETLABS/Net-DNS-&Net-DNS-version;.tar.gz">
472 Net::DNS-&Net-DNS-version;</ulink> (MD5 sum: d3d074ba95314fa9627252653a4242b7)
473 </para>
474 <itemizedlist>
475 <listitem>
476 <para>
477 <ulink url="http://search.cpan.org/~gaas/Digest-HMAC/">Digest::HMAC</ulink>
478 </para>
479 </listitem>
480 <listitem>
481 <para>
482 <ulink url="http://search.cpan.org/~gbarr/IO/lib/IO/Socket/INET.pm">IO::Socket::INET</ulink>
483 (required for IPv6 support)
484 </para>
485 <itemizedlist>
486 <listitem>
487 <para>
488 <ulink url="http://search.cpan.org/~umemoto/Socket6/">Socket6</ulink>
489 </para>
490 </listitem>
491 </itemizedlist>
492 </listitem>
493 </itemizedlist>
494 </listitem>
495 </itemizedlist>
496
497 <!-- SGMLSpm -->
498 <bridgehead renderas="sect3" id="perl-sgmlspm"
499 xreflabel="SGMLSpm-&SGMLSpm-version;">
500 SGMLSpm-&SGMLSpm-version;</bridgehead>
501
502 <indexterm zone="perl-modules perl-sgmlspm">
503 <primary sortas="a-SGMLSpm">SGMLSpm</primary>
504 </indexterm>
505
506 <para>The SGMLSpm module is a <application>Perl</application> library
507 used for parsing the output from James Clark's SGMLS and NSGMLS
508 parsers. This modules uses the standard
509 <xref linkend="perl-standard-install"/>.</para>
510
511 &lfs75_checked;
512
513 <para> Before beginning the build, issue
514 the following command to prevent an error:</para>
515
516<screen><userinput>chmod -v 644 MYMETA.yml</userinput></screen>
517
518 <para>
519 After installed, as the <systemitem class="username">root</systemitem>
520 user:
521 </para>
522
523<screen role="root"><userinput>ln -sv sgmlspl.pl /usr/bin/sgmlspl</userinput></screen>
524
525 <itemizedlist>
526 <listitem>
527 <para>
528 <ulink url="http://search.cpan.org/CPAN/authors/id/R/RA/RAAB/SGMLSpm-&SGMLSpm-version;.tar.gz">
529 SGMLSpm-&SGMLSpm-version;</ulink> (MD5 sum: 746c74ae969992cedb1a2879b4168090)
530 </para>
531 </listitem>
532 </itemizedlist>
533
534 <!-- Text::Diff
535 <bridgehead renderas="sect3" id="perl-text-diff"
536 xreflabel="Text::Diff-&Text-Diff-version;">
537 Text::Diff-&Text-Diff-version;</bridgehead>
538
539 <indexterm zone="perl-modules perl-text-diff">
540 <primary sortas="a-Text-Diff">Text::Diff</primary>
541 </indexterm>
542
543 <para>Text::Diff is used to perform diffs on files and record sets. It
544 provides a basic set of services akin to the GNU <command>diff</command>
545 utility. It is not anywhere near as feature complete as GNU
546 <command>diff</command>, but it is better integrated with
547 <application>Perl</application> and available on all platforms. Text::Diff
548 is often faster than shelling out to a system's <command>diff</command>
549 executable for small files, and generally slower on larger files. The
550 modules listed below are installed using the standard
551 <application>Perl</application> module
552 <xref linkend="perl-standard-install"/>.</para>
553
554 <itemizedlist>
555 <listitem>
556 <para>
557 <ulink url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
558 Text-Diff-&Text-Diff-version;</ulink></para>
559 <itemizedlist>
560 <listitem>
561 <para>
562 <ulink url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.tar.gz">
563 Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
564 </listitem>
565 </itemizedlist>
566 </listitem>
567 </itemizedlist>
568 -->
569
570 <!-- Tk
571 <bridgehead renderas="sect3" id="tk-perl"
572 xreflabel="Tk-Perl-&Tk-Perl-version;">
573 Tk-&Tk-Perl-version;</bridgehead>
574
575 <indexterm zone="perl-modules tk-perl">
576 <primary sortas="a-Tk">Tk</primary>
577 </indexterm>
578
579 <para>The <application>Tk</application> module is a
580 <application>Perl</application> interface to the
581 <application>Tk</application> package. The goal of this release is Unicode
582 support via <application>Perl</application>'s and
583 core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
584 builds and loads into a threaded <application>Perl</application> but is NOT
585 yet thread safe. The module is installed using the standard
586 <application>Perl</application> module
587 <xref linkend="perl-standard-install"/>.</para>
588
589 <itemizedlist>
590 <listitem>
591 <para>
592 <ulink url="http://www.cpan.org/authors/id/S/SR/SREZIC/Tk-&Tk-Perl-version;.tar.gz">
593 Tk-&Tk-Perl-version;</ulink></para>
594 <itemizedlist>
595 <listitem>
596 <para>
597 <xref linkend="tk"/> and <xref linkend="libjpeg"/>
598 </para>
599 </listitem>
600 </itemizedlist>
601 </listitem>
602 </itemizedlist>
603 -->
604
605 <!-- URI -->
606 <bridgehead renderas="sect3" id="perl-uri"
607 xreflabel="URI-&URI-version;">
608 URI-&URI-version;</bridgehead>
609
610 <indexterm zone="perl-modules perl-uri">
611 <primary sortas="a-URI">URI</primary>
612 </indexterm>
613
614 <para>
615 This module implements the URI class. Objects of this class represent
616 "Uniform Resource Identifier references" as specified in RFC 2396 (and
617 updated by RFC 2732). A Uniform Resource Identifier is a compact string of
618 characters that identifies an abstract or physical resource. A Uniform
619 Resource Identifier can be further classified as either a Uniform Resource
620 Locator (URL) or a Uniform Resource Name (URN). The distinction between
621 URL and URN does not matter to the URI class interface. A "URI-reference"
622 is a URI that may have additional information attached in the form of a
623 fragment identifier. This module uses the standard
624 <xref linkend="perl-standard-install"/>.
625 </para>
626
627 &lfs75_checked;
628
629 <itemizedlist>
630 <listitem>
631 <para>
632 <ulink url="http://www.cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
633 URI-&URI-version;</ulink> (MD5 sum: 70f739be8ce28b8baba7c5920ffee4dc)
634 </para>
635 </listitem>
636 </itemizedlist>
637
638 <!-- XML::Parser -->
639 <!--
640 <bridgehead renderas="sect3" id="perl-xml-parser"
641 xreflabel="XML::Parser-&XML-Parser-version;">
642 XML::Parser-&XML-Parser-version;</bridgehead>
643
644 <indexterm zone="perl-modules perl-xml-parser">
645 <primary sortas="a-XML-Parser">XML::Parser</primary>
646 </indexterm>
647
648 <para>The XML::Parser module is a <application>Perl</application> extension
649 interface to James Clark's XML parser,
650 <application>expat</application>. The module uses the standard
651 <xref linkend="perl-standard-install"/>.</para>
652
653 &lfs75_checked;
654
655 <itemizedlist>
656 <listitem>
657 <para>
658 <ulink url="http://search.cpan.org/CPAN/authors/id/T/TO/TODDR/XML-Parser-&XML-Parser-version;.tar.gz">
659 XML::Parser-&XML-Parser-version;</ulink> (MD5 sum: c320d2ffa459e6cdc6f9f59c1185855e)
660 </para>
661 <itemizedlist>
662 <listitem>
663 <para>
664 <xref linkend="expat"/>
665 </para>
666 </listitem>
667 <listitem>
668 <para>
669 <xref linkend="perl-lwp"/> (optionally used in the test suite)
670 </para>
671 </listitem>
672 </itemizedlist>
673
674 </listitem>
675 </itemizedlist>
676 -->
677 <!-- XML::Simple -->
678 <bridgehead renderas="sect3" id="perl-xml-simple"
679 xreflabel="XML::Simple-&XML-Simple-version;">
680 XML::Simple-&XML-Simple-version;</bridgehead>
681
682 <indexterm zone="perl-modules perl-xml-simple">
683 <primary sortas="a-XML-Simple">XML::Simple</primary>
684 </indexterm>
685
686 <para>The XML::Simple module is a <application>Perl</application> extension
687 that provides an easy API to read and write XML (especially config files).
688 This module and all dependency modules use the standard
689 <xref linkend="perl-standard-install"/>.</para>
690
691 &lfs75_checked;
692
693 <itemizedlist>
694 <listitem>
695 <para>
696 <ulink url="http://cpan.org/authors/id/G/GR/GRANTM/XML-Simple-&XML-Simple-version;.tar.gz">
697 XML::Simple-&XML-Simple-version;</ulink> (MD5 sum: 4d10964e123b76eca36678464daa63cd)
698 </para>
699 <itemizedlist>
700 <listitem>
701 <para>
702 <ulink url="http://search.cpan.org/~grantm/XML-SAX/">XML::SAX</ulink>
703 (Note: this package does not support parallel build)
704 </para>
705 <itemizedlist>
706 <listitem>
707 <para>
708 <ulink url="http://search.cpan.org/~perigrin/XML-NamespaceSupport/">
709 XML::NamespaceSupport</ulink>
710 </para>
711 </listitem>
712 <listitem>
713 <para>
714 <ulink url="http://search.cpan.org/~grantm/XML-SAX-Base/">
715 XML::SAX::Base</ulink>
716 </para>
717 </listitem>
718 </itemizedlist>
719 </listitem>
720 <listitem>
721 <para>
722 <ulink url="http://search.cpan.org/~bjoern/XML-SAX-Expat/">XML::SAX::Expat</ulink>
723 (Note: this package does not support parallel build)
724 </para>
725 <!--<itemizedlist>
726 <listitem>
727 <para>
728 <xref linkend="perl-xml-parser"/>
729 </para>
730 </listitem>
731 </itemizedlist> -->
732 </listitem>
733 <listitem>
734 <para id="perl-xml-libxml">
735 <ulink url="http://search.cpan.org/~shlomif/XML-LibXML/">XML::LibXML</ulink>
736 (recommended for faster parsing)
737 </para>
738 </listitem>
739 <listitem>
740 <para>
741 <ulink url="http://search.cpan.org/~chorny/Tie-IxHash/">Tie::IxHash</ulink>
742 (optionally used in the test suite)
743 </para>
744 </listitem>
745 </itemizedlist>
746 </listitem>
747 </itemizedlist>
748
749 <!-- YAML
750 <bridgehead renderas="sect3" id="perl-yaml"
751 xreflabel="YAML-&YAML-version;">
752 YAML-&YAML-version;</bridgehead>
753
754 <indexterm zone="perl-modules perl-yaml">
755 <primary sortas="a-YAML">YAML</primary>
756 </indexterm>
757
758 <para>The <application>YAML</application> modules implement a
759 <application>YAML</application> Loader and Dumper based on the
760 <application>YAML</application> 1.0 specification
761 <ulink url="http://www.yaml.org/spec/"/>.
762 <application>YAML</application> is a generic data serialization language
763 that is optimized for human readability. It can be used to express the data
764 structures of most modern programming languages. The module and
765 dependencies are installed using the standard
766 <application>Perl</application> module
767 <xref linkend="perl-standard-install"/>.</para>
768
769 <note>
770 <para>The <application>YAML</application>,
771 <application>Test::Base</application> and
772 <application>Spiffy</application> modules will install UTF-8
773 encoded manual pages. To modify the manual pages so that non-UTF-8
774 encoded pages are installed, issue the following commands (before
775 any other build commands):</para>
776
777<screen><literal>For <application>Spiffy</application>: <command>sed -i 's,\xc3\xb6,o,' lib/Spiffy.pm</command>
778
779For <application>Test::Base</application>: <command>sed -i 's,\xc3\xb6,o,' \
780 lib/Test/Base{,/Filter}.pm \
781 lib/Module/Install/TestBase.pm</command>
782
783For <application>YAML</application>: <command>sed -i 's,\xc3\xb6,o,' \
784 ysh \
785 lib{,/Test}/YAML.pm \
786 lib/YAML/{Types,Node,Error,Marshall,Tag,Base}.pm \
787 lib/YAML/{Loader,Dumper}{,/Base}.pm</command></literal></screen>
788
789 </note>
790
791 <itemizedlist>
792 <listitem>
793 <para>
794 <ulink url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
795 YAML-&YAML-version;</ulink></para>
796 <itemizedlist>
797 <listitem>
798 <para>
799 <ulink url="http://cpan.org/authors/id/I/IN/INGY/Test-Base-&Test-Base-version;.tar.gz">
800 Test-Base-&Test-Base-version;</ulink>
801 (optionally used during the tests)
802 </para>
803 <itemizedlist>
804 <listitem>
805 <para
806 <ulink url="http://cpan.org/authors/id/I/IN/INGY/Spiffy-&Spiffy-version;.tar.gz">
807 Spiffy-&Spiffy-version;</ulink></para>
808 </listitem>
809 </itemizedlist>
810 </listitem>
811 <listitem>
812 <para>
813 <xref linkend="perl-text-diff"/>
814 (optionally used during the tests)
815 </para>
816 </listitem>
817 </itemizedlist>
818 </listitem>
819 </itemizedlist>
820 -->
821
822 </sect2>
823
824 <sect2 role="installation" id="perl-standard-install"
825 xreflabel="build and installation instructions">
826 <title>Standard Installation of Perl Modules</title>
827
828 <para>Install <application>Perl</application> modules by running the
829 following commands:</para>
830
831<screen><userinput>perl Makefile.PL &amp;&amp;
832make &amp;&amp;
833make test</userinput></screen>
834
835 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
836
837<screen role="root"><userinput>make install</userinput></screen>
838
839 <note>
840 <para>When reinstalling a <application>Perl</application> module,
841 sometimes older versions of the module being reinstalled are in other
842 directories specified in <parameter>@INC</parameter>. To delete all
843 other versions of the module being reinstalled (not simply older ones)
844 set the <varname>UNINST</varname> variable:</para>
845
846<screen><userinput>make install UNINST=1</userinput></screen>
847 </note>
848
849 </sect2>
850
851 <sect2 role="installation" id="perl-auto-install"
852 xreflabel="alternate auto installation instructions">
853 <title>(Alternate) Auto Installation of Perl Modules.</title>
854
855 <para>There is an alternate way of installing the modules using the
856 <command>cpan</command> shell <command>install</command> command. The
857 command automatically downloads the source from the CPAN archive, extracts
858 it, runs the compilation, testing and installation commands mentioned
859 above, and removes the build source tree. You may still need to install
860 dependent library packages before running the automated installation
861 method.</para>
862
863 <para>The first time you run <command>cpan</command>, you'll be prompted
864 to enter some information regarding download locations and methods. This
865 information is retained in files located in
866 <filename class='directory'>~/.cpan</filename>. Start the
867 <command>cpan</command> shell by issuing '<command>cpan</command>' as the
868 <systemitem class="username">root</systemitem> user. Any module may now be
869 installed from the
870 <emphasis role='underlined'><prompt>cpan&gt;&nbsp;</prompt></emphasis>
871 prompt with the command:</para>
872
873<screen role="root"><userinput>install <replaceable>&lt;Module::Name&gt;</replaceable></userinput></screen>
874
875 <para>For additional commands and help, issue '<command>help</command>'
876 from the
877 <emphasis role='underlined'><prompt>cpan&gt;&nbsp;</prompt></emphasis>
878 prompt.</para>
879
880 <para>Alternatively, for scripted or non-interactive installations, use the
881 following syntax as the
882 <systemitem class="username">root</systemitem> user to install one or more
883 modules:</para>
884
885<screen role="root"><userinput>cpan -i <replaceable>&lt;Module1::Name&gt; &lt;Module2::Name&gt;</replaceable></userinput></screen>
886
887 <para>Review the <filename>cpan.1</filename> man page for additional
888 parameters you can pass to <command>cpan</command> on the command
889 line.</para>
890
891 </sect2>
892
893</sect1>
Note: See TracBrowser for help on using the repository browser.