1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
\section{Introduction}
\label{sec:intro}
\subsection{\TeX\ Live and the \TeX\ Collection}
This document describes the main features of the \TL{} software
distribution\Dash \TeX{} and related programs for \acro{GNU}/Linux
and other Unix flavors, \MacOSX, and Windows systems.
You may have acquired \TL{} by downloading, or on the \TK{} \DVD,
which \TeX{} usergroups distribute among their members. Section
\ref{sec:multiple-dist} briefly describes the contents of this \DVD.
Both \TL{} and the \TK{} are cooperative efforts by the \TeX{} user
groups. This document mainly describes \TL{} itself.
\TL{} includes executables for \TeX{}, \LaTeXe{}, \ConTeXt,
\MF, \MP, \BibTeX{} and many other programs; an extensive collection
of macros, fonts and documentation; and support for typesetting in
many different scripts from around the world.
\TL{} packages are regularly updated from
\acro{CTAN}: \url{http://www.ctan.org}.
For a brief summary of the major changes in this edition of \TL{},
see the end of the document, section~\ref{sec:history}
(\p.\pageref{sec:history}).
\subsection{Operating system support}
\label{sec:os_support}
\TL{} contains binaries for many Linux- and Unix architectures,
including \MacOSX. The included sources should enable installation
on additional Linux- and Unix platforms.
As to Windows: only Windows 2000 and later are supported. Windows
9\textit{x}, ME and NT have been dropped. Because of this
restriction, Windows requires less special treatment compared to
Linux and Unix. There are no 64-bit executables for Windows, but the
32-bit executables should run on 64-bit systems.
See section~\ref{sec:multiple-dist} for alternate solutions
for Windows and \MacOSX.
\subsection{Basic usage of \protect\TL{}}
\label{sec:basic}
You can install \TL{} either from \DVD{} or over the internet. The
net installer itself is very small and downloads everything needed
from the internet. The net installer is an attractive option if you
need only a fraction of the complete \TL.
The \DVD{} installer lets you install to a local disk, but you can
also run \TL{} directly from the \DVD{} (or from a \DVD{} image, if
your system supports that).
\noindent This is described in the
installation sections following, but here is a quick start:
\begin{itemize*}
\item The installation script is \filename{install-tl}, which has
both a text mode (default for Unix) and a \GUI{} mode (default for
Windows).
\item One of the installed items is \prog{tlmgr} or \TL\ Manager,
which can also be used in \GUI{} mode and in text mode. You can
use it to install and uninstall packages and do various
configuration tasks.
\end{itemize*}
\subsection{Getting help}
\label{sec:help}
The \TeX{} community is both active and friendly, and virtually all
serious questions end up getting answered. However, the support is
informal, done by volunteers and casual readers, so it's especially
important that you do your homework before asking. (If you prefer
guaranteed commercial support, you can forego \TL{} completely and
purchase a vendor's system; \url{http://tug.org/interest.html#vendors}
has a list.)
Here is a list of resources, approximately in the order we recommend
using them:
\begin{description}
\item [Getting Started] If you are new to \TeX, the web page
\url{http://tug.org/begin.html} gives a brief introduction to the system.
\item [\TeX{} \acro{FAQ}] The \TeX{} \acro{FAQ} is a huge compendium of
answers to all sorts of questions, from the most basic to the most
arcane. It is included on \TL{} in \OnCD{texmf-doc/doc/english/FAQ-en}, and is
available on the Internet through \url{http://www.tex.ac.uk/faq}.
Please check here first.
\item [\TeX{} Catalogue] If you are looking for a specific package,
font, program, etc., the \TeX{} Catalogue is the place to look. It is a
huge collection of all \TeX{}-related items. See
\OnCD{texmf-doc/doc/english/catalogue}, or
\url{http://www.ctan.org/tex-archive/help/Catalogue}.
\item [\TeX{} Web Resources] The web page
\url{http://tug.org/interest.html} has many \TeX{}-related links, in
particular for numerous books, manuals, and articles on all aspects of
the system.
\item [support archives] The two principal support forums are the
Usenet newsgroup \url{news:comp.text.tex} and the mailing list
\email{texhax@tug.org}. Their archives have years of past
questions and answers for your searching pleasure, via
\url{http://groups.google.com/groups?group=comp.text.tex} and
\url{http://tug.org/mail-archives/texhax}, respectively. And a general web
search, for example on \url{http://google.com}, never hurts.
\item [asking questions] If you cannot find an answer, you can post to
\dirname{comp.text.tex} through Google or your newsreader, or to
\email{texhax@tug.org} through email. But before you post,
\emph{please} read this \acro{FAQ} entry on asking questions in such a
way that you're most likely to get an answer:
\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.
\item [\TL{} support] If you want to report a bug or have
suggestions or comments on the \TL{} distribution, installation, or
documentation, the mailing list is \email{tex-live@tug.org}. However,
if your question is about how to use a particular program included in
\TL{}, you are better off writing to that program's maintainer or
mailing list.
\end{description}
The other side of the coin is helping others who have questions. Both
\dirname{comp.text.tex} and \code{texhax} are open to anyone, so feel
free to join, start reading, and help out where you can. Welcome to
\TeX{}!
|
