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><parameter>-Uloclibpth amd -Ulocincpth</parameter></term>
  64         <listitem>
  65           <para>These entries undefine variables that cause the configuration
  66           to search for locally installed components that may exist on the
  67           host system.</para>
  68         </listitem>
  69       </varlistentry>
  70
  71     </variablelist>
  72
  73
  74
  75
  76     <para>Build the package:</para>
  77
  78 <screen><userinput remap="make">make</userinput></screen>
  79
  80     <para>Although Perl comes with a test suite, it would be better to wait
  81     until it is installed in the next chapter.</para>
  82
  83     <para>Only a few of the utilities and libraries need to be installed at this
  84     time:</para>
  85
  86 <screen><userinput remap="install">cp -v perl cpan/podlators/scripts/pod2man /tools/bin
  87 mkdir -pv /tools/lib/perl5/&perl-version;
  88 cp -Rv lib/* /tools/lib/perl5/&perl-version;</userinput></screen>
  89
  90   </sect2>
  91
  92   <sect2 role="content">
  93     <title/>
  94
  95     <para>Details on this package are located in
  96     <xref linkend="contents-perl" role="."/></para>
  97
  98   </sect2>
  99
 100 </sect1>