summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/install-tl.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-04-24 00:06:43 +0000
committerKarl Berry <karl@freefriends.org>2017-04-24 00:06:43 +0000
commitc5ad0b1434f22257a1e23eb519ad56e781b03471 (patch)
treede73445841a3ddf62fa95d8ebb558a1978af7efe /Master/texmf-dist/doc/man/man1/install-tl.1
parent31ee6cdaf834071ea876f68b1e4ca6f4e8eac6f4 (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@44005 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/install-tl.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/install-tl.197
1 files changed, 51 insertions, 46 deletions
diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1
index 5349d696e04..55974b03100 100644
--- a/Master/texmf-dist/doc/man/man1/install-tl.1
+++ b/Master/texmf-dist/doc/man/man1/install-tl.1
@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "INSTALL-TL 1"
-.TH INSTALL-TL 1 "2017-04-22" "perl v5.24.1" "User Contributed Perl Documentation"
+.TH INSTALL-TL 1 "2017-04-23" "perl v5.24.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -146,11 +146,12 @@ install\-tl\-advanced.bat [\fIoption\fR]...
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This installer creates a runnable TeX Live installation from various
-media, including over the network. The installer works across all
-platforms supported by TeX Live. For information on initially
-downloading the TeX Live, see <http://tug.org/texlive/acquire.html>.
+media, including over the network, from local hard disk, a \s-1DVD,\s0 etc.
+The installer works across all platforms supported by TeX Live. For
+information on initially downloading the TeX Live, see
+<http://tug.org/texlive/acquire.html>.
.PP
-The basic idea of TeX Live installation is to choose one of the
+The basic idea of TeX Live installation is for you to choose one of the
top-level \fIschemes\fR, each of which is defined as a different set of
\&\fIcollections\fR and \fIpackages\fR, where a collection is a set of packages,
and a package is what contains actual files.
@@ -158,18 +159,18 @@ and a package is what contains actual files.
Within the installer, you can choose a scheme, and further customize the
set of collections to install, but not the set of the packages. To do
that, use \f(CW\*(C`tlmgr\*(C'\fR (reference below) after the initial installation is
-completely.
+complete.
.PP
-The default is \f(CW\*(C`scheme\-full\*(C'\fR, to install everything, and this is highly
-recommended.
+The default is \f(CW\*(C`scheme\-full\*(C'\fR, which installs everything, and this is
+highly recommended.
.SH "REFERENCES"
.IX Header "REFERENCES"
Post-installation configuration, package updates, and much more, are
handled through \fBtlmgr\fR(1), the TeX Live Manager
(<http://tug.org/texlive/tlmgr.html>).
.PP
-The most up-to-date version of this documentation is on the Internet at
-<http://tug.org/texlive/doc/install\-tl.html>.
+The most up-to-date version of this installer documentation is on the
+Internet at <http://tug.org/texlive/doc/install\-tl.html>.
.PP
For the full documentation of TeX Live, see
<http://tug.org/texlive/doc>.
@@ -180,31 +181,31 @@ leading \f(CW\*(C`\-\*(C'\fR or \f(CW\*(C`\-\-\*(C'\fR. An argument value can b
option by either a space or \f(CW\*(C`=\*(C'\fR.
.IP "\fB\-gui\fR [[=]\fImodule\fR]" 4
.IX Item "-gui [[=]module]"
-If no \fImodule\fR is given starts the \f(CW\*(C`perltk\*(C'\fR (see below) \s-1GUI\s0 installer.
+If no \fImodule\fR is given, starts the \f(CW\*(C`perltk\*(C'\fR (see below) \s-1GUI\s0 installer.
.Sp
If \fImodule\fR is given loads the given installer module. Currently the
following modules are supported:
.RS 4
-.ie n .IP """text""" 8
-.el .IP "\f(CWtext\fR" 8
+.ie n .IP """text""" 4
+.el .IP "\f(CWtext\fR" 4
.IX Item "text"
The text mode user interface (default on Unix systems). Same as the
\&\f(CW\*(C`\-no\-gui\*(C'\fR option.
-.ie n .IP """wizard""" 8
-.el .IP "\f(CWwizard\fR" 8
+.ie n .IP """wizard""" 4
+.el .IP "\f(CWwizard\fR" 4
.IX Item "wizard"
The wizard mode user interface (default on Windows), asking only minimal
questions before installing all of TeX Live.
-.ie n .IP """perltk""" 8
-.el .IP "\f(CWperltk\fR" 8
+.ie n .IP """perltk""" 4
+.el .IP "\f(CWperltk\fR" 4
.IX Item "perltk"
The expert \s-1GUI\s0 installer, providing access to more options.
Can also be invoked on Windows by running \f(CW\*(C`install\-tl\-advanced.bat\*(C'\fR.
.RE
.RS 4
.Sp
-The \f(CW\*(C`perltk\*(C'\fR and \f(CW\*(C`wizard\*(C'\fR modules, and thus also when calling with a
-bare \f(CW\*(C`\-gui\*(C'\fR (without \fImodule\fR), requires the Perl/Tk module
+The \f(CW\*(C`perltk\*(C'\fR and \f(CW\*(C`wizard\*(C'\fR modules, and thus also when calling with
+bare \f(CW\*(C`\-gui\*(C'\fR (with no \fImodule\fR), require the Perl/Tk module
(<http://tug.org/texlive/distro.html#perltk>); if Perl/Tk is not
available, installation continues in text mode.
.RE
@@ -226,8 +227,9 @@ simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
.IX Item "-repository url|path"
Specify the package repository to be used as the source of the
installation, either a local directory via \f(CW\*(C`/path/to/directory\*(C'\fR or a
-\&\f(CW\*(C`file:/\*(C'\fR url, or a network location via a \f(CW\*(C`http://\*(C'\fR or \f(CW\*(C`ftp://\*(C'\fR url.
-(No other protocols are supported.)
+\&\f(CW\*(C`file:/\*(C'\fR url, or a network location via a \f(CW\*(C`http://\*(C'\fR, \f(CW\*(C`https://\*(C'\fR, or
+\&\f(CW\*(C`ftp://\*(C'\fR url. (No other protocols are supported, and \f(CW\*(C`http://\*(C'\fR may
+not work on all platforms.)
.Sp
The default is to pick a mirror automatically, using
<http://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror is
@@ -243,7 +245,7 @@ you could choose a particular \s-1CTAN\s0 mirror with something like this:
\& \-repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet
.Ve
.Sp
-Of course a real hostname and its particular top-level \s-1CTAN\s0 path
+Of course a real hostname and its particular top-level \s-1CTAN\s0 directory
have to be specified. The list of \s-1CTAN\s0 mirrors is available at
<http://ctan.org/mirrors>.
.Sp
@@ -275,9 +277,9 @@ choose a good host for you.
.IP "\fB\-all\-options\fR" 4
.IX Item "-all-options"
Normally options not relevant to the current platform are not shown
-(i.e., when running on Unix, Windows-specific options are omitted).
-Giving this command line option allows configuring settings in the
-final \f(CW\*(C`texlive.tlpdb\*(C'\fR that do not have any immediate effect.
+(e.g., when running on Unix, Windows-specific options are omitted).
+Giving this command line option allows configuring such \*(L"foreign\*(R"
+settings.
.IP "\fB\-custom\-bin\fR \fIpath\fR" 4
.IX Item "-custom-bin path"
If you have built your own set of TeX Live binaries (perhaps because
@@ -287,8 +289,12 @@ the current system are present. The installation will continue as
usual, but at the end all files from \fIpath\fR are copied over to
\&\f(CW\*(C`bin/custom/\*(C'\fR under your installation directory and this \f(CW\*(C`bin/custom/\*(C'\fR
directory is what will be added to the path for the post-install
-actions. (By the way, for information on building TeX Live, see
-<http://tug.org/texlive/build.html>).
+actions. To install multiple custom binary sets, manully rename
+\&\f(CW\*(C`custom\*(C'\fR before doing each.
+.Sp
+For more information on custom binaries, see
+<http://tug.org/texlive/custom\-bin.html>. For general information on
+building TeX Live, see <http://tug.org/texlive/build.html>.
.IP "\fB\-debug\-translation\fR" 4
.IX Item "-debug-translation"
In \s-1GUI\s0 mode, this switch makes \f(CW\*(C`tlmgr\*(C'\fR report any missing, or more
@@ -301,7 +307,7 @@ Binaries for this platform must be present and they must actually be
runnable, or installation will fail. \f(CW\*(C`\-force\-arch\*(C'\fR is a synonym.
.IP "\fB\-help\fR, \fB\-\-help\fR, \fB\-?\fR" 4
.IX Item "-help, --help, -?"
-Display this help and exit (on the web via
+Display this help and exit. (This help is on the web at
<http://tug.org/texlive/doc/install\-tl.html>). Sometimes the
\&\f(CW\*(C`perldoc\*(C'\fR and/or \f(CW\*(C`PAGER\*(C'\fR programs on the system have problems,
possibly resulting in control characters being literally output. This
@@ -369,23 +375,21 @@ Load the file \fIprofile\fR and do the installation with no user
interaction, that is, a batch (unattended) install.
.Sp
A \fIprofile\fR file contains all the values needed to perform an
-installation. From the text menu one can select 'P' to save the
-current setup as profile. Furthermore, after a normal installation
+installation. From the text menu one can select \f(CW\*(C`P\*(C'\fR to save the
+current setup as profile. In addition, after a normal installation
has finished, a profile for that exact installation is written to the file
-DEST/tlpkg/texlive.profile. That file can be given as the argument to
+\&\f(CW\*(C`tlpkg/texlive.profile\*(C'\fR. That file can be given as the argument to
\&\f(CW\*(C`\-profile\*(C'\fR to redo the exact same installation on a different system,
for example. Alternatively, you can use a custom profile, most easily
created by starting from a generated one and changing values, or an
empty file, which will take all the defaults.
.Sp
-Normally a profile has to specify the value \f(CW1\fR for each collection to
-be installed, even if the scheme is specified. This follows from the
-logic of the installer in that you can first select a scheme and then
-change the collections being installed. But for convenience there is an
-exception to this within profiles: If the profile contains a variable
-for \f(CW\*(C`selected_scheme\*(C'\fR and \fIno\fR collection variables at all are defined
-in the profile, then the collections which the specified scheme requires
-are installed.
+Within a profile file, if the variable \f(CW\*(C`selected_scheme\*(C'\fR is defined and
+\&\fIno\fR collection variables at all are defined, then the collections
+required by the specified scheme are installed, without explicitly
+listing them. This eases maintenance of profile files. If any
+collections are specified in a profile, though, then this does not
+apply, and all desired collections must be given explicitly.
.Sp
Thus, a line \f(CW\*(C`selected_scheme scheme\-medium\*(C'\fR together with the
definitions of the installation directories (\f(CW\*(C`TEXDIR\*(C'\fR, \f(CW\*(C`TEXMFHOME\*(C'\fR,
@@ -397,8 +401,8 @@ For more detailed explanations on the meaning of the options
consult the TeX Live installation manual. Values are either
\&\f(CW0\fR, \f(CW1\fR, or strings.
.RS 4
-.ie n .IP "\fBinstaller options\fR (those with prefix ""instopt_"")" 8
-.el .IP "\fBinstaller options\fR (those with prefix \f(CWinstopt_\fR)" 8
+.ie n .IP "\fBinstaller options\fR (those with prefix ""instopt_"")" 4
+.el .IP "\fBinstaller options\fR (those with prefix \f(CWinstopt_\fR)" 4
.IX Item "installer options (those with prefix instopt_)"
\&\f(CW\*(C`instopt_portable\*(C'\fR (default 0, see \f(CW\*(C`\-portable\*(C'\fR),
\&\f(CW\*(C`instopt_letter\*(C'\fR (default 0, selecting letter size instead of a4),
@@ -407,8 +411,8 @@ mirror after installation),
\&\f(CW\*(C`instopt_write18_restricted\*(C'\fR (default 1, enable write8 for a restricted
set of programs),
\&\f(CW\*(C`instopt_adjustpath\*(C'\fR (default 0 on Unix, 1 on Windows, adjust \s-1PATH\s0 environment).
-.ie n .IP "\fBtlpdb options\fR (those with prefix ""tlpdbopt_"")" 8
-.el .IP "\fBtlpdb options\fR (those with prefix \f(CWtlpdbopt_\fR)" 8
+.ie n .IP "\fBtlpdb options\fR (those with prefix ""tlpdbopt_"")" 4
+.el .IP "\fBtlpdb options\fR (those with prefix \f(CWtlpdbopt_\fR)" 4
.IX Item "tlpdb options (those with prefix tlpdbopt_)"
The definitive list is give in \f(CW\*(C`TeXLive::TLConfig.pm\*(C'\fR in
\&\f(CW%TeXLive::TLConfig::TLPDBOptions\fR, together with explanations.
@@ -420,12 +424,12 @@ The current list is given below:
\&\f(CW\*(C`tlpdbopt_install_srcfiles\*(C'\fR, \f(CW\*(C`tlpdbopt_post_code\*(C'\fR,
\&\f(CW\*(C`tlpdbopt_sys_bin\*(C'\fR, \f(CW\*(C`tlpdbopt_sys_info\*(C'\fR, \f(CW\*(C`tlpdbopt_sys_man\*(C'\fR,
\&\f(CW\*(C`tlpdbopt_w32_multi_user\*(C'\fR, \f(CW\*(C`tlpdbopt_generate_updmap\*(C'\fR
-.IP "\fBpath options\fR" 8
+.IP "\fBpath options\fR" 4
.IX Item "path options"
\&\f(CW\*(C`TEXDIR\*(C'\fR, \f(CW\*(C`TEXMFHOME\*(C'\fR, \f(CW\*(C`TEXMFCONFIG\*(C'\fR, \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR,
\&\f(CW\*(C`TEXMFVAR\*(C'\fR, \f(CW\*(C`TEXMFSYSVAR\*(C'\fR, \f(CW\*(C`TEXMFLOCAL\*(C'\fR
-.ie n .IP "\fBarchitecture selection options\fR (those starting with ""binary_"")" 8
-.el .IP "\fBarchitecture selection options\fR (those starting with \f(CWbinary_\fR)" 8
+.ie n .IP "\fBarchitecture selection options\fR (those starting with ""binary_"")" 4
+.el .IP "\fBarchitecture selection options\fR (those starting with \f(CWbinary_\fR)" 4
.IX Item "architecture selection options (those starting with binary_)"
For every supported architecture of TeX Live (directories under
\&\f(CW\*(C`bin/\*(C'\fR), the key \f(CW\*(C`binary_ARCH\*(C'\fR can be set.
@@ -518,3 +522,4 @@ Don't try to run the \f(CW\*(C`\-\-help\*(C'\fR message through \f(CW\*(C`perldo
This script and its documentation were written for the TeX Live
distribution (<http://tug.org/texlive>) and both are licensed under the
\&\s-1GNU\s0 General Public License Version 2 or later.
+\&\f(CW$Id\fR$