BOOK/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/2003/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>First apply the following patch to address security issues and adapt
  47     some hard-wired paths to the C library:</para>
  48
  49 <screen><userinput remap="pre">patch -Np1 -i ../&perl-consolidated-patch;</userinput></screen>
  50
  51     <!-- <para>Fix an incompatibility with gcc-&gcc-version;:</para>
  52
  53 <screen><userinput remap="pre">mv -v makedepend.SH{,.orig}
  54 sed 's/command /command[ -]/' makedepend.SH.orig &gt; makedepend.SH</userinput></screen> -->
  55
  56     <para>Prepare Perl for compilation (make sure to get the
  57     'Data/Dumper Fcntl IO POSIX' part of the command correct&mdash;they are all
  58     letters):</para>
  59
  60 <screen><userinput remap="configure">sh Configure -des -Dprefix=/tools \
  61                   -Dstatic_ext='Data/Dumper Fcntl IO POSIX'</userinput></screen>
  62
  63     <variablelist>
  64       <title>The meaning of the configure options:</title>
  65
  66       <varlistentry>
  67         <term><parameter>-Dstatic_ext='Data/Dumper Fcntl IO POSIX'</parameter></term>
  68         <listitem>
  69           <para>This tells Perl to build the minimum set of static extensions
  70           needed for installing and testing the Coreutils and Glibc packages in the
  71           next chapter.</para>
  72         </listitem>
  73       </varlistentry>
  74
  75     </variablelist>
  76
  77     <para>Only a few of the utilities contained in this package, and one of its
  78     libraries, need to be built:</para>
  79
  80 <screen><userinput remap="make">make perl utilities ext/Errno/pm_to_blib</userinput></screen>
  81
  82     <para>Although Perl comes with a test suite, it is not recommended to
  83     run it at this point. Only part of Perl was built and running
  84     <command>make test</command> now will cause the rest of Perl to be
  85     built as well, which is unnecessary at this point. The test suite can
  86     be run in the next chapter if desired.</para>
  87
  88     <para>Install these tools and their libraries:</para>
  89
  90 <screen><userinput remap="install">cp -v perl pod/pod2man /tools/bin
  91 mkdir -pv /tools/lib/perl5/&perl-version;
  92 cp -Rv lib/* /tools/lib/perl5/&perl-version;</userinput></screen>
  93
  94   </sect2>
  95
  96   <sect2 role="content">
  97     <title/>
  98
  99     <para>Details on this package are located in
 100     <xref linkend="contents-perl" role="."/></para>
 101
 102   </sect2>
 103
 104 </sect1>