[c117e5a] | 1 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
|
---|
| 2 | "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
---|
| 3 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 4 | %general-entities;
|
---|
[4f6275fd] | 5 |
|
---|
[c117e5a] | 6 | <!ENTITY tex-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/current/distrib/tetex-src-&tex-version;.tar.gz">
|
---|
| 7 | <!ENTITY texmf-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/current/distrib/tetex-texmf-&tex-version;.tar.gz">
|
---|
| 8 | <!ENTITY texmfsrc-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/current/distrib/tetex-texmfsrc-&tex-version;.tar.gz">
|
---|
[dfd0a5d5] | 9 | <!ENTITY tex-size "64 MB">
|
---|
| 10 | <!ENTITY tex-optional-size "87 MB">
|
---|
| 11 | <!ENTITY tex-buildsize "344 MB">
|
---|
| 12 | <!ENTITY tex-optional-buildsize "415 MB">
|
---|
[c117e5a] | 13 | <!ENTITY tex-time "2.97 SBU">
|
---|
| 14 | ]>
|
---|
| 15 |
|
---|
[19234f1] | 16 | <sect1 id="pst-typesetting-tex" xreflabel="TeX-&tex-version;">
|
---|
[dd3f20f0] | 17 | <?dbhtml filename="tex.html"?>
|
---|
[19234f1] | 18 | <title>TeX-&tex-version;</title>
|
---|
[42e2f8d] | 19 |
|
---|
[c117e5a] | 20 | <sect2>
|
---|
| 21 | <title>Introduction to <application>TeX</application></title>
|
---|
| 22 |
|
---|
| 23 | <para><application>TeX</application> is a typesetting package, able to create
|
---|
[dfd0a5d5] | 24 | documents in a variety of formats. The optional <filename>texmfsrc</filename>
|
---|
[c117e5a] | 25 | <acronym>TAR</acronym> ball contains source code for packages that are
|
---|
[dfd0a5d5] | 26 | contained in the <filename>texmf</filename> <acronym>TAR</acronym> ball,
|
---|
| 27 | including the docstrip sources.</para>
|
---|
[c117e5a] | 28 |
|
---|
| 29 | <sect3><title>Package information</title>
|
---|
| 30 | <itemizedlist spacing='compact'>
|
---|
[dfd0a5d5] | 31 | <listitem><para>Required Download (FTP): <ulink
|
---|
[c117e5a] | 32 | url="&tex-download-ftp;"/></para></listitem>
|
---|
[dfd0a5d5] | 33 | <listitem><para>Required Download (FTP): <ulink
|
---|
[c117e5a] | 34 | url="&texmf-download-ftp;"/></para></listitem>
|
---|
| 35 | <listitem><para>Optional Download (FTP): <ulink
|
---|
| 36 | url="&texmfsrc-download-ftp;"/></para></listitem>
|
---|
[dfd0a5d5] | 37 | <listitem><para>Download size:
|
---|
| 38 | &tex-size; (&tex-optional-size; with optional tarball)</para></listitem>
|
---|
[c117e5a] | 39 | <listitem><para>Estimated Disk space required:
|
---|
[dfd0a5d5] | 40 | &tex-buildsize; (&tex-optional-buildsize; with optional tarball)</para></listitem>
|
---|
[c117e5a] | 41 | <listitem><para>Estimated build time:
|
---|
| 42 | &tex-time;</para></listitem></itemizedlist>
|
---|
| 43 | </sect3>
|
---|
| 44 |
|
---|
| 45 | <sect3><title>Additional Downloads</title>
|
---|
| 46 | <itemizedlist spacing='compact'>
|
---|
[dfd0a5d5] | 47 | <listitem><para>Recommended Patch: <ulink
|
---|
| 48 | url="&patch-root;/tetex-src-&tex-version;-remove_readlink-1.patch"/></para></listitem>
|
---|
[c117e5a] | 49 | </itemizedlist></sect3>
|
---|
| 50 |
|
---|
[dfd0a5d5] | 51 | <sect3><title><application>TeX</application> dependencies</title>
|
---|
| 52 | <sect4><title>Optional</title>
|
---|
| 53 | <para><xref linkend="x-installing"/>,
|
---|
| 54 | <xref linkend="openssl"/>,
|
---|
| 55 | <xref linkend="mysql"/> and
|
---|
[34f86ab] | 56 | <xref linkend="perl-modules"/>: Tk-&Perl-Tk-version;</para>
|
---|
[dfd0a5d5] | 57 | </sect4>
|
---|
| 58 | </sect3>
|
---|
| 59 |
|
---|
[c117e5a] | 60 | </sect2>
|
---|
| 61 |
|
---|
| 62 | <sect2>
|
---|
| 63 | <title>Installation of <application>TeX</application></title>
|
---|
| 64 |
|
---|
| 65 | <para><application>TeX</application> is installed from the source
|
---|
| 66 | directory (usually <filename class="directory">/usr/src</filename>) and untarring
|
---|
| 67 | instructions are included below instead of the usual assumption that you
|
---|
| 68 | have already untarred the package. The source directory should contain
|
---|
| 69 | the two required packages and the optional package, if desired.</para>
|
---|
| 70 |
|
---|
[4f6275fd] | 71 | <para>Install <application>TeX</application> by running the following
|
---|
| 72 | commands:</para>
|
---|
[c117e5a] | 73 |
|
---|
| 74 | <screen><userinput><command>mkdir -p /usr/share/texmf &&
|
---|
| 75 | tar zxvf tetex-src-&tex-version;.tar.gz &&
|
---|
| 76 | cd tetex-src-&tex-version; &&
|
---|
| 77 | gzip -dc ../tetex-texmf-&tex-version;.tar.gz \
|
---|
| 78 | | (umask 0; cd /usr/share/texmf; tar xvf -)</command></userinput></screen>
|
---|
| 79 |
|
---|
[dfd0a5d5] | 80 | <para>If the optional <filename>texmf</filename> source code
|
---|
| 81 | <acronym>TAR</acronym> ball was downloaded, untar it now:</para>
|
---|
| 82 |
|
---|
[c117e5a] | 83 | <screen><userinput><command>gzip -dc ../tetex-texmfsrc-&tex-version;.tar.gz \
|
---|
| 84 | | (umask 0; cd /usr/share/texmf; tar xvf -)</command></userinput></screen>
|
---|
| 85 |
|
---|
[4f6275fd] | 86 | <screen><userinput><command>patch -Np1 -i ../tetex-src-&tex-version;-remove_readlink-1.patch &&
|
---|
[c117e5a] | 87 | ./configure --with-x=no --prefix=/usr \
|
---|
| 88 | --without-texinfo --with-system-ncurses --with-system-zlib \
|
---|
| 89 | --exec-prefix=/usr --bindir=/usr/bin &&
|
---|
| 90 | make world &&
|
---|
| 91 | texconfig dvips paper letter &&
|
---|
| 92 | texconfig font rw</command></userinput></screen>
|
---|
| 93 |
|
---|
| 94 | <note><para>
|
---|
| 95 | The paper size may be changed to a4, as is used in most countries.
|
---|
| 96 | </para></note>
|
---|
| 97 |
|
---|
| 98 | </sect2>
|
---|
| 99 |
|
---|
| 100 | <sect2>
|
---|
| 101 | <title>Installation command explanations</title>
|
---|
| 102 |
|
---|
| 103 | <para><screen><command>gzip -dc ../tetex-texmf-&tex-version;.tar.gz \
|
---|
| 104 | | (umask 0; cd /usr/share/texmf; tar xvf -)</command></screen>
|
---|
| 105 | Untar the <application>TeX</application> fonts and macro libraries.</para>
|
---|
| 106 |
|
---|
| 107 | <para><parameter>--with-x=no</parameter>: This switch will avoid any
|
---|
| 108 | <application>XFree86</application> dependencies.
|
---|
| 109 | <application>TeX</application> can be compiled with
|
---|
| 110 | <application>XFree86</application> support, notably for
|
---|
| 111 | <command>xdvi</command>. If this is desired, remove this
|
---|
| 112 | configure option.</para>
|
---|
| 113 |
|
---|
| 114 | <para><parameter>--exec-prefix=/usr --bindir=/usr/bin</parameter>: This switch
|
---|
| 115 | will ensure that <application>TeX</application> binaries will be installed in
|
---|
| 116 | <filename class="directory">/usr/bin</filename>.</para>
|
---|
| 117 |
|
---|
| 118 | <para><option>--without-texinfo</option>: A default
|
---|
| 119 | <acronym>LFS</acronym> installation already has the
|
---|
| 120 | <application>texinfo</application> package
|
---|
| 121 | installed; this switch will avoid overwriting it with the included
|
---|
| 122 | <application>texinfo</application>
|
---|
| 123 | package.</para>
|
---|
| 124 |
|
---|
| 125 | <para><option>--with-system-ncurses</option>: This switch specifies using the
|
---|
[4f6275fd] | 126 | already installed <filename class="libraryfile">libncurses</filename>
|
---|
| 127 | library.</para>
|
---|
[c117e5a] | 128 |
|
---|
| 129 | <para><option>--with-system-zlib</option>: <acronym>LFS</acronym>
|
---|
[dfd0a5d5] | 130 | <acronym>LFS</acronym> systems starting with version 4.0 have
|
---|
| 131 | <application>Zlib</application> installed as part of the
|
---|
[c117e5a] | 132 | base operating system; this switch avoids building it here.</para>
|
---|
| 133 |
|
---|
| 134 | <para><command>texconfig dvips paper letter</command>: This command sets the
|
---|
| 135 | default paper size for <application>TeX</application>.</para>
|
---|
| 136 |
|
---|
| 137 | <para><command>texconfig font rw</command>: This command specifies writable
|
---|
| 138 | fonts.</para>
|
---|
| 139 |
|
---|
| 140 | </sect2>
|
---|
| 141 |
|
---|
| 142 | <sect2>
|
---|
| 143 | <title>Contents</title>
|
---|
| 144 |
|
---|
[dfd0a5d5] | 145 | <para>The <application>TeX</application> package contains 101 separate
|
---|
| 146 | binaries and shell scripts, and another 37 symlinks to these programs.
|
---|
| 147 | <application>TeX</application> also builds the
|
---|
| 148 | <filename class='libraryfile'>libkpathsea</filename> library.
|
---|
[c117e5a] | 149 | Please refer to <ulink url="file:///usr/share/texmf/doc/index.html"/>
|
---|
| 150 | for details, as well as a tour of the expansive
|
---|
| 151 | <application>TeX</application> documentation.</para>
|
---|
| 152 | </sect2>
|
---|
[42e2f8d] | 153 |
|
---|
| 154 | </sect1>
|
---|