Files
master/chapter06/texinfo.html
2015-05-23 18:50:06 +08:00

353 lines
12 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content=
"application/xhtml+xml; charset=utf-8" />
<title>
6.68.&nbsp;Texinfo-5.2
</title>
<link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
<link rel="stylesheet" href="../stylesheets/lfs-print.css" type="text/css"
media="print" />
</head>
<body class="lfs" id="lfs-7.7-systemd">
<div class="navheader">
<h4>
Linux From Scratch - Version 7.7-systemd
</h4>
<h3>
Chapter&nbsp;6.&nbsp;Installing Basic System Software
</h3>
<ul>
<li class="prev">
<a accesskey="p" href="tar.html" title="Tar-1.28">Prev</a>
<p>
Tar-1.28
</p>
</li>
<li class="next">
<a accesskey="n" href="vim.html" title="Vim-7.4">Next</a>
<p>
Vim-7.4
</p>
</li>
<li class="up">
<a accesskey="u" href="chapter06.html" title=
"Chapter&nbsp;6.&nbsp;Installing Basic System Software">Up</a>
</li>
<li class="home">
<a accesskey="h" href="../index.html" title=
"Linux From Scratch - Version 7.7-systemd">Home</a>
</li>
</ul>
</div>
<div class="wrap" lang="en" xml:lang="en">
<h1 class="sect1">
<a id="ch-system-texinfo" name="ch-system-texinfo"></a>6.68.
Texinfo-5.2
</h1>
<div class="package" lang="en" xml:lang="en">
<p>
The Texinfo package contains programs for reading, writing, and
converting info pages.
</p>
<div class="segmentedlist">
<div class="seglistitem">
<div class="seg">
<strong class="segtitle">Approximate build time:</strong>
<span class="segbody">0.5 SBU</span>
</div>
<div class="seg">
<strong class="segtitle">Required disk space:</strong>
<span class="segbody">109 MB</span>
</div>
</div>
</div>
</div>
<div class="installation" lang="en" xml:lang="en">
<h2 class="sect2">
6.68.1. Installation of Texinfo
</h2>
<p>
Prepare Texinfo for compilation:
</p>
<pre class="userinput">
<kbd class="command">./configure --prefix=/usr</kbd>
</pre>
<p>
Compile the package:
</p>
<pre class="userinput">
<kbd class="command">make</kbd>
</pre>
<p>
To test the results, issue:
</p>
<pre class="userinput">
<kbd class="command">make check</kbd>
</pre>
<p>
Install the package:
</p>
<pre class="userinput">
<kbd class="command">make install</kbd>
</pre>
<p>
Optionally, install the components belonging in a TeX installation:
</p>
<pre class="userinput">
<kbd class="command">make TEXMF=/usr/share/texmf install-tex</kbd>
</pre>
<div class="variablelist">
<p class="title">
<strong>The meaning of the make parameter:</strong>
</p>
<dl class="variablelist">
<dt>
<span class="term"><em class=
"parameter"><code>TEXMF=/usr/share/texmf</code></em></span>
</dt>
<dd>
<p>
The <code class="envar">TEXMF</code> makefile variable holds
the location of the root of the TeX tree if, for example, a
TeX package will be installed later.
</p>
</dd>
</dl>
</div>
<p>
The Info documentation system uses a plain text file to hold its
list of menu entries. The file is located at <code class=
"filename">/usr/share/info/dir</code>. Unfortunately, due to
occasional problems in the Makefiles of various packages, it can
sometimes get out of sync with the info pages installed on the
system. If the <code class="filename">/usr/share/info/dir</code>
file ever needs to be recreated, the following optional commands
will accomplish the task:
</p>
<pre class="userinput">
<kbd class="command">pushd /usr/share/info
rm -v dir
for f in *
do install-info $f dir 2&gt;/dev/null
done
popd</kbd>
</pre>
</div>
<div class="content" lang="en" xml:lang="en">
<h2 class="sect2">
<a id="contents-texinfo" name="contents-texinfo"></a>6.68.2.
Contents of Texinfo
</h2>
<div class="segmentedlist">
<div class="seglistitem">
<div class="seg">
<strong class="segtitle">Installed programs:</strong>
<span class="segbody">info, infokey, install-info, makeinfo
(link to texi2any), pdftexi2dvi, pod2texi, texi2any, texi2dvi,
texi2pdf, and texindex</span>
</div>
<div class="seg">
<strong class="segtitle">Installed directory:</strong>
<span class="segbody">/usr/share/texinfo</span>
</div>
</div>
</div>
<div class="variablelist">
<h3>
Short Descriptions
</h3>
<table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top" />
<col />
</colgroup>
<tbody>
<tr>
<td>
<p>
<a id="info" name="info"></a><span class=
"term"><span class=
"command"><strong>info</strong></span></span>
</p>
</td>
<td>
<p>
Used to read info pages which are similar to man pages,
but often go much deeper than just explaining all the
available command line options [For example, compare
<span class="command"><strong>man bison</strong></span>
and <span class="command"><strong>info
bison</strong></span>.]
</p>
</td>
</tr>
<tr>
<td>
<p>
<a id="infokey" name="infokey"></a><span class=
"term"><span class=
"command"><strong>infokey</strong></span></span>
</p>
</td>
<td>
<p>
Compiles a source file containing Info customizations
into a binary format
</p>
</td>
</tr>
<tr>
<td>
<p>
<a id="install-info" name="install-info"></a><span class=
"term"><span class=
"command"><strong>install-info</strong></span></span>
</p>
</td>
<td>
<p>
Used to install info pages; it updates entries in the
<span class="command"><strong>info</strong></span> index
file
</p>
</td>
</tr>
<tr>
<td>
<p>
<a id="makeinfo" name="makeinfo"></a><span class=
"term"><span class=
"command"><strong>makeinfo</strong></span></span>
</p>
</td>
<td>
<p>
Translates the given Texinfo source documents into info
pages, plain text, or HTML
</p>
</td>
</tr>
<tr>
<td>
<p>
<a id="pdftexi2dvi" name="pdftexi2dvi"></a><span class=
"term"><span class=
"command"><strong>pdftexi2dvi</strong></span></span>
</p>
</td>
<td>
<p>
Used to format the given Texinfo document into a Portable
Document Format (PDF) file
</p>
</td>
</tr>
<tr>
<td>
<p>
<a id="pod2texi" name="pod2texi"></a><span class=
"term"><span class=
"command"><strong>pod2texi</strong></span></span>
</p>
</td>
<td>
<p>
Converts Pod to Texinfo format
</p>
</td>
</tr>
<tr>
<td>
<p>
<a id="texi2any" name="texi2any"></a><span class=
"term"><span class=
"command"><strong>texi2any</strong></span></span>
</p>
</td>
<td>
<p>
Translate Texinfo source documentation to various other
formats
</p>
</td>
</tr>
<tr>
<td>
<p>
<a id="texi2dvi" name="texi2dvi"></a><span class=
"term"><span class=
"command"><strong>texi2dvi</strong></span></span>
</p>
</td>
<td>
<p>
Used to format the given Texinfo document into a
device-independent file that can be printed
</p>
</td>
</tr>
<tr>
<td>
<p>
<a id="texi2pdf" name="texi2pdf"></a><span class=
"term"><span class=
"command"><strong>texi2pdf</strong></span></span>
</p>
</td>
<td>
<p>
Used to format the given Texinfo document into a Portable
Document Format (PDF) file
</p>
</td>
</tr>
<tr>
<td>
<p>
<a id="texindex" name="texindex"></a><span class=
"term"><span class=
"command"><strong>texindex</strong></span></span>
</p>
</td>
<td>
<p>
Used to sort Texinfo index files
</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="navfooter">
<ul>
<li class="prev">
<a accesskey="p" href="tar.html" title="Tar-1.28">Prev</a>
<p>
Tar-1.28
</p>
</li>
<li class="next">
<a accesskey="n" href="vim.html" title="Vim-7.4">Next</a>
<p>
Vim-7.4
</p>
</li>
<li class="up">
<a accesskey="u" href="chapter06.html" title=
"Chapter&nbsp;6.&nbsp;Installing Basic System Software">Up</a>
</li>
<li class="home">
<a accesskey="h" href="../index.html" title=
"Linux From Scratch - Version 7.7-systemd">Home</a>
</li>
</ul>
</div>
</body>
</html>