chapter05/perl.xml

   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="ch-tools-perl" role="wrap">
   9   <?dbhtml filename="perl.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>perl</productname>
  13     <productnumber>&perl-version;</productnumber>
  14     <address>&perl-url;</address>
  15   </sect1info>
  16
  17   <title>Perl-&perl-version;</title>
  18
  19   <indexterm zone="ch-tools-perl">
  20     <primary sortas="a-Perl">Perl</primary>
  21     <secondary>tools</secondary>
  22   </indexterm>
  23
  24   <sect2 role="package">
  25     <title/>
  26
  27     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  28     href="../chapter06/perl.xml"
  29     xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
  30
  31     <segmentedlist>
  32       <segtitle>&buildtime;</segtitle>
  33       <segtitle>&diskspace;</segtitle>
  34
  35       <seglistitem>
  36         <seg>&perl-ch5-sbu;</seg>
  37         <seg>&perl-ch5-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Perl</title>
  45
  46     <para>Prepare Perl for compilation:</para>
  47
  48 <screen><userinput remap="configure">sh Configure -des -Dprefix=/tools -Dlibs=-lm -Uloclibpth -Ulocincpth</userinput></screen>
  49
  50     <variablelist>
  51       <title>The meaning of the Configure options:</title>
  52
  53       <varlistentry>
  54         <term><parameter>-des</parameter></term>
  55         <listitem>
  56           <para>This is a combination of three options: -d uses defaults for
  57           all items; -e ensures completion of all tasks; -s silences
  58           non-essential output.</para>
  59         </listitem>
  60       </varlistentry>
  61
  62       <varlistentry>
  63         <term>
  64           <parameter>-Uloclibpth</parameter> and
  65           <parameter>-Ulocincpth</parameter>
  66         </term>
  67         <listitem>
  68           <para>These entries undefine variables that cause the configuration
  69           to search for locally installed components that may exist on the
  70           host system.</para>
  71         </listitem>
  72       </varlistentry>
  73
  74     </variablelist>
  75
  76
  77
  78
  79     <para>Build the package:</para>
  80
  81 <screen><userinput remap="make">make</userinput></screen>
  82
  83     <para>Although Perl comes with a test suite, it would be better to wait
  84     until it is installed in the next chapter.</para>
  85
  86     <para>Only a few of the utilities and libraries need to be installed at this
  87     time:</para>
  88
  89 <screen><userinput remap="install">cp -v perl cpan/podlators/scripts/pod2man /tools/bin
  90 mkdir -pv /tools/lib/perl5/&perl-version;
  91 cp -Rv lib/* /tools/lib/perl5/&perl-version;</userinput></screen>
  92
  93   </sect2>
  94
  95   <sect2 role="content">
  96     <title/>
  97
  98     <para>Details on this package are located in
  99     <xref linkend="contents-perl" role="."/></para>
 100
 101   </sect2>
 102
 103 </sect1>