source: general/prog/new-perl-modules.xml@ 6df794d

perl-modules
Last change on this file since 6df794d was 6df794d, checked in by Ken Moffat <ken@…>, 4 years ago

perl-modules branch: Reduce perl-alternatives.xml to only cover the cpan automated install, and index that under cpan. Add a note to remind me to deal with Data::Uniquid and the unsafe variant of the standard install.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/perl-modules@20485 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 4.4 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
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-text-bibtex"/>
107 </para>
108 </listitem>
109 <!-- Build and install options always come at the end, but one of
110 them is perl-build-install so call the set perl-alternatives -->
111 <listitem>
112 <para>
113 <xref linkend="perl-alternatives"/>
114 </para>
115 </listitem>
116 </itemizedlist>
117 </sect2>
118
119 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
120 href="perl-modules/perl-archive-zip.xml"/>
121
122 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
123 href="perl-modules/perl-autovivification.xml"/>
124
125 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
126 href="perl-modules/perl-business-issn.xml"/>
127
128 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
129 href="perl-modules/perl-module-build.xml"/>
130
131 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
132 href="perl-modules/perl-text-bibtex.xml"/>
133
134 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
135 href="perl-alternatives.xml"/>
136
137</sect1>
Note: See TracBrowser for help on using the repository browser.