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 |
|
---|
8 | <sect1 id="new-perl-modules" xreflabel="Perl Modules (new page)">
|
---|
9 | <?dbhtml filename="new-perl-modules.html" ?>
|
---|
10 |
|
---|
11 | <sect1info>
|
---|
12 | <othername>$LastChangedBy$</othername>
|
---|
13 | <date>$Date$</date>
|
---|
14 | </sect1info>
|
---|
15 |
|
---|
16 | <title>Perl Modules (new page)</title>
|
---|
17 |
|
---|
18 | <indexterm zone="new-perl-modules">
|
---|
19 | <primary sortas="a-new-perl-Modules">Perl Modules</primary>
|
---|
20 | </indexterm>
|
---|
21 |
|
---|
22 | <sect2 role="package">
|
---|
23 | <title>Introduction to Perl Modules</title>
|
---|
24 |
|
---|
25 | <para>
|
---|
26 | The <application>Perl</application> module packages (also referred to as
|
---|
27 | Distributions, because each can contain multiple modules) add useful
|
---|
28 | objects to the <application>Perl</application> language. The packages
|
---|
29 | listed on this page are required or recommended for other packages in
|
---|
30 | the book. If they have dependent modules, those are either on this page
|
---|
31 | or else on the next page.
|
---|
32 | </para>
|
---|
33 |
|
---|
34 | <para>
|
---|
35 | Modules utilized by packages throughout BLFS are listed here, along with
|
---|
36 | their dependencies. The various ways of building and installing perl
|
---|
37 | modules are shown at the bottom of this page.
|
---|
38 | </para>
|
---|
39 |
|
---|
40 | <para>
|
---|
41 | In many cases, only the required or recommended dependencies are listed -
|
---|
42 | there might be other modules which allow more tests to be run, but
|
---|
43 | omitting them will still allow the tests to <literal>PASS</literal>.
|
---|
44 | </para>
|
---|
45 |
|
---|
46 | <para>
|
---|
47 | For a few modules, the BLFS editors have determined that other modules
|
---|
48 | still listed as prerequisites are not required, and omitted them.
|
---|
49 | </para>
|
---|
50 |
|
---|
51 | <para>
|
---|
52 | It is generally worth running the tests for perl modules, they often
|
---|
53 | can show problems such as missing dependencies which are required to
|
---|
54 | use the module. In some cases, such dependencies are marked as
|
---|
55 | '(for the testsuite)'.
|
---|
56 | </para>
|
---|
57 |
|
---|
58 | <para>
|
---|
59 | It is possible to automatically install the current version of a module and
|
---|
60 | any missing or too-old dependencies using CPAN. See the end of this page for
|
---|
61 | details.
|
---|
62 | </para>
|
---|
63 |
|
---|
64 | <para>
|
---|
65 | Most of these modules only install files below <filename
|
---|
66 | class="directory">/usr/lib/perl5/site_perl/5.xx.y</filename> and those will
|
---|
67 | not be documented. One or two install programs (mostly, perl scripts), or
|
---|
68 | even a library, into <filename class="directory">/usr</filename> and those
|
---|
69 | are documented.
|
---|
70 | </para>
|
---|
71 |
|
---|
72 | <note>
|
---|
73 | <para>
|
---|
74 | This is a reminder to an editor to deal with Data-Uniquid (needs patch) and
|
---|
75 | those modules which use the unsafe variant of the standard install.
|
---|
76 | </para>
|
---|
77 | </note>
|
---|
78 |
|
---|
79 | <para condition="html" role="usernotes">User Notes:
|
---|
80 | <ulink url="&blfs-wiki;/perl-modules"/>
|
---|
81 | </para>
|
---|
82 |
|
---|
83 | <itemizedlist spacing="compact">
|
---|
84 | <listitem>
|
---|
85 | <para>
|
---|
86 | <xref linkend="new-perl-archive-zip"/>
|
---|
87 | </para>
|
---|
88 | </listitem>
|
---|
89 | <listitem>
|
---|
90 | <para>
|
---|
91 | <xref linkend="new-perl-autovivification"/>
|
---|
92 | </para>
|
---|
93 | </listitem>
|
---|
94 | <listitem>
|
---|
95 | <para>
|
---|
96 | <xref linkend="new-perl-business-issn"/>
|
---|
97 | </para>
|
---|
98 | </listitem>
|
---|
99 | <listitem>
|
---|
100 | <para>
|
---|
101 | <xref linkend="new-perl-module-build"/>
|
---|
102 | </para>
|
---|
103 | </listitem>
|
---|
104 | <listitem>
|
---|
105 | <para>
|
---|
106 | <xref linkend="new-perl-sgmlspm"/>
|
---|
107 | </para>
|
---|
108 | </listitem>
|
---|
109 | <listitem>
|
---|
110 | <para>
|
---|
111 | <xref linkend="new-perl-text-bibtex"/>
|
---|
112 | </para>
|
---|
113 | </listitem>
|
---|
114 | <!-- alternative cpan installation stays at the end -->
|
---|
115 | <listitem>
|
---|
116 | <para>
|
---|
117 | <xref linkend="perl-alternatives"/>
|
---|
118 | </para>
|
---|
119 | </listitem>
|
---|
120 | </itemizedlist>
|
---|
121 | </sect2>
|
---|
122 |
|
---|
123 | <!-- and keep these i nthe same order as above -->
|
---|
124 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
125 | href="perl-modules/perl-archive-zip.xml"/>
|
---|
126 |
|
---|
127 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
128 | href="perl-modules/perl-autovivification.xml"/>
|
---|
129 |
|
---|
130 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
131 | href="perl-modules/perl-business-issn.xml"/>
|
---|
132 |
|
---|
133 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
134 | href="perl-modules/perl-module-build.xml"/>
|
---|
135 |
|
---|
136 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
137 | href="perl-modules/perl-sgmlspm.xml"/>
|
---|
138 |
|
---|
139 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
140 | href="perl-modules/perl-text-bibtex.xml"/>
|
---|
141 |
|
---|
142 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
143 | href="perl-alternatives.xml"/>
|
---|
144 |
|
---|
145 | </sect1>
|
---|