newxml/chapter06/perl.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3CR2//EN" "http://www.docbook.org/xml/4.3CR2/docbookx.dtd" [
   3   <!ENTITY % perl-entities SYSTEM "../ent/perl.ent">
   4   %perl-entities;
   5 ]>
   6 <sect1 id="ch06-perl">
   7 <title>Installing Perl-&perl-version;</title>
   8 <?dbhtml filename="perl.html"?>
   9
  10 <screen>Estimated build time:           2.9 SBU
  11 Estimated required disk space:  143 MB</screen>
  12
  13 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/perl-contents.xml"/>
  14
  15
  16 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/perl-deps.xml"/>
  17
  18
  19
  20 <sect2>
  21 <title>Installation of Perl</title>
  22
  23 <para>Prepare Perl for compilation:</para>
  24
  25 <screen><userinput>./configure.gnu --prefix=/usr -Dpager="/bin/less -isR"</userinput></screen>
  26
  27 <para>If you want more control over the way Perl sets itself up to be
  28 built, you can run the interactive <userinput>Configure</userinput> script
  29 instead and modify the way Perl is built. If you think you can live with the
  30 (sensible) defaults Perl auto-detects, then just use the command listed
  31 above.</para>
  32
  33 <para>The meaning of the configure option:</para>
  34
  35 <itemizedlist>
  36 <listitem><para><userinput>-Dpager="/bin/less -isR"</userinput>: This corrects
  37 an error in the perldoc code with the invocation of the less
  38 program.</para></listitem>
  39 </itemizedlist>
  40
  41 <para>Compile the package:</para>
  42
  43 <screen><userinput>make</userinput></screen>
  44
  45 <para>This package has a test suite available which can perform a number of
  46 checks to ensure it built correctly.  Should you choose to run it, you first
  47 have to create a basic <filename>/etc/hosts</filename> file, needed by a
  48 couple of tests to resolve the name <emphasis>localhost</emphasis>:</para>
  49
  50 <screen><userinput>echo "127.0.0.1 localhost $(hostname)" &gt; /etc/hosts</userinput></screen>
  51
  52 <para>Now run the tests, if you wish:</para>
  53
  54 <screen><userinput>make test</userinput></screen>
  55
  56 <para>And install the package:</para>
  57
  58 <screen><userinput>make install</userinput></screen>
  59
  60 </sect2>
  61
  62 </sect1>