~ubuntu-branches/ubuntu/jaunty/luatex/jaunty

« back to all changes in this revision

Viewing changes to src/texk/kpathsea/unixtex.texi

  • Committer: Bazaar Package Importer
  • Author(s): Norbert Preining
  • Date: 2007-09-24 12:56:11 UTC
  • Revision ID: james.westby@ubuntu.com-20070924125611-a8ge689azbptxvla
Tags: upstream-0.11.2
ImportĀ upstreamĀ versionĀ 0.11.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
@ifclear version
 
2
@defcodeindex fl
 
3
@defcodeindex op
 
4
@end ifclear
 
5
 
 
6
@node unixtex.ftp
 
7
@section @file{unixtex.ftp}: Obtaining @TeX{}
 
8
 
 
9
@cindex obtaining @TeX{}
 
10
@cindex retrieving @TeX{}
 
11
 
 
12
@flindex unixtex.ftp
 
13
@flindex tug.org
 
14
@flindex www.tug.org
 
15
@flindex ftp.tug.org
 
16
This
 
17
@iftex
 
18
chapter
 
19
@end iftex
 
20
is @uref{ftp://ftp.tug.org/tex/unixtex.ftp}, last updated 26 December
 
21
2003.  Also available as @uref{http://www.tug.org/unixtex.ftp}.  The
 
22
IP address is currently @code{[130.225.2.178]}.  It is also in
 
23
Kpathsea source distributions as @file{etc/unixtex.ftp} (although the
 
24
network version is usually newer).  Mail @email{tex-k@@mail.tug.org}
 
25
with comments or questions.
 
26
 
 
27
Following are general instructions for Unix or other sites who wish to
 
28
acquire the Web2c distribution, (plain) @TeX{}, La@TeX{} (2e),
 
29
Bib@TeX{}, Metafont, MetaPost, DVI processors for the X window system,
 
30
PostScript, the PCL language in the HP LaserJet, and related programs.
 
31
They are oriented towards building from the original sources, though
 
32
some information on alternative packages is included in the last
 
33
section.  See also @uref{http://www.tug.org/web2c/}, the Web2c and
 
34
Kpathsea home page.
 
35
 
 
36
Please note that the Web2c distribution is a bare-bones distribution
 
37
in source form, and building a complete installation from it is a
 
38
non-trivial matter.  For most uses, it is a better idea to install a
 
39
distribution with pre-packaged binaries for your platform.  The
 
40
principal example of such a distribution is @TeX{} Live
 
41
(@uref{http://www.tug.org/texlive/}), which is based on the
 
42
Web2c sources.
 
43
 
 
44
Please consider joining the @TeX{} Users Group (TUG) or another user
 
45
group of your choice to help support the maintenance and development
 
46
of the programs you retrieve.  See @uref{http://www.tug.org/join.html}
 
47
for information and the membership registration form, and
 
48
@uref{http://www.tug.org/usergroups.html} for a listing of all user groups.
 
49
 
 
50
For actual installation instructions after obtaining the necessary
 
51
sources, see @ref{Installation}.  A copy is in the distribution file
 
52
@file{kpathsea/INSTALL}.
 
53
 
 
54
@menu
 
55
* Electronic distribution::  CTAN and so forth.
 
56
* CD-ROM distribution::
 
57
* Other TeX packages::
 
58
@end menu
 
59
 
 
60
@c * Tape distribution::
 
61
@c used to be in this menu.
 
62
 
 
63
@node Electronic distribution
 
64
@subsection Electronic distribution
 
65
 
 
66
@cindex ftp retrieval
 
67
@cindex obtaining Web2c by ftp
 
68
@cindex distributions, via ftp
 
69
 
 
70
@cindex CTAN, defined
 
71
@cindex backbone of CTAN
 
72
In many places we refer to @var{CTAN:}.  This is @emph{both} a host name
 
73
and a directory name.  Here are the primary locations:
 
74
 
 
75
@example
 
76
@uref{ftp://ctan.tug.org/tex-archive/}    @r{(Vermont, USA)}
 
77
@uref{ftp://ftp.dante.de/tex-archive/}    @r{(Germany)}
 
78
@uref{ftp://ftp.tex.ac.uk/tex-archive/}   @r{(England)}
 
79
@end example
 
80
 
 
81
@noindent
 
82
@flindex README.mirrors
 
83
@flindex CTAN.sites
 
84
@cindex mirrors, FTP
 
85
CTAN has many mirrors worldwide; see the top-level file
 
86
@file{README.mirrors} from one of the sites above or see
 
87
@uref{http://www.tug.org/CTAN.sites}.
 
88
 
 
89
@cindex World Wide Web CTAN access
 
90
@cindex email CTAN access
 
91
@cindex NFS CTAN access
 
92
You can also access CTAN via the World Wide Web, electronic
 
93
mail, or NFS.  The same @file{README.mirrors} file explains how.
 
94
 
 
95
@cindex binary mode, for file transfers
 
96
You will need to retrieve some or all of the following archives,
 
97
depending on your needs (don't forget to set binary mode for file
 
98
transfers):
 
99
 
 
100
@table @asis
 
101
@item @file{@var{CTAN:}/systems/web2c/web.tar.gz}
 
102
@cindex Knuth, Donald E., original author
 
103
The original WEB source files, written primarily by Don Knuth.  Required
 
104
unless you already have this @file{web} version.  (The WEB sources
 
105
change irregularly with respect to Web2c itself.)  Unpacks into
 
106
@file{web2c-@var{version}}.
 
107
 
 
108
@item @file{@var{CTAN:}/systems/web2c/web2c.tar.gz}
 
109
The Web2c system.  Required.  Also unpacks into
 
110
@file{web2c-@var{version}}.
 
111
 
 
112
@item @file{@var{CTAN:}/systems/web2c/web2c-etex.tar.gz}
 
113
Additions to the Web2c system for building e-@TeX{}.  Optional.  Unpacks
 
114
into @file{web2c-@var{version}}.
 
115
 
 
116
@item @file{@var{CTAN:}/systems/web2c/etexlib.tar.gz}
 
117
Additions to the texmf tree needed to build e-@TeX{}.  Optional.
 
118
Unpacks into @file{texmf/}.
 
119
 
 
120
@item @file{@var{CTAN:}/systems/web2c/etexdoc.tar.gz}
 
121
Documentation for e-@TeX{} as an addition to the texmf tree.  Optional.
 
122
Unpacks into @file{texmf/}.
 
123
 
 
124
@item @file{@var{CTAN:}/systems/web2c/web2c-omega.tar.gz}
 
125
Additions to the Web2c system for building Omega.  Optional.  Unpacks
 
126
into @file{web2c-@var{version}}.
 
127
 
 
128
@item @file{@var{CTAN:}/systems/web2c/omegalib.tar.gz}
 
129
Additions to the texmf tree needed to build Omega.  Optional.  Unpacks
 
130
into @file{texmf/}.
 
131
 
 
132
@item @file{@var{CTAN:}/systems/web2c/omegadoc.tar.gz}
 
133
Documentation for Omega as an addition to the texmf tree.  Optional.
 
134
Unpacks into @file{texmf/}.
 
135
 
 
136
@item @file{@var{CTAN:}/systems/web2c/web2c-pdftex.tar.gz}
 
137
Additions to the Web2c system for building pdf@TeX{}.  Optional.
 
138
Unpacks into @file{web2c-@var{version}}.
 
139
 
 
140
@item @file{@var{CTAN:}/systems/web2c/pdftexlib.tar.gz}
 
141
Additions to the texmf tree needed to build pdf@TeX{}.  Optional.
 
142
Unpacks into @file{texmf/}.
 
143
 
 
144
@item @file{@var{CTAN:}/dviware/xdvik/xdvik.tar.gz}
 
145
X window system DVI previewer.  Unpacks into @file{xdvik-@var{version}}.
 
146
Optional.
 
147
@end table
 
148
 
 
149
Additional drivers, macro files, and other support are needed to build
 
150
a working system.  These are available in te@TeX{}.
 
151
 
 
152
All that said, the originating host for the software above is
 
153
@file{ftp.tug.org}.  You can retrieve these distributions (but not much
 
154
else) from the @file{tex/} directory on that host.
 
155
 
 
156
 
 
157
@node CD-ROM distribution
 
158
@subsection CD-ROM distribution
 
159
 
 
160
@cindex CD-ROM distributions
 
161
@cindex obtaining Web2c on CD-ROM
 
162
@cindex distributions, on CD-ROM
 
163
 
 
164
Numerous organizations distribute various @TeX{} CD-ROM's (and DVD's):
 
165
 
 
166
@itemize @bullet
 
167
@item
 
168
@cindex @TeX{} Live CD-ROM
 
169
Virtually all the @TeX{} user groups collaborate to produce the
 
170
@cite{@TeX{} Live} distribution once a year; see
 
171
@uref{http://www.tug.org/texlive/} for more information.
 
172
 
 
173
@item
 
174
@cindex Free Software Foundation
 
175
@cindex FSF Source Code CD-ROM
 
176
The Free Software Foundation's @cite{Source Code CD-ROM} contains the
 
177
minimal @TeX{} source distribution described in the previous section
 
178
(i.e., enough to print GNU documentation); email
 
179
@email{gnu@@gnu.org}.
 
180
 
 
181
@c Commented out: the information is outdated in way or another.
 
182
 
 
183
@c @item
 
184
@c The Gateway@! CD-ROM set contains a runnable NetBSD/Amiga distribution
 
185
@c and sources; see @url{http://www.netbsd.org/Sites/cdroms.html}.
 
186
 
 
187
@c @item
 
188
@c The InfoMagic CD-ROM is a copy of CTAN (see previous section); see
 
189
@c @url{http://www.infomagic.com}.
 
190
 
 
191
@c @item
 
192
@c @cindex 4all@TeX{} Live CD-ROM
 
193
@c @cindex NTG
 
194
@c NTG (Dutch-speaking @TeX{} user group) produced the 4all@TeX{} CD-ROM;
 
195
@c email @email{ntg@@nic.surfnet.nl}, or see
 
196
@c @url{http://www.ntg.nl/4allcd/}.  This is a runnable system.
 
197
 
 
198
@c @item
 
199
@c @cindex Prime Time @TeX{}cetera CD-ROM
 
200
@c The Prime Time @TeX{}cetera CD-ROM is also a copy of CTAN; email
 
201
@c @email{ptf@@ctcl.com} or see @url{http://www.ptf.com/ptf/}.
 
202
 
 
203
@c @item
 
204
@c @cindex Walnut Creek @TeX{} CD-ROM
 
205
@c Walnut Creek's @TeX{} CD-ROM is also a copy of CTAN; email
 
206
@c @email{info@@cdrom.com} or see
 
207
@c @url{http://www.cdrom.com:/titles/tex.html}.
 
208
 
 
209
@item
 
210
@cindex Linux, using Web2c
 
211
Most Linux distributions include some @TeX{} package based on
 
212
Web2c; see the Linux documentation file @samp{Distribution-HOWTO} for a
 
213
comparison of Linux distributions, available (for example) via
 
214
@uref{http://www.linux.org}.
 
215
@end itemize
 
216
 
 
217
If you know of additional @TeX{} distributions to add to this
 
218
list, please inform @email{tex-k@@mail.tug.org}.
 
219
 
 
220
@ignore
 
221
 
 
222
@node Tape distribution
 
223
@subsection Tape distribution
 
224
 
 
225
@cindex tape distribution
 
226
@cindex obtaining @TeX{} on tape
 
227
@cindex distributions, on tape
 
228
 
 
229
@cindex Northwest Computing Support Center
 
230
@flindex unixtex@@u.washington.edu
 
231
@cindex support organization
 
232
You can obtain a complete @TeX{} distribution, including Web2c, on tape.
 
233
Contact:
 
234
@display
 
235
Pierre MacKay / Denny Hall, Mail Stop DH-10 / Department of Classics
 
236
University of Washington / Seattle, WA 98195 / USA
 
237
phone: 206-543-2268; email: @email{unixtex@@u.washington.edu}
 
238
@end display
 
239
 
 
240
At this writing, the distribution is available in @code{tar} format on
 
241
4@dmn{mm} DAT cartridges, and the
 
242
cost is US$210.  Make checks payable to the University of Washington,
 
243
drawn on a U.S. bank.  Purchase orders are acceptable, but they carry an
 
244
extra charge of $10 to pay for invoice processing.  Overseas sites,
 
245
please add $20 for shipment via air parcel post, or $30 for shipment via
 
246
courier.
 
247
 
 
248
@end ignore
 
249
 
 
250
@node Other TeX packages
 
251
@subsection Other @TeX{} packages
 
252
 
 
253
@cindex other @TeX{} distributions
 
254
@cindex @TeX{} distributions besides Web2c
 
255
 
 
256
@cindex Amiga @TeX{} implementations
 
257
@cindex Acorn @TeX{} implementations
 
258
@cindex VMS @TeX{} implementations
 
259
@cindex Macintosh @TeX{} implementations
 
260
@cindex DOS @TeX{} implementations
 
261
@cindex Windows @TeX{} implementations
 
262
Many other @TeX{} implementations are available in
 
263
@file{@var{CTAN:}/systems}, including ready-to-run distributions for
 
264
Unix, Amiga, Acorn, VMS, Macintosh, DOS, and Windows (in various forms).
 
265
Although Web2c has support in the source code for many operating
 
266
systems, and in fact some of the other distributions are based on it,
 
267
it's unlikely to work as distributed on anything but Unix.  (Please
 
268
contribute improvements!)
 
269
 
 
270
@cindex te@TeX{}
 
271
@cindex precompiled Unix binaries
 
272
The principal user-oriented Unix distribution based on Web2c is the
 
273
te@TeX{} distribution.  It includes complete sources, and runs on
 
274
all modern Unix variants, including Linux. It contains many
 
275
@TeX{}-related programs besides those in the core Web2c.
 
276
 
 
277
@flindex labrea.stanford.edu
 
278
@cindex Knuth, Donald E., archive of programs by
 
279
The host @t{labrea.stanford.edu} is the original source for the files
 
280
for which Donald Knuth is directly responsible: @file{tex.web},
 
281
@file{plain.tex}, etc. However, unless you want to build your @TeX{}
 
282
library tree ab initio, it is more reliable and less work to retrieve
 
283
these files as part of the above packages. In any case, @t{labrea} is
 
284
not the canonical source for anything except what was created by
 
285
Stanford @TeX{} project, so do not rely on all the files available at
 
286
that ftp site being up-to-date.