source: chapter06/texinfo.xml@ 9c9d585

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE section [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<section xmlns="http://docbook.org/docbook-ng"
         xml:id="ch-system-texinfo" xreflabel="Texinfo" role="wrap">
<info><title>Texinfo-&texinfo-version;</title></info>
<?dbhtml filename="texinfo.html"?>

<indexterm zone="ch-system-texinfo"><primary sortas="a-Texinfo">Texinfo</primary></indexterm>

<section role="package"><info><title/></info>
<para>The Texinfo package contains programs for reading, writing, and
converting Info documents.</para>

<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>17 MB</seg></seglistitem>
</segmentedlist>

<segmentedlist>
<segtitle>Texinfo installation depends on</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, GCC, Gettext, Glibc, Grep, Make, Ncurses, Sed</seg></seglistitem>
</segmentedlist>
</section>

<section role="installation">
<info><title>Installation of Texinfo</title></info>

<para>Prepare Texinfo for compilation:</para>

<para>The patch listed below fixes a known segfault in texinfo:</para>

<screen><userinput>patch -Np1 -i ../texinfo-&texinfo-version;-segfault-1.patch</userinput></screen>

<para>Prepare Texinfo for compilation:</para>

<screen><userinput>./configure --prefix=/usr</userinput></screen>

<para>Compile the package:</para>

<screen><userinput>make</userinput></screen>

<para>To test the results, issue:
<userinput>make check</userinput>.</para>

<para>Install the package:</para>

<screen><userinput>make install</userinput></screen>

<para>Optionally install the components belonging in a TeX installation:</para>

<screen><userinput>make TEXMF=/usr/share/texmf install-tex</userinput></screen>

<para>The meaning of the make parameter:</para>

<variablelist>
<varlistentry>
<term><parameter>TEXMF=/usr/share/texmf</parameter></term>
<listitem><para>The TEXMF
makefile variable holds the location of the root of your TeX tree if, for
example, you plan to install a TeX package later on.</para></listitem>
</varlistentry>
</variablelist>

<para>The Info documentation system uses a plain text file to hold its list of
menu entries. The file is located at <filename>/usr/share/info/dir</filename>.
Unfortunately, due to occasional problems in the Makefiles of various packages,
it can sometimes get out of step with the Info manuals actually installed on the
system. If ever you need to recreate the
<filename>/usr/share/info/dir</filename> file, the following optional commands
will accomplish the task:</para>

<screen><userinput>cd /usr/share/info
rm dir
for f in *
do install-info $f dir 2&gt;/dev/null
done</userinput></screen>

</section>


<section xml:id="contents-texinfo" role="content"><info><title>Contents of Texinfo</title></info>

<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>info, infokey, install-info,
makeinfo, texi2dvi and texindex</seg></seglistitem>
</segmentedlist>

<variablelist><title>Short descriptions</title>

<varlistentry xml:id="info">
<term><command>info</command></term>
<listitem>
<indexterm zone="ch-system-texinfo info"><primary sortas="b-info">info</primary></indexterm>
<para>is used to read Info documents. Info
documents are a bit like man pages, but often go much deeper than just
explaining all the flags. Compare for example <command>man tar</command>
and <command>info tar</command>.</para>
</listitem>
</varlistentry>

<varlistentry xml:id="infokey">
<term><command>infokey</command></term>
<listitem>
<indexterm zone="ch-system-texinfo infokey"><primary sortas="b-infokey">infokey</primary></indexterm>
<para>compiles a source file containing Info
customizations into a binary format.</para>
</listitem>
</varlistentry>

<varlistentry xml:id="install-info">
<term><command>install-info</command></term>
<listitem>
<indexterm zone="ch-system-texinfo install-info"><primary sortas="b-install-info">install-info</primary></indexterm>
<para>is used to install Info files. It updates entries in the Info index file.</para>
</listitem>
</varlistentry>

<varlistentry xml:id="makeinfo">
<term><command>makeinfo</command></term>
<listitem>
<indexterm zone="ch-system-texinfo makeinfo"><primary sortas="b-makeinfo">makeinfo</primary></indexterm>
<para>translates the given Texinfo source
documents into various other formats: Info files, plain text, or HTML.</para>
</listitem>
</varlistentry>

<varlistentry xml:id="texi2dvi">
<term><command>texi2dvi</command></term>
<listitem>
<indexterm zone="ch-system-texinfo texi2dvi"><primary sortas="b-texi2dvi">texi2dvi</primary></indexterm>
<para>is used to format the given Texinfo
document into a device-independent file that can be printed.</para>
</listitem>
</varlistentry>

<varlistentry xml:id="texindex">
<term><command>texindex</command></term>
<listitem>
<indexterm zone="ch-system-texinfo texindex"><primary sortas="b-texindex">texindex</primary></indexterm>
<para>is used to sort Texinfo index files.</para>
</listitem>
</varlistentry>
</variablelist>

</section>

</section>