glfs/pst/typesetting/tex.xml
Randy McMurchy 94b1dc3365 Renamed libtiff patch; added optional dependencies to TeX
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2851 af4574ff-66df-0310-9fd7-8a98e5e911e0
2004-10-20 14:08:55 +00:00

170 lines
6.7 KiB
XML

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY tex-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/current/distrib/tetex-src-&tex-version;.tar.gz">
<!ENTITY texmf-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/current/distrib/tetex-texmf-&tex-version;.tar.gz">
<!ENTITY texmfsrc-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/current/distrib/tetex-texmfsrc-&tex-version;.tar.gz">
<!ENTITY tex-size "64 MB">
<!ENTITY tex-optional-size "87 MB">
<!ENTITY tex-buildsize "344 MB">
<!ENTITY tex-optional-buildsize "415 MB">
<!ENTITY tex-time "1.82 SBU">
]>
<sect1 id="pst-typesetting-tex" xreflabel="TeX-&tex-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="tex.html"?>
<title>TeX-&tex-version;</title>
<sect2>
<title>Introduction to <application>TeX</application></title>
<para><application>TeX</application> is a typesetting package, able to create
documents in a variety of formats. The optional <filename>texmfsrc</filename>
<acronym>TAR</acronym> ball contains source code for packages that are
contained in the <filename>texmf</filename> <acronym>TAR</acronym> ball,
including the docstrip sources.</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Download (FTP): <ulink
url="&tex-download-ftp;"/></para></listitem>
<listitem><para>Required Download (FTP): <ulink
url="&texmf-download-ftp;"/></para></listitem>
<listitem><para>Optional Download (FTP): <ulink
url="&texmfsrc-download-ftp;"/></para></listitem>
<listitem><para>Download size:
&tex-size; (&tex-optional-size; with optional tarball)</para></listitem>
<listitem><para>Estimated Disk space required:
&tex-buildsize; (&tex-optional-buildsize; with optional tarball)</para>
</listitem>
<listitem><para>Estimated build time:
&tex-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Additional Downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch (if using Glibc >2.3.3): <ulink
url="&patch-root;/tetex-src-&tex-version;-flex-1.patch"/></para>
</listitem>
<listitem><para>Recommended Patch: <ulink
url="&patch-root;/tetex-src-&tex-version;-remove_readlink-1.patch"/></para>
</listitem>
</itemizedlist></sect3>
<sect3><title><application>TeX</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="ed"/></para>
</sect4>
<sect4><title>Optional</title>
<para><xref linkend="libpng"/>,
<xref linkend="x-installing"/>,
<xref linkend="openssl"/>,
<xref linkend="mysql"/>,
<xref linkend="perl-modules"/>: Tk-&Perl-Tk-version;, <ulink
url="http://gd.tuwien.ac.at/visual/ibiblio/libs/graphics/t1lib-5.0.2.tar.gz">t1lib</ulink>
and <ulink url="http://www.w3.org/Library/">libwww</ulink></para>
</sect4>
</sect3>
</sect2>
<sect2>
<title>Installation of <application>TeX</application></title>
<para><application>TeX</application> is installed from the source directory
(usually <filename class="directory">/usr/src</filename>) and untarring
instructions are included below instead of the usual assumption that you
have already untarred the package. The source directory should contain
the two required packages and the optional package, if desired.</para>
<para>Install <application>TeX</application> by running the following
commands:</para>
<screen><userinput><command>mkdir -p /usr/share/texmf &amp;&amp;
tar zxvf tetex-src-&tex-version;.tar.gz &amp;&amp;
cd tetex-src-&tex-version; &amp;&amp;
gzip -dc ../tetex-texmf-&tex-version;.tar.gz \
| (umask 0; cd /usr/share/texmf; tar xvf -)</command></userinput></screen>
<para>If the optional <filename>texmf</filename> source code
<acronym>TAR</acronym> ball was downloaded, untar it now:</para>
<screen><userinput><command>gzip -dc ../tetex-texmfsrc-&tex-version;.tar.gz \
| (umask 0; cd /usr/share/texmf; tar xvf -)</command></userinput></screen>
<screen><userinput><command>patch -Np1 -i ../tetex-src-&tex-version;-flex-1.patch &amp;&amp;
patch -Np1 -i ../tetex-src-&tex-version;-remove_readlink-1.patch &amp;&amp;
./configure --with-x=no --prefix=/usr \
--without-texinfo --with-system-ncurses --with-system-zlib \
--exec-prefix=/usr --bindir=/usr/bin &amp;&amp;
make world &amp;&amp;
texconfig dvips paper letter &amp;&amp;
texconfig font rw</command></userinput></screen>
<note><para>
The paper size may be changed to a4, as is used in most countries.
</para></note>
</sect2>
<sect2>
<title>Installation command explanations</title>
<para><screen><command>gzip -dc ../tetex-texmf-&tex-version;.tar.gz \
| (umask 0; cd /usr/share/texmf; tar xvf -)</command></screen>
Untar the <application>TeX</application> fonts and macro libraries.</para>
<para><option>--with-x=no</option>: This switch will avoid any
<application>X</application> Window dependencies.
<application>TeX</application> can be compiled with
<application>X</application> Window support, notably for
<command>xdvi</command>. If this is desired, remove this
configure option.</para>
<para><parameter>--exec-prefix=/usr --bindir=/usr/bin</parameter>: These
switches ensure that <application>TeX</application> binaries are installed in
<filename class="directory">/usr/bin</filename>.</para>
<para><parameter>--without-texinfo</parameter>: A default
<acronym>LFS</acronym> installation already has the
<application>texinfo</application> package installed; this switch will avoid
overwriting it with the included <application>texinfo</application>
package.</para>
<para><parameter>--with-system-ncurses</parameter>: This switch specifies
using the already installed <filename class="libraryfile">libncurses</filename>
library.</para>
<para><parameter>--with-system-zlib</parameter>: <acronym>LFS</acronym> systems
starting with version 4.0 have <application>Zlib</application> installed as
part of the base operating system; this switch avoids building it here.</para>
<para><command>texconfig dvips paper letter</command>: This command sets the
default paper size for <application>TeX</application>.</para>
<para><command>texconfig font rw</command>: This command specifies writable
fonts.</para>
</sect2>
<sect2>
<title>Contents</title>
<para>The <application>TeX</application> package contains 101 separate
binaries and shell scripts, and another 37 symlinks to these programs.
<application>TeX</application> also builds the
<filename class='libraryfile'>libkpathsea</filename> library.
Please refer to <ulink url="file:///usr/share/texmf/doc/index.html"/>
for details, as well as a tour of the expansive
<application>TeX</application> documentation.</para>
</sect2>
</sect1>