chapter06/texinfo.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

<sect1 id="ch06-texinfo" xreflabel="Texinfo">
<title>Installing Texinfo-&texinfo-version;</title>
<?dbhtml filename="texinfo.html" dir="chapter06"?>

<para>The Texinfo package contains programs for reading, writing, and
converting Info documents.</para>

<screen>&buildtime; &texinfo-time;
&diskspace; &texinfo-compsize;</screen>

&aa-texinfo-down;
&aa-texinfo-dep;

<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>

<sect2>
<title>Installation of Texinfo</title>

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

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

<para>Compile the package:</para>

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

<para>This package has a test suite available which can perform a number of
checks to ensure it built correctly.  Should you choose to run it, the 
following command will do so:</para>

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

<para>Install the package:</para>

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

<para>And 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>

<itemizedlist>
<listitem><para><userinput>TEXMF=/usr/share/texmf</userinput>: 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>
</itemizedlist>

<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>/dev/null
done</userinput></screen>

</sect2>

&aa-texinfo-shortdesc;
&aa-texinfo-desc;

</sect1>