source: archive/tetex.xml

trunk
Last change on this file was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Remove sect1info tags

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