source: general/prog/perl-modules.xml@ 0c7a769

gnome
Last change on this file since 0c7a769 was 0d21fc34, checked in by Christopher Gregory <cjg@…>, 10 years ago

Added new pages bogofilter evolution gthkhtml highlight and new perlmodule spamassassin

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