newxml/chapter06/texinfo.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 % texinfo-entities SYSTEM "../ent/texinfo.ent">
   4   %texinfo-entities;
   5 ]>
   6 <sect1 id="ch06-texinfo">
   7 <title>Installing Texinfo-&texinfo-version;</title>
   8 <?dbhtml filename="texinfo.html"?>
   9
  10 <screen>Estimated build time:           0.2 SBU
  11 Estimated required disk space:  17 MB</screen>
  12
  13 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/texinfo-contents.xml"/>
  14
  15
  16 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/texinfo-deps.xml"/>
  17
  18
  19
  20 <sect2>
  21 <title>Installation of Texinfo</title>
  22
  23 <para>Prepare Texinfo for compilation:</para>
  24
  25 <screen><userinput>./configure --prefix=/usr</userinput></screen>
  26
  27 <para>Compile the package:</para>
  28
  29 <screen><userinput>make</userinput></screen>
  30
  31 <para>This package has a test suite available which can perform a number of
  32 checks to ensure it built correctly.  Should you choose to run it, the
  33 following command will do so:</para>
  34
  35 <screen><userinput>make check</userinput></screen>
  36
  37 <para>Install the package:</para>
  38
  39 <screen><userinput>make install</userinput></screen>
  40
  41 <para>And optionally install the components belonging in a TeX installation:</para>
  42
  43 <screen><userinput>make TEXMF=/usr/share/texmf install-tex</userinput></screen>
  44
  45 <para>The meaning of the make parameter:</para>
  46
  47 <itemizedlist>
  48 <listitem><para><userinput>TEXMF=/usr/share/texmf</userinput>: The TEXMF
  49 makefile variable holds the location of the root of your TeX tree if, for
  50 example, you plan to install a TeX package later on.</para></listitem>
  51 </itemizedlist>
  52
  53 <para>The Info documentation system uses a plain text file to hold its list of
  54 menu entries. The file is located at <filename>/usr/share/info/dir</filename>.
  55 Unfortunately, due to occasional problems in the Makefiles of various packages,
  56 it can sometimes get out of step with the Info manuals actually installed on the
  57 system. If ever you need to recreate the
  58 <filename>/usr/share/info/dir</filename> file, the following optional commands
  59 will accomplish the task:</para>
  60
  61 <screen><userinput>cd /usr/share/info
  62 rm dir
  63 for f in *
  64 do install-info $f dir 2&gt;/dev/null
  65 done</userinput></screen>
  66
  67 </sect2>
  68
  69 </sect1>