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

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

New branch for testing changes to perl modules.

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

  • Property mode set to 100644
File size: 4.1 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 There are a number of different ways of installing perl modules, they are
60 listed at the end of this page.
61 </para>
62
63 <para>
64 Most of these modules only install files below <filename
65 class="directory">/usr/lib/perl5/site_perl/5.xx.y</filename> and those will
66 not be documented. One or two install programs (mostly, perl scripts), or
67 even a library, into <filename class="directory">/usr</filename> and those
68 are documented.
69 </para>
70
71 <para condition="html" role="usernotes">User Notes:
72 <ulink url="&blfs-wiki;/perl-modules"/>
73 </para>
74
75 <itemizedlist spacing="compact">
76 <listitem>
77 <para>
78 <xref linkend="new-perl-archive-zip"/>
79 </para>
80 </listitem>
81 <listitem>
82 <para>
83 <xref linkend="new-perl-autovivification"/>
84 </para>
85 </listitem>
86 <listitem>
87 <para>
88 <xref linkend="new-perl-business-issn"/>
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 <xref linkend="new-perl-module-build"/>
94 </para>
95 </listitem>
96 <listitem>
97 <para>
98 <xref linkend="new-perl-text-bibtex"/>
99 </para>
100 </listitem>
101 <!-- Build and install options always come at the end, but one of
102 them is perl-build-install so call the set perl-alternatives -->
103 <listitem>
104 <para>
105 <xref linkend="perl-alternatives"/>
106 </para>
107 </listitem>
108 </itemizedlist>
109 </sect2>
110
111 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
112 href="perl-modules/perl-archive-zip.xml"/>
113
114 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
115 href="perl-modules/perl-autovivification.xml"/>
116
117 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
118 href="perl-modules/perl-business-issn.xml"/>
119
120 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
121 href="perl-modules/perl-module-build.xml"/>
122
123 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
124 href="perl-modules/perl-text-bibtex.xml"/>
125
126 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
127 href="perl-alternatives.xml"/>
128
129</sect1>
Note: See TracBrowser for help on using the repository browser.