Changeset 5428e2b for pst/typesetting


Ignore:
Timestamp:
05/16/2005 05:41:04 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
04622054
Parents:
cfe5e36
Message:

Tagged tex.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4314 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed
  • pst/typesetting/tex.xml

    rcfe5e36 r5428e2b  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
    12<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
    23   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     
    2324
    2425<sect1 id="tex" xreflabel="TeX-&tex-version;">
    25 <sect1info>
    26 <othername>$LastChangedBy$</othername>
    27 <date>$Date$</date>
    28 </sect1info>
    29 <?dbhtml filename="tex.html"?>
    30 <title>TeX-&tex-version;</title>
    31 <indexterm zone="tex">
    32 <primary sortas="a-TeX">TeX</primary></indexterm>
    33 
    34 <sect2>
    35 <title>Introduction to <application>TeX</application></title>
    36 
    37 <para><application>TeX</application> is a typesetting package, able to create
    38 documents in a variety of formats.  The optional <filename>texmfsrc</filename>
    39 <acronym>TAR</acronym> ball contains source code for packages that are
    40 contained in the <filename>texmf</filename> <acronym>TAR</acronym> ball,
    41 including the docstrip sources.</para>
    42 
    43 <sect3><title>Package information</title>
    44 <itemizedlist spacing='compact'>
    45 <listitem><para>Download (HTTP):
    46 <ulink url="&tex-download-http;"/></para></listitem>
    47 <listitem><para>Download (FTP):
    48 <ulink url="&tex-download-ftp;"/></para></listitem>
    49 <listitem><para>Download MD5 sum: &tex-md5sum;</para></listitem>
    50 <listitem><para>Download size: &tex-size;</para></listitem>
    51 <listitem><para>Estimated disk space required:
    52 &tex-buildsize;</para></listitem>
    53 <listitem><para>Estimated build time: &tex-time;</para></listitem>
    54 </itemizedlist>
    55 </sect3>
    56 
    57 <sect3><title>Additional Downloads</title>
    58 <sect4><title>Required macros and fonts</title>
    59 <itemizedlist spacing='compact'>
    60 <listitem><para>Download (HTTP):
    61 <ulink url="&texmf-download-http;"/></para></listitem>
    62 <listitem><para>Download (FTP):
    63 <ulink url="&texmf-download-ftp;"/></para></listitem>
    64 <listitem><para>Download MD5 sum: &texmf-md5sum;</para></listitem>
    65 <listitem><para>Download size: &texmf-size;</para></listitem>
    66 </itemizedlist>
    67 </sect4>
    68 
    69 <sect4><title>Optional <filename>texmf</filename> sources:</title>
    70 <itemizedlist spacing='compact'>
    71 <listitem><para>Download (HTTP):
    72 <ulink url="&texmfsrc-download-http;"/></para></listitem>
    73 <listitem><para>Download (FTP):
    74 <ulink url="&texmfsrc-download-ftp;"/></para></listitem>
    75 <listitem><para>Download MD5 sum: &texmfsrc-md5sum;</para></listitem>
    76 <listitem><para>Download size: &texmfsrc-size;</para></listitem>
    77 </itemizedlist>
    78 </sect4>
    79 
    80 <!--
     26  <?dbhtml filename="tex.html"?>
     27
     28  <sect1info>
     29    <othername>$LastChangedBy$</othername>
     30    <date>$Date$</date>
     31  </sect1info>
     32
     33  <title>TeX-&tex-version;</title>
     34
     35  <indexterm zone="tex">
     36    <primary sortas="a-TeX">TeX</primary>
     37  </indexterm>
     38
     39  <sect2 role="package">
     40    <title>Introduction to TeX</title>
     41
     42    <para><application>TeX</application> is a typesetting package, able to create
     43    documents in a variety of formats.  The optional <filename>texmfsrc</filename>
     44    TAR ball contains source code for packages that are contained in the
     45    <filename>texmf</filename> TAR ball, including the docstrip sources.</para>
     46
     47    <bridgehead renderas="sect3">Package Information</bridgehead>
     48    <itemizedlist spacing="compact">
     49      <listitem>
     50        <para>Download (HTTP): <ulink url="&tex-download-http;"/></para>
     51      </listitem>
     52      <listitem>
     53        <para>Download (FTP): <ulink url="&tex-download-ftp;"/></para>
     54      </listitem>
     55      <listitem>
     56        <para>Download MD5 sum: &tex-md5sum;</para>
     57      </listitem>
     58      <listitem>
     59        <para>Download size: &tex-size;</para>
     60      </listitem>
     61      <listitem>
     62        <para>Estimated disk space required: &tex-buildsize;</para>
     63      </listitem>
     64      <listitem>
     65        <para>Estimated build time: &tex-time;</para>
     66      </listitem>
     67    </itemizedlist>
     68
     69    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     70
     71    <itemizedlist spacing='compact'>
     72      <title>Required Macros and Fonts</title>
     73      <listitem>
     74        <para>Download (HTTP): <ulink url="&texmf-download-http;"/></para>
     75      </listitem>
     76      <listitem>
     77        <para>Download (FTP): <ulink url="&texmf-download-ftp;"/></para>
     78      </listitem>
     79      <listitem>
     80        <para>Download MD5 sum: &texmf-md5sum;</para>
     81      </listitem>
     82      <listitem>
     83        <para>Download size: &texmf-size;</para>
     84      </listitem>
     85    </itemizedlist>
     86
     87    <itemizedlist spacing='compact'>
     88      <title>Optional 'texmf' Sources:</title>
     89      <listitem>
     90        <para>Download (HTTP): <ulink url="&texmfsrc-download-http;"/></para>
     91      </listitem>
     92      <listitem>
     93        <para>Download (FTP): <ulink url="&texmfsrc-download-ftp;"/></para>
     94      </listitem>
     95      <listitem>
     96        <para>Download MD5 sum: &texmfsrc-md5sum;</para>
     97      </listitem>
     98      <listitem>
     99        <para>Download size: &texmfsrc-size;</para>
     100      </listitem>
     101    </itemizedlist>
     102
     103<!--
    81104<sect4><title>Patches</title>
    82105<itemizedlist spacing='compact'>
    83 <listitem><para>Required Patch: <ulink 
     106<listitem><para>Required Patch: <ulink
    84107url="&patch-root;/tetex-src-&tex-version;-flex-1.patch"/></para></listitem>
    85 <listitem><para>Recommended Patch: <ulink 
     108<listitem><para>Recommended Patch: <ulink
    86109url="&patch-root;/tetex-src-&tex-version;-remove_readlink-1.patch"/></para>
    87110</listitem>
     
    89112</sect4>
    90113 -->
    91 </sect3>
    92 
    93 <sect3><title><application>TeX</application> dependencies</title>
    94 <sect4><title>Required</title>
    95 <para><xref linkend="ed"/></para>
    96 </sect4>
    97 
    98 <sect4><title>Optional</title>
    99 <para><xref linkend="libpng"/>,
    100 <xref linkend="x-installing"/>,
    101 <!-- <xref linkend="openssl"/>,
    102 <xref linkend="mysql"/>, -->
    103 <xref linkend="perl-modules"/>: Tk-&Perl-Tk-version;, <ulink
    104 url="http://gd.tuwien.ac.at/visual/ibiblio/libs/graphics/t1lib-5.0.2.tar.gz">
    105 t1lib</ulink>
    106 and <ulink url="http://www.boutell.com/gd/">GD</ulink></para>
    107 </sect4>
    108 </sect3>
    109 
    110 </sect2>
    111 
    112 <sect2>
    113 <title>Installation of <application>TeX</application></title>
     114
     115    <bridgehead renderas="sect3">TeX Dependencies</bridgehead>
     116
     117    <bridgehead renderas="sect4">Required</bridgehead>
     118    <para><xref linkend="ed"/></para>
     119
     120    <bridgehead renderas="sect4">Optional</bridgehead>
     121    <para><xref linkend="libpng"/>,
     122    <xref linkend="x-installing"/>,
     123    <!-- <xref linkend="openssl"/>,
     124    <xref linkend="mysql"/>, -->
     125    <xref linkend="perl-modules"/>: Tk-&Perl-Tk-version;, <ulink
     126    url="http://gd.tuwien.ac.at/visual/ibiblio/libs/graphics/t1lib-5.0.2.tar.gz">
     127    t1lib</ulink>
     128    and <ulink url="http://www.boutell.com/gd/">GD</ulink></para>
     129
     130  </sect2>
     131
     132  <sect2 role="installation">
     133    <title>Installation of TeX</title>
    114134
    115135<!--
    116 <para><application>TeX</application> is installed from the source directory 
     136<para><application>TeX</application> is installed from the source directory
    117137(usually <filename class="directory">/usr/src</filename>) and untarring
    118138instructions are included below instead of the usual assumption that you
     
    121141-->
    122142
    123 <para>Before building <application>TeX</application>, the macros and fonts
    124 package (<filename>texmf</filename> tarball) must be installed. Install the
    125 macros and fonts using the following commands as the root user:</para>
    126 
    127 <screen><userinput role='root'><command>install -v -d -m755 /usr/share/texmf &amp;&amp;
     143    <para>Before building <application>TeX</application>, the macros and
     144    fonts package (<filename>texmf</filename> tarball) must be installed.
     145    Install the macros and fonts using the following commands as the
     146    <systemitem class="username">root</systemitem> user:</para>
     147
     148<screen role="root"><userinput>install -v -d -m755 /usr/share/texmf &amp;&amp;
    128149gzip -dc ../tetex-texmf-&tex-version;.tar.gz \
    129     | (umask 0; cd /usr/share/texmf; tar -xf -)</command></userinput></screen>
    130 
    131 <para>If the optional <filename>texmf</filename> source code
    132 <acronym>TAR</acronym> ball was downloaded, untar it now as the root
    133 user:</para>
    134 
    135 <screen><userinput role='root'><command>gzip -dc ../tetex-texmfsrc-&tex-version;.tar.gz \
    136     | (umask 0; cd /usr/share/texmf; tar -xf -)</command></userinput></screen>
    137 
    138 <para>Install <application>TeX</application> by running the following
    139 commands:</para>
    140 
    141 <!-- 
     150    | (umask 0; cd /usr/share/texmf; tar -xf -)</userinput></screen>
     151
     152    <para>If the optional <filename>texmf</filename> source code TAR ball
     153    was downloaded, untar it now as the <systemitem
     154    class="username">root</systemitem> user:</para>
     155
     156<screen role="root"><userinput>gzip -dc ../tetex-texmfsrc-&tex-version;.tar.gz \
     157    | (umask 0; cd /usr/share/texmf; tar -xf -)</userinput></screen>
     158
     159    <para>Install <application>TeX</application> by running the following
     160    commands:</para>
     161
     162<!--
    142163<screen><userinput><command>patch -Np1 -i ../tetex-src-&tex-version;-flex-1.patch &amp;&amp;
    143164patch -Np1 -i ../tetex-src-&tex-version;-remove_readlink-1.patch &amp;&amp;
    144165 -->
    145166
    146 <screen><userinput><command>./configure --prefix=/usr \
     167<screen><userinput>./configure --prefix=/usr \
    147168    --exec-prefix=/usr --bindir=/usr/bin \
    148169    --without-texinfo --with-x=no \
    149170    --with-system-ncurses --with-system-zlib &amp;&amp;
    150 make all</command></userinput></screen>
    151 
    152 <para>Now, as the root user:</para>
    153 
    154 <screen><userinput role='root'><command>make install &amp;&amp;
     171make all</userinput></screen>
     172
     173    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     174
     175<screen role="root"><userinput>make install &amp;&amp;
    155176texconfig dvips paper letter &amp;&amp;
    156 texconfig font rw</command></userinput></screen>
    157 
    158 <note><para>The paper size may be changed to a4, as is used in most
    159 countries.</para></note>
    160 
    161 </sect2>
    162 
    163 <sect2>
    164 <title>Installation command explanations</title>
    165 
    166 <para><option>--with-x=no</option>: This switch will avoid any
    167 <application>X</application> Window dependencies.
    168 <application>TeX</application> can be compiled with
    169 <application>X</application> Window support, notably for
    170 <command>xdvi</command>.  If this is desired, remove this
    171 configure option.</para>
    172 
    173 <para><parameter>--exec-prefix=/usr --bindir=/usr/bin</parameter>: These
    174 switches ensure that <application>TeX</application> binaries are installed in
    175 <filename class="directory">/usr/bin</filename>.</para>
    176 
    177 <para><parameter>--without-texinfo</parameter>: A default
    178 <acronym>LFS</acronym> installation already has the
    179 <application>Texinfo</application> package installed; this switch will avoid
    180 overwriting it with the included <application>Texinfo</application>
    181 package.</para>
    182 
    183 <para><parameter>--with-system-ncurses</parameter>: This switch specifies
    184 using the already installed <filename class="libraryfile">libncurses</filename>
    185 library.</para>
    186 
    187 <para><parameter>--with-system-zlib</parameter>: <acronym>LFS</acronym> systems
    188 starting with version 4.0 have <application>Zlib</application> installed as
    189 part of the base operating system; this switch avoids building it here.</para>
    190 
    191 <para><option>--disable-a4</option>: Use this option to set the default paper
    192 size to letter and the default unit to inch.</para>
    193 
    194 <para><command>texconfig dvips paper letter</command>: This command sets the
    195 default paper size for <application>TeX</application>.</para>
    196 
    197 <para><command>texconfig font rw</command>: This command specifies writable
    198 fonts.</para>
    199 
    200 <tip><para>Run <command>./configure --help</command> for information about
    201 using other switches which will enable the build to use any installed packages
    202 you may have on your system.</para></tip>
    203 
    204 </sect2>
    205 
    206 <sect2>
    207 <title>Contents</title>
    208 
    209 <segmentedlist>
    210 <segtitle>Installed Programs</segtitle>
    211 <segtitle>Installed Library</segtitle>
    212 <segtitle>Installed Directories</segtitle>
    213 <seglistitem>
    214 <seg>100 separate binaries and scripts along with 30 symlinks to these
    215 programs.</seg>
    216 <seg>libkpathsea.a</seg>
    217 <seg>~/.texmf-config, /usr/include/kpathsea, /usr/share/texinfo/html,
    218 /usr/share/texmf, /usr/share/texi2html and /usr/share/texmf-var</seg>
    219 </seglistitem>
    220 </segmentedlist>
    221 
    222 <variablelist>
    223 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    224 <?dbfo list-presentation="list"?>
    225 
    226 <varlistentry id="tex-programs">
    227 <term><command>TeX programs</command></term>
    228 <listitem><para>included in the <application>TeX</application> package are too
    229 numerous to individually list. Please refer to the individual program man
    230 pages and <ulink url="file:///usr/share/texmf/doc/index.html"/> for details,
    231 as well as a tour of the expansive
    232 <application>TeX</application> documentation.</para>
    233 <indexterm zone="tex tex-programs">
    234 <primary sortas="b-TeX-programs">TeX programs</primary></indexterm>
    235 </listitem>
    236 </varlistentry>
    237 
    238 <varlistentry id="libkpathsea">
    239 <term><filename class='libraryfile'>libkpathsea.a</filename></term>
    240 <listitem><para>contains functions used by <application>TeX</application>
    241 for searching and cataloging path names.</para>
    242 <indexterm zone="tex libkpathsea">
    243 <primary sortas="c-libkpathsea">libkpathsea.a</primary></indexterm>
    244 </listitem>
    245 </varlistentry>
    246 </variablelist>
    247 
    248 </sect2>
     177texconfig font rw</userinput></screen>
     178
     179    <note>
     180      <para>The paper size may be changed to a4, as is used in most
     181      countries.</para>
     182    </note>
     183
     184  </sect2>
     185
     186  <sect2 role="commands">
     187    <title>Command Explanations</title>
     188
     189    <para><parameter>--with-x=no</parameter>: This switch will avoid any
     190    <application>X</application> dependencies. <application>TeX</application>
     191    can be compiled with <application>X</application> support, notably for
     192    <command>xdvi</command>. If this is desired, remove this configure
     193    option.</para>
     194
     195    <para><parameter>--exec-prefix=/usr --bindir=/usr/bin</parameter>: These
     196    switches ensure that <application>TeX</application> binaries are installed
     197    in <filename class="directory">/usr/bin</filename>.</para>
     198
     199    <para><parameter>--without-texinfo</parameter>: A default LFS installation
     200    already has the <application>Texinfo</application> package installed; this
     201    switch will avoid overwriting it with the included
     202    <application>Texinfo</application> package.</para>
     203
     204    <para><parameter>--with-system-ncurses</parameter>: This switch specifies
     205    using the already installed <filename
     206    class="libraryfile">libncurses</filename> library.</para>
     207
     208    <para><parameter>--with-system-zlib</parameter>: LFS systems starting
     209    with version 4.0 have <application>Zlib</application> installed as part
     210    of the base operating system; this switch avoids building it here.</para>
     211
     212    <para><option>--disable-a4</option>: Use this option to set the default
     213    paper size to letter and the default unit to inch.</para>
     214
     215    <para><command>texconfig dvips paper letter</command>: This command sets
     216    the default paper size for <application>TeX</application>.</para>
     217
     218    <para><command>texconfig font rw</command>: This command specifies writable
     219    fonts.</para>
     220
     221    <tip>
     222      <para>Run <command>./configure --help</command> for information about
     223      using other switches which will enable the build to use any installed
     224      packages you may have on your system.</para>
     225    </tip>
     226
     227  </sect2>
     228
     229  <sect2 role="content">
     230    <title>Contents</title>
     231
     232    <segmentedlist>
     233      <segtitle>Installed Programs</segtitle>
     234      <segtitle>Installed Library</segtitle>
     235      <segtitle>Installed Directories</segtitle>
     236
     237      <seglistitem>
     238        <seg>100 separate binaries and scripts along with 30 symlinks to these
     239        programs.</seg>
     240        <seg>libkpathsea.a</seg>
     241        <seg>~/.texmf-config, /usr/include/kpathsea, /usr/share/texinfo/html,
     242        /usr/share/texmf, /usr/share/texi2html and /usr/share/texmf-var</seg>
     243      </seglistitem>
     244    </segmentedlist>
     245
     246    <variablelist>
     247      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     248      <?dbfo list-presentation="list"?>
     249      <?dbhtml list-presentation="table"?>
     250
     251      <varlistentry id="tex-programs">
     252        <term><command>TeX programs</command></term>
     253        <listitem>
     254          <para>included in the <application>TeX</application> package are too
     255          numerous to individually list. Please refer to the individual program
     256          man pages and <ulink url="file:///usr/share/texmf/doc/index.html"/>
     257          for details, as well as a tour of the expansive
     258          <application>TeX</application> documentation.</para>
     259          <indexterm zone="tex tex-programs">
     260            <primary sortas="b-TeX-programs">TeX programs</primary>
     261          </indexterm>
     262        </listitem>
     263      </varlistentry>
     264
     265      <varlistentry id="libkpathsea">
     266        <term><filename class='libraryfile'>libkpathsea.a</filename></term>
     267        <listitem>
     268          <para>contains functions used by <application>TeX</application>
     269          for searching and cataloging path names.</para>
     270          <indexterm zone="tex libkpathsea">
     271            <primary sortas="c-libkpathsea">libkpathsea.a</primary>
     272          </indexterm>
     273        </listitem>
     274      </varlistentry>
     275
     276    </variablelist>
     277
     278  </sect2>
    249279
    250280</sect1>
Note: See TracChangeset for help on using the changeset viewer.