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

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 cd7cf72 was cd7cf72, checked in by Fernando de Oliveira <fernando@…>, 10 years ago

SGMLSpm-1.1: Fix URL.

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