2011-01-18 08:13:43 +08:00
|
|
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
|
|
%general-entities;
|
|
|
|
|
|
|
|
<!ENTITY texlive-source-download-http " ">
|
2012-08-29 03:56:32 +08:00
|
|
|
<!ENTITY texlive-source-download-ftp "ftp://tug.org/texlive/historic/&texlive-year;/texlive-&texlive-version;-source.tar.xz">
|
2013-08-01 03:27:37 +08:00
|
|
|
<!ENTITY texlive-source-md5sum "f52599c99fb1035399b907f4c54f1125">
|
|
|
|
<!ENTITY texlive-source-size "172 MB">
|
|
|
|
|
|
|
|
<!ENTITY texlive-buildsize "1.6 GB">
|
|
|
|
<!ENTITY texlive-time "9.6 SBU">
|
2011-01-18 08:13:43 +08:00
|
|
|
]>
|
|
|
|
|
2012-04-18 13:18:11 +08:00
|
|
|
<sect1 id="texlive" xreflabel="texlive-&texlive-version;">
|
2011-01-18 08:13:43 +08:00
|
|
|
<?dbhtml filename="texlive.html"?>
|
|
|
|
|
|
|
|
<sect1info>
|
|
|
|
<othername>$LastChangedBy$</othername>
|
|
|
|
<date>$Date$</date>
|
|
|
|
</sect1info>
|
|
|
|
|
2012-04-18 13:18:11 +08:00
|
|
|
<title>texlive-&texlive-version;</title>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
|
|
|
<indexterm zone="texlive">
|
|
|
|
<primary sortas="a-texlive">texlive</primary>
|
|
|
|
</indexterm>
|
|
|
|
|
|
|
|
<sect2 role="package">
|
2014-02-14 10:11:34 +08:00
|
|
|
<title>Introduction to TeX Live from source</title>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
2014-02-14 10:11:34 +08:00
|
|
|
<para>A binary version of the <application>TeX Live</application> package
|
|
|
|
is installed at <xref linkend="tl-installer"/>. Here, we use that to rebuild
|
|
|
|
the compiled programs from source.</para>
|
2013-02-12 02:51:17 +08:00
|
|
|
|
2014-02-21 01:50:58 +08:00
|
|
|
&lfs75_checked;
|
2011-12-10 09:21:48 +08:00
|
|
|
|
2011-01-18 08:13:43 +08:00
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
|
|
<itemizedlist spacing="compact">
|
|
|
|
<listitem>
|
|
|
|
<para>Download (HTTP): <ulink url="&texlive-source-download-http;"/></para>
|
|
|
|
</listitem>
|
|
|
|
<listitem>
|
|
|
|
<para>Download (FTP): <ulink url="&texlive-source-download-ftp;"/></para>
|
|
|
|
</listitem>
|
|
|
|
<listitem>
|
|
|
|
<para>Download MD5 sum: &texlive-source-md5sum;</para>
|
|
|
|
</listitem>
|
|
|
|
<listitem>
|
|
|
|
<para>Download size: &texlive-source-size;</para>
|
|
|
|
</listitem>
|
|
|
|
<listitem>
|
|
|
|
<para>Estimated disk space required: &texlive-buildsize;</para>
|
|
|
|
</listitem>
|
|
|
|
<listitem>
|
|
|
|
<para>Estimated build time: &texlive-time;</para>
|
|
|
|
</listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
|
2014-02-16 03:39:01 +08:00
|
|
|
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
|
|
|
|
<itemizedlist spacing="compact">
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Required patch:
|
|
|
|
<ulink url="&patch-root;/texlive-&texlive-version;-source-fix_asymptote-1.patch"/>
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
|
2011-01-18 08:13:43 +08:00
|
|
|
<bridgehead renderas="sect3">TeX Live Dependencies</bridgehead>
|
2011-12-05 13:42:37 +08:00
|
|
|
|
2014-02-14 10:11:34 +08:00
|
|
|
<bridgehead renderas="sect4">Recommended</bridgehead>
|
2014-02-09 11:42:03 +08:00
|
|
|
<para role="recommended">
|
2014-02-14 10:11:34 +08:00
|
|
|
<xref linkend="freeglut"/> (for asy),
|
|
|
|
<xref linkend="gs"/>,
|
|
|
|
<xref linkend="x-window-system"/>
|
|
|
|
</para>
|
|
|
|
<para>
|
2014-02-09 11:42:03 +08:00
|
|
|
The source ships with its own versions of <emphasis>many</emphasis>
|
|
|
|
libraries, and will use them unless it is forced to use the system
|
2014-02-14 10:11:34 +08:00
|
|
|
versions. The following are recommended so that the system version
|
|
|
|
will be used:
|
2014-02-09 11:42:03 +08:00
|
|
|
<xref linkend="icu"/>,
|
2011-12-05 13:42:37 +08:00
|
|
|
<xref linkend="freetype2"/>,
|
|
|
|
<xref linkend="fontconfig"/>,
|
2014-02-09 11:42:03 +08:00
|
|
|
<xref linkend="graphite2"/>,
|
|
|
|
<xref linkend="harfbuzz"/> (linked to graphite2),
|
2011-12-05 13:42:37 +08:00
|
|
|
<xref linkend="libpng"/>,
|
2014-02-14 10:11:34 +08:00
|
|
|
<xref linkend="poppler"/>
|
2014-02-09 11:42:03 +08:00
|
|
|
</para>
|
|
|
|
|
2014-02-14 10:11:34 +08:00
|
|
|
<bridgehead renderas="sect4">Optional</bridgehead>
|
2014-02-09 11:42:03 +08:00
|
|
|
<para role="optional">
|
2014-02-14 10:11:34 +08:00
|
|
|
<ulink url="http://www.fftw.org/">FFTW</ulink> can be used by asy.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
The source ships with its own versions of several libraries which are either
|
2014-02-09 11:42:03 +08:00
|
|
|
not under active development, or only used for limited functionality. If
|
|
|
|
you install these, as with some other optional dependencies in this book you
|
|
|
|
will need to tell <command>configure</command> to use the system versions.
|
2013-12-13 18:17:49 +08:00
|
|
|
<ulink url="http://libgd.bitbucket.org">GD</ulink>,
|
|
|
|
<ulink url="http://fossies.org/linux/misc/t1lib-5.1.2.tar.gz/">t1lib</ulink>,
|
2011-12-05 13:42:37 +08:00
|
|
|
<ulink url="http://sourceforge.net/projects/zziplib/">ZZIPlib</ulink>,
|
|
|
|
<ulink url="http://www.gnu.org/software/clisp/">CLISP</ulink>,
|
2014-02-09 11:42:03 +08:00
|
|
|
<ulink url="http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=TECkitDownloads">TECkit</ulink>
|
|
|
|
</para>
|
|
|
|
|
2014-02-14 10:11:34 +08:00
|
|
|
<bridgehead renderas="sect4">Runtime dependencies</bridgehead>
|
2014-02-09 11:42:03 +08:00
|
|
|
<para role="recommended">
|
2014-02-14 10:11:34 +08:00
|
|
|
Some (re-installed) scripts will use
|
|
|
|
<xref linkend="ruby"/> and <xref linkend="tk"/> is used by epspdftk.
|
2014-02-07 07:15:02 +08:00
|
|
|
</para>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
|
|
|
<para condition="html" role="usernotes">User Notes:
|
|
|
|
<ulink url="&blfs-wiki;/texlive"/></para>
|
|
|
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
<sect2 role="installation">
|
|
|
|
<title>Installation of TeX Live</title>
|
|
|
|
|
2014-02-14 10:11:34 +08:00
|
|
|
<para>These instructions will overwrite the corresponding files from the
|
|
|
|
binary installer. As with the installer, change x86_64-linux to whatever
|
|
|
|
matches your architecture.</para>
|
2014-02-09 11:42:03 +08:00
|
|
|
|
|
|
|
<para>Please note that installing from source will recompile the binary
|
|
|
|
programs and recreate the <literal>man</literal> and <literal>info</literal>
|
|
|
|
files. It will also overwrite the scripts - some of these may be older
|
|
|
|
versions than those from the newer installer. It will <emphasis>not</emphasis>
|
|
|
|
recreate any of the following: the more than 200 symlinks in the
|
2014-02-14 10:11:34 +08:00
|
|
|
x86_64-linux directory (some are alternate names, many are pointers to
|
2014-02-09 11:42:03 +08:00
|
|
|
the scripts), html files, PDF files, licenses, README files, two config
|
|
|
|
files (<filename>texmf.cnf</filename> and <filename>texmfcnf.lua</filename>),
|
|
|
|
nor the many package and font files in
|
|
|
|
<filename class="directory">texmf-dist</filename> and
|
|
|
|
<filename class="directory">texmf-var</filename>, nor the files recording
|
|
|
|
the actions of the installer, and the <filename>ls-R</filename> files listing
|
|
|
|
what was originally installed.</para>
|
|
|
|
|
|
|
|
<para>At the moment, these instructions do not rebuild
|
2014-02-21 01:50:58 +08:00
|
|
|
<application>xindy</application> which was installed by the binary installer,
|
|
|
|
due to a problem with the tarball's install procedure. Asy and the rest of
|
2014-02-16 03:39:01 +08:00
|
|
|
asymptote is by default not rebuilt, so we have to separately run
|
|
|
|
<command>configure</command> and <command>make</command> in its directory.
|
|
|
|
</para>
|
2014-02-09 11:42:03 +08:00
|
|
|
|
2014-02-16 03:39:01 +08:00
|
|
|
<screen><userinput>patch -Np1 -i ../texlive-&texlive-version;-source-fix_asymptote-1.patch &&
|
|
|
|
|
|
|
|
mkdir texlive-build &&
|
2014-02-09 11:42:03 +08:00
|
|
|
cd texlive-build &&
|
|
|
|
|
2014-02-21 01:50:58 +08:00
|
|
|
../configure \
|
|
|
|
--prefix=/opt/texlive/2013 \
|
|
|
|
--bindir=/opt/texlive/2013/bin/x86_64-linux \
|
|
|
|
--datarootdir=/opt/texlive/2013 \
|
|
|
|
--includedir=/usr/include \
|
|
|
|
--infodir=/opt/texlive/2013/texmf-dist/doc/info \
|
|
|
|
--libdir=/usr/lib \
|
|
|
|
--mandir=/opt/texlive/2013/texmf-dist/doc/man \
|
|
|
|
--disable-native-texlive-build \
|
|
|
|
--disable-static --enable-shared \
|
|
|
|
--with-system-libgs \
|
|
|
|
--with-system-poppler \
|
|
|
|
--with-system-freetype2 \
|
|
|
|
--with-system-fontconfig \
|
|
|
|
--with-system-libpng \
|
|
|
|
--with-system-icu \
|
|
|
|
--with-system-graphite2 \
|
|
|
|
--with-system-harfbuzz \
|
|
|
|
--with-system-xpdf \
|
|
|
|
--with-system-poppler \
|
|
|
|
--with-system-cairo \
|
|
|
|
--with-system-pixman \
|
|
|
|
--with-system-zlib \
|
|
|
|
--with-banner-add=" - BLFS" &&
|
2014-02-09 11:42:03 +08:00
|
|
|
|
2014-02-16 03:39:01 +08:00
|
|
|
pushd ../utils/asymptote &&
|
2014-02-21 01:50:58 +08:00
|
|
|
echo "ac_cv_lib_m_sqrt=yes" >config.cache &&
|
|
|
|
echo "ac_cv_lib_z_deflate=yes" >>config.cache &&
|
|
|
|
|
|
|
|
./configure LIBS="-ltirpc " \
|
|
|
|
--prefix=/opt/texlive/2013/ \
|
|
|
|
--bindir=/opt/texlive/2013/bin/x86_64-linux \
|
|
|
|
--enable-texlive-build \
|
|
|
|
--datarootdir=/opt/texlive/2013/texmf-dist \
|
|
|
|
--infodir=/opt/texlive/2013/texmf-dist/doc/info \
|
|
|
|
--mandir=/opt/texlive/2013/texmf-dist/doc/man \
|
|
|
|
--cache-file=config.cache &&
|
2014-02-16 03:39:01 +08:00
|
|
|
popd &&
|
|
|
|
|
|
|
|
make &&
|
|
|
|
make -C ../utils/asymptote</userinput></screen>
|
|
|
|
|
|
|
|
<para>To test the results, issue: <command>make -k chec &&
|
|
|
|
make -C utils/asymptote checkk</command>.</para>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
2014-02-09 11:42:03 +08:00
|
|
|
<para>Now, as the <systemitem class="username">root</systemitem>
|
|
|
|
user:</para>
|
2011-11-29 11:53:39 +08:00
|
|
|
|
2014-02-16 03:39:01 +08:00
|
|
|
<screen><userinput role="root">make install &&
|
|
|
|
make -C ../utils/asymptote install</userinput></screen>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
2014-02-09 11:42:03 +08:00
|
|
|
</sect2>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
2014-02-09 11:42:03 +08:00
|
|
|
<sect2 role="commands">
|
|
|
|
<title>Command Explanations</title>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
2014-02-09 11:42:03 +08:00
|
|
|
<para>
|
|
|
|
<parameter>--prefix=, --bindir=, --datarootdir=, --infodir=, --mandir= ...
|
|
|
|
</parameter>: these switches ensure that the files installed from source
|
|
|
|
will overwrite the corresponding files previously installed by
|
|
|
|
<application>install-tl</application>.
|
|
|
|
</para>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
2014-02-09 11:42:03 +08:00
|
|
|
<para>
|
|
|
|
<parameter>--includedir=, --libdir= ...</parameter> : these switches ensure
|
|
|
|
that the libraries will be found at runtime, and that programs can be
|
|
|
|
compiled against them.
|
|
|
|
</para>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
2014-02-09 11:42:03 +08:00
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
|
|
href="../../xincludes/static-libraries.xml"/>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
<parameter>--enable-shared</parameter>: Use shared versions of
|
|
|
|
<filename class="libraryfile">libkpathsea</filename> and
|
|
|
|
<filename class="libraryfile">libptexenc</filename>.
|
|
|
|
</para>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
2014-02-09 11:42:03 +08:00
|
|
|
<para>
|
|
|
|
<parameter>--with-system-...</parameter>: Unless this parameter is used,
|
|
|
|
the included versions of these libraries will be statically compiled
|
|
|
|
into the programs which need them. If you decided not to install a
|
|
|
|
recommended library, omit the corresponding switches.
|
|
|
|
</para>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
2014-02-09 11:42:03 +08:00
|
|
|
<para>
|
|
|
|
<parameter>--with-system-xpdf</parameter>: Uniquely, this parameter has
|
|
|
|
a non-standard meaning, it tells <command>configure</command> to use the
|
|
|
|
system-installed <application>poppler</application> headers and library.
|
|
|
|
Again, omit this if you have not installed
|
|
|
|
<application>poppler</application>.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2014-02-16 03:39:01 +08:00
|
|
|
<parameter>echo "ac_cv_lib_m_sqrt=yes" ... LIBS="-ltirpc " >config.cache,
|
|
|
|
... --cache-file=config.cache</parameter> : The configure scripts in
|
|
|
|
<application>TeX Live</application> are uncommon. Asymptote not only has to
|
|
|
|
be separately configured and built, the configure script fails to find the
|
|
|
|
shared <filename class="libraryfile">libtirpc.so</filename>. Passing that
|
|
|
|
in LIBS breaks the tests for (static) libm and (shared) libz, so we have to
|
|
|
|
fix things up, in much the same way as when cross-compiling.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
<option>--without-x</option>: use this (and omit the configure and make in
|
|
|
|
<filename>utils/asymptote</filename> if you do not have Xorg installed.
|
2014-02-09 11:42:03 +08:00
|
|
|
</para>
|
2011-01-18 08:13:43 +08:00
|
|
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
<sect2 role="content">
|
|
|
|
<title>Contents</title>
|
|
|
|
|
|
|
|
<segmentedlist>
|
|
|
|
<segtitle>Installed Programs</segtitle>
|
|
|
|
<segtitle>Installed Libraries</segtitle>
|
|
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
|
|
|
|
<seglistitem>
|
|
|
|
<seg>Over 300 binaries and symlinks to scripts</seg>
|
2014-02-17 09:06:54 +08:00
|
|
|
<seg>libkpathsea.so, libptexenc.so</seg>
|
|
|
|
<seg>/opt/texlive, /usr/include/kpathsea, /usr/include/ptexenc</seg>
|
2011-01-18 08:13:43 +08:00
|
|
|
</seglistitem>
|
|
|
|
</segmentedlist>
|
|
|
|
|
|
|
|
<variablelist>
|
|
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
|
|
<?dbfo list-presentation="list"?>
|
|
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
|
|
|
|
<varlistentry id="texlive-programs">
|
2011-12-05 13:42:37 +08:00
|
|
|
<term><command>TeX programs</command></term>
|
2011-01-18 08:13:43 +08:00
|
|
|
<listitem>
|
|
|
|
<para>included in the <application>TeX Live</application> package are
|
|
|
|
too numerous to individually list. Please refer to the individual
|
2011-12-05 13:42:37 +08:00
|
|
|
program man and html pages in the installation directory's 2011/index.html
|
|
|
|
directory.</para>
|
2011-01-18 08:13:43 +08:00
|
|
|
<indexterm zone="texlive texlive-programs">
|
|
|
|
<primary sortas="b-texlive-programs">TeX Live programs</primary>
|
|
|
|
</indexterm>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
2014-02-17 09:06:54 +08:00
|
|
|
|
|
|
|
<varlistentry id="libkpathsea">
|
|
|
|
<term><filename class="libraryfile">libkpathsea.so</filename></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
(kpathsearch) exists to look up a file in a list of directories.
|
|
|
|
</para>
|
|
|
|
<indexterm zone="texlive libkpathsea">
|
|
|
|
<primary sortas="c-libkpathsea">libkpathsea.so</primary>
|
|
|
|
</indexterm>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry id="libptexenc">
|
|
|
|
<term><filename class="libraryfile">libptexenc.so</filename></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
is a library for Japanese pTeX (publishing TeX).
|
|
|
|
</para>
|
|
|
|
<indexterm zone="texlive libptexenc">
|
|
|
|
<primary sortas="c-libptexenc">libptexenc.so</primary>
|
|
|
|
</indexterm>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
2011-01-18 08:13:43 +08:00
|
|
|
</variablelist>
|
|
|
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
</sect1>
|