source: archive/tetex.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 13.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- <!ENTITY tetex-download-http "http://www.tug.org/tex-archive/systems/unix/teTeX/&tetex-version;/distrib/tetex-src-&tetex-version;.tar.gz" > -->
8 <!-- <!ENTITY tetex-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/&tetex-version;/distrib/tetex-src-&tetex-version;.tar.gz"> -->
9 <!ENTITY tetex-download-http "&sources-anduin-http;/t/tetex-src-&tetex-version;.tar.gz" >
10 <!ENTITY tetex-download-ftp "&sources-anduin-ftp;/t/tetex-src-&tetex-version;.tar.gz">
11 <!ENTITY tetex-md5sum "944a4641e79e61043fdaf8f38ecbb4b3">
12 <!ENTITY tetex-size "12.7 MB">
13 <!ENTITY tetex-buildsize "423 MB (549 MB with optional tarball, additional 231 MB for CM-Super fonts)">
14 <!ENTITY tetex-time "2.1 SBU">
15
16 <!-- <!ENTITY texmf-download-http "http://www.tug.org/tex-archive/systems/unix/teTeX/&tetex-version;/distrib/tetex-texmf-&tetex-version;.tar.gz" > -->
17 <!-- <!ENTITY texmf-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/&tetex-version;/distrib/tetex-texmf-&tetex-version;.tar.gz"> -->
18 <!ENTITY texmf-download-http "&sources-anduin-http;/t/tetex-texmf-&tetex-version;.tar.gz" >
19 <!ENTITY texmf-download-ftp "&sources-anduin-ftp;/t/tetex-texmf-&tetex-version;.tar.gz">
20 <!ENTITY texmf-md5sum "ed9d30d9162d16ac8d5065cde6e0f6fa">
21 <!ENTITY texmf-size "87.1 MB">
22
23 <!-- <!ENTITY texmfsrc-download-http "http://www.tug.org/tex-archive/systems/unix/teTeX/&tetex-version;/distrib/tetex-texmfsrc-&tetex-version;.tar.gz" > -->
24 <!-- <!ENTITY texmfsrc-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/&tetex-version;/distrib/tetex-texmfsrc-&tetex-version;.tar.gz"> -->
25 <!ENTITY texmfsrc-download-http "&sources-anduin-http;/t/tetex-texmfsrc-&tetex-version;.tar.gz" >
26 <!ENTITY texmfsrc-download-ftp "&sources-anduin-ftp;/t/tetex-texmfsrc-&tetex-version;.tar.gz">
27 <!ENTITY texmfsrc-md5sum "66c32a11964a49982ba2a32d3bbfe7f5">
28 <!ENTITY texmfsrc-size "57.7 MB">
29
30 <!ENTITY cmsupersrc-download-http "&sources-anduin-http;/t/tetex-cm-super.tar.bz2" >
31 <!ENTITY cmsupersrc-download-ftp "&sources-anduin-ftp;/t/tetex-cm-super.tar.bz2">
32 <!ENTITY cmsupersrc-md5sum "d7c89fcb35f625b02853a0881a4ec760">
33 <!ENTITY cmsupersrc-size "63.8 MB">
34]>
35
36<sect1 id="tetex" xreflabel="teTeX-&tetex-version;">
37 <?dbhtml filename="tetex.html"?>
38
39 <sect1info>
40 <date>$Date$</date>
41 </sect1info>
42
43 <title>teTeX-&tetex-version;</title>
44
45 <indexterm zone="tetex">
46 <primary sortas="a-teTeX">teTeX</primary>
47 </indexterm>
48
49 <sect2 role="package">
50 <title>Introduction to teTeX</title>
51
52 <para><application>teTeX</application> is an implementation of Donald
53 Knuth's TeX typesetting program. This package is able to create documents
54 in a variety of formats. The optional <filename>texmfsrc</filename> (TeX
55 METAFONT) tarball contains source code for programs to create and
56 manipulate TeX fonts.</para>
57
58 <bridgehead renderas="sect3">Package Information</bridgehead>
59 <itemizedlist spacing="compact">
60 <listitem>
61 <para>Download (HTTP): <ulink url="&tetex-download-http;"/></para>
62 </listitem>
63 <listitem>
64 <para>Download (FTP): <ulink url="&tetex-download-ftp;"/></para>
65 </listitem>
66 <listitem>
67 <para>Download MD5 sum: &tetex-md5sum;</para>
68 </listitem>
69 <listitem>
70 <para>Download size: &tetex-size;</para>
71 </listitem>
72 <listitem>
73 <para>Estimated disk space required: &tetex-buildsize;</para>
74 </listitem>
75 <listitem>
76 <para>Estimated build time: &tetex-time;</para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
81
82 <itemizedlist spacing='compact'>
83 <title>Required Patches</title>
84 <listitem>
85 <para><ulink url="&patch-root;/tetex-&tetex-version;-gcc_4.4-1.patch"/></para>
86 </listitem>
87 <listitem>
88 <para><ulink url="&patch-root;/tetex-&tetex-version;-glibc-1.patch"/></para>
89 </listitem>
90 </itemizedlist>
91
92 <itemizedlist spacing='compact'>
93 <title>Required Macros and Fonts</title>
94 <listitem>
95 <para>Download (HTTP): <ulink url="&texmf-download-http;"/></para>
96 </listitem>
97 <listitem>
98 <para>Download (FTP): <ulink url="&texmf-download-ftp;"/></para>
99 </listitem>
100 <listitem>
101 <para>Download MD5 sum: &texmf-md5sum;</para>
102 </listitem>
103 <listitem>
104 <para>Download size: &texmf-size;</para>
105 </listitem>
106 </itemizedlist>
107
108 <itemizedlist spacing='compact'>
109 <title>Optional 'texmf' Sources:</title>
110 <listitem>
111 <para>Download (HTTP): <ulink url="&texmfsrc-download-http;"/></para>
112 </listitem>
113 <listitem>
114 <para>Download (FTP): <ulink url="&texmfsrc-download-ftp;"/></para>
115 </listitem>
116 <listitem>
117 <para>Download MD5 sum: &texmfsrc-md5sum;</para>
118 </listitem>
119 <listitem>
120 <para>Download size: &texmfsrc-size;</para>
121 </listitem>
122 </itemizedlist>
123
124 <itemizedlist spacing='compact'>
125 <title>Optional 'cm-super' Sources:</title>
126 <listitem>
127 <para>Download (HTTP): <ulink url="&cmsupersrc-download-http;"/></para>
128 </listitem>
129 <listitem>
130 <para>Download (FTP): <ulink url="&cmsupersrc-download-ftp;"/></para>
131 </listitem>
132 <listitem>
133 <para>Download MD5 sum: &cmsupersrc-md5sum;</para>
134 </listitem>
135 <listitem>
136 <para>Download size: &cmsupersrc-size;</para>
137 </listitem>
138 </itemizedlist>
139
140 <bridgehead renderas="sect3">teTeX Dependencies</bridgehead>
141
142 <bridgehead renderas="sect4">Required</bridgehead>
143 <para role="required"><xref linkend="ed"/></para>
144
145 <bridgehead renderas="sect4">Optional</bridgehead>
146 <para role="optional"><xref linkend="libpng"/>,
147 <xref linkend="x-window-system"/>,
148 <xref linkend="tk-perl"/>,
149 <ulink url="http://www.sfr-fresh.com/linux/misc/t1lib">t1lib</ulink>, and
150 <ulink url="http://www.boutell.com/gd/">GD</ulink></para>
151
152 <para condition="html" role="usernotes">User Notes:
153 <ulink url="&blfs-wiki;/tetex"/></para>
154
155 </sect2>
156
157 <sect2 role="installation">
158 <title>Installation of teTeX</title>
159
160 <para>Before building <application>teTeX</application>, the macros and
161 fonts package (<filename>texmf</filename> tarball) must be installed.
162 Install the macros and fonts using the following commands as the
163 <systemitem class="username">root</systemitem> user:</para>
164
165<screen role="root"><userinput>install -v -d -m755 /usr/share/texmf &amp;&amp;
166gzip -dc ../tetex-texmf-&tetex-version;.tar.gz \
167 | (umask 0; cd /usr/share/texmf; tar -xvf -)</userinput></screen>
168
169 <para>If the optional <filename>texmfsrc</filename> source code TAR ball
170 was downloaded, unpack it now as the <systemitem
171 class="username">root</systemitem> user:</para>
172
173<screen role="root"><userinput>gzip -dc ../tetex-texmfsrc-&tetex-version;.tar.gz \
174 | (umask 0; cd /usr/share/texmf; tar -xvf -)</userinput></screen>
175
176 <para>Install <application>teTeX</application> by running the following
177 commands:</para>
178
179<screen><userinput>patch -Np1 -i ../tetex-&tetex-version;-gcc_4.4-1.patch &amp;&amp;
180patch -Np1 -i ../tetex-&tetex-version;-glibc-1.patch &amp;&amp;
181./configure --prefix=/usr \
182 --exec-prefix=/usr \
183 --bindir=/usr/bin \
184 --without-texinfo \
185 --with-x=no \
186 --with-system-ncurses \
187 --with-system-zlib &amp;&amp;
188make all</userinput></screen>
189
190 <para>To test the results, issue: <command>make check</command>. The tests
191 should complete without errors (there may be some errors which are
192 ignored).</para>
193
194 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
195
196<screen role="root"><userinput>make install &amp;&amp;
197texconfig-sys dvips paper letter &amp;&amp;
198texconfig-sys font rw</userinput></screen>
199
200 <note>
201 <para>The paper size may be changed to a4, as is used in most
202 countries.</para>
203 </note>
204
205 <para>To install the optional cm-super fonts, perform the following
206 instructions as the <systemitem class="username">root</systemitem>
207 user:</para>
208
209<screen><userinput>tar -xf ../tetex-cm-super.tar.bz2 &amp;&amp;
210FONTDIR=$(kpsewhich --expand-var '$TEXMFMAIN') &amp;&amp;
211mkdir -v -p $FONTDIR/fonts/afm/public/cm-super \
212 $FONTDIR/fonts/type1/public/cm-super \
213 $FONTDIR/fonts/enc/dvips/cm-super \
214 $FONTDIR/fonts/map/dvips/cm-super &amp;&amp;
215
216cp -v cm-super/pfb/*.pfb $FONTDIR/fonts/type1/public/cm-super/ &amp;&amp;
217
218gunzip cm-super/afm/* &amp;&amp;
219cp -v cm-super/afm/*.afm $FONTDIR/fonts/afm/public/cm-super/ &amp;&amp;
220
221cp -v cm-super/dvips/*.enc $FONTDIR/fonts/enc/dvips/cm-super/ &amp;&amp;
222cp -v cm-super/dvips/*.map $FONTDIR/fonts/map/dvips/cm-super/ &amp;&amp;
223
224cat &gt;&gt; $FONTDIR/web2c/updmap.cfg &lt;&lt; "EOF" &amp;&amp;
225MixedMap cm-super-t1.map
226MixedMap cm-super-t2a.map
227MixedMap cm-super-t2b.map
228MixedMap cm-super-t2c.map
229MixedMap cm-super-ts1.map
230MixedMap cm-super-x2.map
231EOF
232
233install -v -m644 -D cm-super/type1ec.sty \
234 $FONTDIR/tex/latex/cm-super/type1ec.sty &amp;&amp;
235
236mktexlsr &amp;&amp;
237updmap-sys &amp;&amp;
238
239unset FONTDIR</userinput></screen>
240
241 </sect2>
242
243 <sect2 role="commands">
244 <title>Command Explanations</title>
245
246 <para><parameter>--with-x=no</parameter>: This switch will avoid any
247 <application>X</application> dependencies. <application>teTeX</application>
248 can be compiled with <application>X</application> support, notably for
249 <command>xdvi</command>. If this is desired, remove this parameter.</para>
250
251 <para><parameter>--exec-prefix=/usr --bindir=/usr/bin</parameter>: These
252 switches ensure that <application>teTeX</application> binaries are installed
253 in <filename class="directory">/usr/bin</filename>.</para>
254
255 <para><parameter>--without-texinfo</parameter>: A default LFS installation
256 already has the <application>Texinfo</application> package installed. This
257 switch will avoid overwriting it with the included
258 <application>Texinfo</application> package.</para>
259
260 <para><parameter>--with-system-ncurses</parameter>: This switch specifies
261 using the already installed <filename
262 class="libraryfile">libncurses</filename> library.</para>
263
264 <para><parameter>--with-system-zlib</parameter>: A default LFS installation
265 already has the <application>Zlib</application> library installed. This
266 switch will avoid replacing it with the included
267 <application>Zlib</application> library.</para>
268
269 <para><option>--disable-a4</option>: Use this option to set the default
270 paper size to letter and the default unit to inch.</para>
271
272 <para><command>texconfig-sys dvips paper letter</command>: This command
273 sets the default paper size for <application>teTeX</application>.</para>
274
275 <para><command>texconfig-sys font rw</command>: This command specifies
276 creating and using a directory for globally writeable fonts.</para>
277
278 <para><command>mktexlsr</command>: This command recreates the
279 <application>teTeX</application> <filename>ls-R</filename> databases after
280 installing the CM-Super fonts.</para>
281
282 <para><command>updmap-sys</command>: This command updates the system-wide
283 font configuration to include the CM-Super fonts.</para>
284
285 <tip>
286 <para>Run <command>./configure --help</command> for information about
287 using other switches which will enable the build to use other installed
288 packages you may have on your system.</para>
289 </tip>
290
291 </sect2>
292
293 <sect2 role="content">
294 <title>Contents</title>
295
296 <segmentedlist>
297 <segtitle>Installed Programs</segtitle>
298 <segtitle>Installed Library</segtitle>
299 <segtitle>Installed Directories</segtitle>
300
301 <seglistitem>
302 <seg>100 separate binaries and scripts along with 30 symlinks to these
303 programs.</seg>
304 <seg>libkpathsea.a</seg>
305 <seg>/usr/include/kpathsea, /var/tmp/texfonts and the following
306 subdirectories of /usr/share/: texi2html, texinfo/html, texmf,
307 texmf-config and texmf-var</seg>
308 </seglistitem>
309 </segmentedlist>
310
311 <variablelist>
312 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
313 <?dbfo list-presentation="list"?>
314 <?dbhtml list-presentation="table"?>
315
316 <varlistentry id="tetex-programs">
317 <term><command>teTeX programs</command></term>
318 <listitem>
319 <para>included in the <application>teTeX</application> package are too
320 numerous to individually list. Please refer to the individual program
321 man pages and <ulink url="file:///usr/share/texmf/doc/index.html"/>
322 for details, as well as a tour of the expansive
323 <application>teTeX</application> documentation.</para>
324 <indexterm zone="tetex tetex-programs">
325 <primary sortas="b-teTeX-programs">teTeX programs</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329
330 <varlistentry id="libkpathsea">
331 <term><filename class='libraryfile'>libkpathsea.a</filename></term>
332 <listitem>
333 <para>contains functions used by <application>teTeX</application>
334 for searching and cataloging path names.</para>
335 <indexterm zone="tetex libkpathsea">
336 <primary sortas="c-libkpathsea">libkpathsea.a</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 </variablelist>
342
343 </sect2>
344
345</sect1>
Note: See TracBrowser for help on using the repository browser.