BOOK/chapter06/texinfo.xml

   1 <sect1 id="ch-system-texinfo" xreflabel="Texinfo">
   2 <title>Installing Texinfo-&texinfo-version;</title>
   3 <?dbhtml filename="texinfo.html" dir="chapter06"?>
   4
   5 <para>The Texinfo package contains programs for reading, writing, and
   6 converting Info documents.</para>
   7
   8 <screen>&buildtime; &texinfo-time;
   9 &diskspace; &texinfo-compsize;</screen>
  10
  11 &aa-texinfo-down;
  12 &aa-texinfo-dep;
  13
  14 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
  15
  16 <sect2>
  17 <title>Installation of Texinfo</title>
  18
  19 <para>Prepare Texinfo for compilation:</para>
  20
  21 <screen><userinput>./configure --prefix=/usr</userinput></screen>
  22
  23 <para>Compile the package:</para>
  24
  25 <screen><userinput>make</userinput></screen>
  26
  27 <para>This package has a test suite available which can perform a number of
  28 checks to ensure it built correctly.  Should you choose to run it, the
  29 following command will do so:</para>
  30
  31 <screen><userinput>make check</userinput></screen>
  32
  33 <para>Install the package:</para>
  34
  35 <screen><userinput>make install</userinput></screen>
  36
  37 <para>And optionally install the components belonging in a TeX installation:</para>
  38
  39 <screen><userinput>make TEXMF=/usr/share/texmf install-tex</userinput></screen>
  40
  41 <para>The meaning of the make parameter:</para>
  42
  43 <itemizedlist>
  44 <listitem><para><userinput>TEXMF=/usr/share/texmf</userinput>: The TEXMF
  45 makefile variable holds the location of the root of your TeX tree if, for
  46 example, you plan to install a TeX package later on.</para></listitem>
  47 </itemizedlist>
  48
  49 <para>The Info documentation system uses a plain text file to hold its list of
  50 menu entries. The file is located at <filename>/usr/share/info/dir</filename>.
  51 Unfortunately, due to occasional problems in the Makefiles of various packages,
  52 it can sometimes get out of step with the Info manuals actually installed on the
  53 system. If ever you need to recreate the
  54 <filename>/usr/share/info/dir</filename> file, the following optional commands
  55 will accomplish the task:</para>
  56
  57 <screen><userinput>cd /usr/share/info
  58 rm dir
  59 for f in *
  60 do install-info $f dir 2>/dev/null
  61 done</userinput></screen>
  62
  63 </sect2>
  64
  65 &aa-texinfo-shortdesc;
  66 &aa-texinfo-desc;
  67
  68 </sect1>
  69