path: root/Master/texmf-dist/doc/man/man1/install-tl.1

.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "INSTALL-TL 1"
.TH INSTALL-TL 1 "2020-05-13" "perl v5.30.2" "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
.nh
.SH "NAME"
install\-tl \- TeX Live cross\-platform installer
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
install-tl [\fIoption\fR]...
.PP
install\-tl\-windows.bat [\fIoption\fR]...
.PP
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, from local hard disk, a \s-1DVD,\s0 etc. The
installer works on all platforms supported by TeX Live. For information
on initially downloading TeX Live, see
<https://tug.org/texlive/acquire.html>.
.PP
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.
.PP
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 work
at the package level, use \f(CW\*(C`tlmgr\*(C'\fR (reference just below) after the
initial installation is complete.
.PP
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 more, are
handled through \fBtlmgr\fR(1), the TeX Live Manager
(<https://tug.org/texlive/tlmgr.html>).
.PP
The most up-to-date version of this installer documentation is on the
Internet at <https://tug.org/texlive/doc/install\-tl.html>.
.PP
For the full documentation of TeX Live, see
<https://tug.org/texlive/doc>.
.SH "OPTIONS"
.IX Header "OPTIONS"
As usual, all options can be specified in any order, and with either a
leading \f(CW\*(C`\-\*(C'\fR or \f(CW\*(C`\-\-\*(C'\fR.  An argument value can be separated from its
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 Tcl/Tk (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""" 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 """tcl""" 4
.el .IP "\f(CWtcl\fR" 4
.IX Item "tcl"
The Tcl/Tk user interface (default on Macs and Windows).  It starts
with a small number of configuration options, roughly equivalent
to what the wizard option below offers, but a button \f(CW\*(C`Advanced\*(C'\fR
takes you to a screen with roughly the same options as the \f(CW\*(C`perltk\*(C'\fR
interface.
.ie n .IP """wizard""" 4
.el .IP "\f(CWwizard\fR" 4
.IX Item "wizard"
The wizard mode user interface, asking only minimal questions before
installing all of TeX Live.
.ie n .IP """expert""" 4
.el .IP "\f(CWexpert\fR" 4
.IX Item "expert"
A generic name for, currently, \f(CW\*(C`perltk\*(C'\fR; it may select a different \s-1GUI\s0
in the future.
.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.
.RE
.RS 4
.Sp
The \f(CW\*(C`perltk\*(C'\fR and \f(CW\*(C`wizard\*(C'\fR modules require the Perl/Tk module
(<https://tug.org/texlive/distro.html#perltk>). if Perl/Tk is not
available, installation continues in text mode, except on Windows,
where all gui options except \f(CW\*(C`text\*(C'\fR are diverted to the default
\&\f(CW\*(C`tcl\*(C'\fR \s-1GUI.\s0
.Sp
The \f(CW\*(C`tcl\*(C'\fR \s-1GUI\s0 requires Tcl/Tk. This is standard on Macs and is often
already installed on GNU/Linux. For Windows, TeX Live provides a Tcl/Tk
runtime.
.RE
.IP "\fB\-no\-gui\fR" 4
.IX Item "-no-gui"
Use the text mode installer (default except on Windows and Macs).
.IP "\fB\-lang\fR \fIllcode\fR" 4
.IX Item "-lang llcode"
By default, the \s-1GUI\s0 tries to deduce your language from the
environment. The Tcl \s-1GUI\s0 uses the language detection built into
Tcl/Tk; the Perl/Tk GUIs use the \f(CW\*(C`LC_MESSAGES\*(C'\fR environment
variable. If that fails you can select a different language by
giving this option with a language code (based on \s-1ISO 639\-1\s0).
Currently supported (but not necessarily completely translated) are:
English (en, default), Czech (cs), German (de), French (fr), Italian
(it), Japanese (ja), Dutch (nl), Polish (pl), Brazilian Portuguese
(pt_BR), Russian (ru), Slovak (sk), Slovenian (sl), Serbian (sr),
Ukrainian (uk), Vietnamese (vi), simplified Chinese (zh_CN), and
traditional Chinese (zh_TW).
.IP "\fB\-repository\fR \fIurl|path\fR" 4
.IX Item "-repository url|path"
Specify the package repository to be used as the source of the
installation. In short, this can be a directory name or a url using
http(s), ftp, or scp. The documentation for \f(CW\*(C`tlmgr\*(C'\fR has the details
(<https://tug.org/texlive/doc/tlmgr.html#OPTIONS>).
.Sp
For installation, the default is to pick a mirror automatically, using
<http://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror is
used for the entire download. You can use the special argument \f(CW\*(C`ctan\*(C'\fR
as an abbreviation for this. (See <https://ctan.org> for more about \s-1CTAN\s0
and its mirrors.)
.Sp
After installation is complete, you can use that installation as the
repository for another installation.  If you chose to install less than
the full scheme containing all packages, the list of available schemes
will be adjusted accordingly.
.IP "\fB\-select\-repository\fR" 4
.IX Item "-select-repository"
This option allows you to choose a particular mirror from the current
list of active \s-1CTAN\s0 mirrors. This option is supported in the \f(CW\*(C`text\*(C'\fR,
\&\f(CW\*(C`wizard\*(C'\fR and \f(CW\*(C`perltk\*(C'\fR installer modes, and will also offer to install
from local media if available, or from a repository specified on the
command line. It's useful when the (default) automatic redirection does
not 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
(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
your platform was not supported by TeX Live out of the box), this option
allows you to specify the \fIpath\fR to a directory where the binaries for
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.  To install multiple custom binary sets, manually rename
\&\f(CW\*(C`custom\*(C'\fR before doing each.
.Sp
For more information on custom binaries, see
<https://tug.org/texlive/custom\-bin.html>.  For general information on
building TeX Live, see <https://tug.org/texlive/build.html>.
.IP "\fB\-debug\-translation\fR" 4
.IX Item "-debug-translation"
In the Perl/Tk \s-1GUI\s0 modes, this option reports any missing, or more
likely untranslated, messages to standard error. Helpful for
translators to see what remains to be done.
.IP "\fB\-force\-platform\fR \fIplatform\fR" 4
.IX Item "-force-platform platform"
Instead of auto-detecting the current platform, use \fIplatform\fR.
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. (This help is also on the web at
<https://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 can't always be
detected, but you can set the \f(CW\*(C`NOPERLDOC\*(C'\fR environment variable and
\&\f(CW\*(C`perldoc\*(C'\fR will not be used.
.IP "\fB\-in\-place\fR" 4
.IX Item "-in-place"
This is a quick-and-dirty installation option in case you already have
an rsync or svn checkout of TeX Live.  It will use the checkout as-is
and will just do the necessary post-install.  Be warned that the file
\&\f(CW\*(C`tlpkg/texlive.tlpdb\*(C'\fR may be rewritten, that removal has to be done
manually, and that the only realistic way to maintain this installation
is to redo it from time to time.  This option is not available via the
installer interfaces.  \s-1USE AT YOUR OWN RISK.\s0
.IP "\fB\-init\-from\-profile\fR \fIprofile_file\fR" 4
.IX Item "-init-from-profile profile_file"
Similar to \fB\-profile\fR (see \*(L"\s-1PROFILES\*(R"\s0 below), but only initializes
the installation configuration from \fIprofile_file\fR and then starts a
normal interactive session. Environment variables are not ignored.
.IP "\fB\-logfile\fR \fIfile\fR" 4
.IX Item "-logfile file"
Write both all messages (informational, debugging, warnings) to \fIfile\fR,
in addition to standard output or standard error.
.Sp
If this option is not given, the installer will create a log file
in the root of the writable installation tree,
for example, \f(CW\*(C`/usr/local/texlive/YYYY/install\-tl.log\*(C'\fR for the \fI\s-1YYYY\s0\fR
release.
.IP "\fB\-no\-cls\fR" 4
.IX Item "-no-cls"
For the text mode installer only: do not clear the screen when entering
a new menu (for debugging purposes).
.IP "\fB\-no\-persistent\-downloads\fR" 4
.IX Item "-no-persistent-downloads"
.PD 0
.IP "\fB\-persistent\-downloads\fR" 4
.IX Item "-persistent-downloads"
.PD
For network installs, activating this option makes the installer try to
set up a persistent connection using the \f(CW\*(C`Net::LWP\*(C'\fR Perl module.  This
opens only one connection between your computer and the server per
session and reuses it, instead of initiating a new download for each
package, which typically yields a significant speed-up.
.Sp
This option is turned on by default, and the installation program will
fall back to using \f(CW\*(C`wget\*(C'\fR if this is not possible.  To disable usage of
\&\s-1LWP\s0 and persistent connections, use \f(CW\*(C`\-no\-persistent\-downloads\*(C'\fR.
.IP "\fB\-no\-verify\-downloads\fR" 4
.IX Item "-no-verify-downloads"
By default, if a GnuPG \f(CW\*(C`gpg\*(C'\fR binary is found in \s-1PATH,\s0 downloads are
verified against a cryptographic signature. This option disables such
verification.  The full description is in the Crytographic Verification
section of the \f(CW\*(C`tlmgr\*(C'\fR documentation, e.g.,
<https://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC\-VERIFICATION>
.IP "\fB\-non\-admin\fR" 4
.IX Item "-non-admin"
For Windows only: configure for the current user, not for all users.
.IP "\fB\-portable\fR" 4
.IX Item "-portable"
Install for portable use, e.g., on a \s-1USB\s0 stick.  Also selectable from
within the perltk and text installers.
.IP "\fB\-print\-platform\fR" 4
.IX Item "-print-platform"
Print the TeX Live identifier for the detected platform
(hardware/operating system) combination to standard output, and exit.
\&\f(CW\*(C`\-print\-arch\*(C'\fR is a synonym.
.IP "\fB\-profile\fR \fIprofile_file\fR" 4
.IX Item "-profile profile_file"
Load \fIprofile_file\fR and do the installation with no user interaction,
that is, a batch (unattended) install.  Environment variables are
ignored. See \*(L"\s-1PROFILES\*(R"\s0 below.
.IP "\fB\-q\fR" 4
.IX Item "-q"
Omit normal informational messages.
.IP "\fB\-scheme\fR \fIscheme\fR" 4
.IX Item "-scheme scheme"
Schemes are the highest level of package grouping in TeX Live; the
default is to use the \f(CW\*(C`full\*(C'\fR scheme, which includes everything.  This
option overrides that default.  You can change the scheme again before
the actual installation with the usual menu.  The \fIscheme\fR argument may
optionally have a prefix \f(CW\*(C`scheme\-\*(C'\fR.  The list of supported scheme names
depends on what your package repository provides; see the interactive
menu list.
.IP "\fB\-v\fR" 4
.IX Item "-v"
Include verbose debugging messages; repeat for maximum debugging: \f(CW\*(C`\-v
\&\-v\*(C'\fR.  (Further repeats are accepted but ignored.)
.IP "\fB\-version\fR, \fB\-\-version\fR" 4
.IX Item "-version, --version"
Output version information and exit.  If \f(CW\*(C`\-v\*(C'\fR is also given, the
versions of the TeX Live modules used are also reported.
.SH "PROFILES"
.IX Header "PROFILES"
A \fIprofile\fR file contains all the values needed to perform an
installation.  After a normal installation has finished, a profile for
that exact installation is written to the file \f(CW\*(C`tlpkg/texlive.profile\*(C'\fR.
In addition, from the text menu one can select \f(CW\*(C`P\*(C'\fR to save the current
setup as a profile at any time.
.PP
Such a profile file can be given as the argument to \f(CW\*(C`\-profile\*(C'\fR, for
example to redo the exact same installation on a different system.
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.
.PP
As mentioned above, the installer only supports selection by scheme and
collections, not individual packages, so packages cannot be specified in
profile files either. Use \f(CW\*(C`tlmgr\*(C'\fR to work at the package level.
.PP
Within a profile file, each line consists of
.PP
\&\fIvariable\fR [\fIvalue\fR]
.PP
except for comment lines starting with \f(CW\*(C`#\*(C'\fR.  The possible variable
names are listed below.  Values, when present, are either \f(CW0\fR or \f(CW1\fR
for booleans, or strings (which must be specified without any quote
characters).  Leading whitespace is ignored.
.PP
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 (which might change over time) are installed, without
explicitly listing them.  This eases maintenance of profile files.  If
any collections are specified in a profile, though, then all desired
collections must be given explicitly.
.PP
For example, a line
.PP
.Vb 1
\&  selected_scheme scheme\-small
.Ve
.PP
along with definitions for the installation directories (given below
under \*(L"path options\*(R") suffices to install the \*(L"small\*(R" scheme with all
default options.  The schemes are described in the \f(CW\*(C`S\*(C'\fR menu in the
text installer, or equivalent.
.PP
Besides \f(CW\*(C`selected_scheme\*(C'\fR, here is the list of variable names supported
in a profile:
.PP
\&\fBcollection options\fR (prefix \f(CW\*(C`collection\-\*(C'\fR)
.PP
Collections are specified with a variable name with the prefix
\&\f(CW\*(C`collection\-\*(C'\fR followed by a collection name; there is no value.  For
instance, \f(CW\*(C`collection\-basic\*(C'\fR.  The collections are described in the
\&\f(CW\*(C`C\*(C'\fR menu.
.PP
Schemes and collections (and packages) are ultimately defined by the
files in the \f(CW\*(C`tlpkg/tlpsrc/\*(C'\fR source directory.
.PP
\&\fBpath options\fR
.PP
It is best to define all of these, even though they may not be used in
the installation, so as to avoid unintentionally getting a default value
that could cause problems later.
.PP
.Vb 7
\&  TEXDIR
\&  TEXMFCONFIG
\&  TEXMFVAR
\&  TEXMFHOME
\&  TEXMFLOCAL
\&  TEXMFSYSCONFIG
\&  TEXMFSYSVAR
.Ve
.PP
\&\fBinstaller options\fR (prefix \f(CW\*(C`instopt_\*(C'\fR)
.ie n .IP """instopt_adjustpath"" (default 0 on Unix, 1 on Windows)" 4
.el .IP "\f(CWinstopt_adjustpath\fR (default 0 on Unix, 1 on Windows)" 4
.IX Item "instopt_adjustpath (default 0 on Unix, 1 on Windows)"
Adjust \f(CW\*(C`PATH\*(C'\fR environment variable.
.ie n .IP """instopt_adjustrepo"" (default 1)" 4
.el .IP "\f(CWinstopt_adjustrepo\fR (default 1)" 4
.IX Item "instopt_adjustrepo (default 1)"
Set remote repository to a multiplexed \s-1CTAN\s0 mirror after installation;
see \f(CW\*(C`\-repository\*(C'\fR above.
.ie n .IP """instopt_letter"" (default 0)" 4
.el .IP "\f(CWinstopt_letter\fR (default 0)" 4
.IX Item "instopt_letter (default 0)"
Set letter size paper as the default, instead of a4.
.ie n .IP """instopt_portable"" (default 0)" 4
.el .IP "\f(CWinstopt_portable\fR (default 0)" 4
.IX Item "instopt_portable (default 0)"
Install for portable use, e.g., on a \s-1USB\s0 stick.
.ie n .IP """instopt_write18_restricted"" (default 1)" 4
.el .IP "\f(CWinstopt_write18_restricted\fR (default 1)" 4
.IX Item "instopt_write18_restricted (default 1)"
Enable \f(CW\*(C`\ewrite18\*(C'\fR for a restricted set of programs.
.PP
\&\fBtlpdb options\fR (prefix \f(CW\*(C`tlpdbopt_\*(C'\fR)
.PP
The definitive list is given in \f(CW\*(C`tlpkg/TeXLive/TLConfig.pm\*(C'\fR, in the hash
\&\f(CW%TeXLive::TLConfig::TLPDBOptions\fR, together with explanations.  All
items given there \fIexcept\fR for \f(CW\*(C`tlpdbopt_location\*(C'\fR can be specified.
Here is the current list:
.PP
.Vb 10
\&  tlpdbopt_autobackup
\&  tlpdbopt_backupdir
\&  tlpdbopt_create_formats
\&  tlpdbopt_desktop_integration
\&  tlpdbopt_file_assocs
\&  tlpdbopt_generate_updmap
\&  tlpdbopt_install_docfiles
\&  tlpdbopt_install_srcfiles
\&  tlpdbopt_post_code
\&  tlpdbopt_sys_bin
\&  tlpdbopt_sys_info
\&  tlpdbopt_sys_man
\&  tlpdbopt_w32_multi_user
.Ve
.PP
\&\fBplatform options\fR (prefix \f(CW\*(C`binary_\*(C'\fR)
.PP
For each supported platform in TeX Live (directories under \f(CW\*(C`bin/\*(C'\fR), the
variable \f(CW\*(C`binary_\*(C'\fR\fI\s-1PLATFORM\s0\fR can be set with value 1.  For example:
.PP
.Vb 1
\&  binary_x86_64\-linux 1
.Ve
.PP
If no \f(CW\*(C`binary_\*(C'\fR settings are made, the default is whatever the
current machine is running.
.PP
In releases before 2017, many profile variables had different
names (not documented here; see the \f(CW\*(C`install\-tl\*(C'\fR source).  They are
accepted and transformed to the names given above.  When a profile is
written, the names above are always used.
.PP
For more details on all of the above options, consult the TeX Live
installation manual, linked from <https://tug.org/texlive/doc>.
.SH "ENVIRONMENT VARIABLES"
.IX Header "ENVIRONMENT VARIABLES"
For ease in scripting and debugging, \f(CW\*(C`install\-tl\*(C'\fR looks for the
following environment variables. They are not of interest for normal
user installations.
.ie n .IP """TEXLIVE_DOWNLOADER""" 4
.el .IP "\f(CWTEXLIVE_DOWNLOADER\fR" 4
.IX Item "TEXLIVE_DOWNLOADER"
.PD 0
.ie n .IP """TL_DOWNLOAD_PROGRAM""" 4
.el .IP "\f(CWTL_DOWNLOAD_PROGRAM\fR" 4
.IX Item "TL_DOWNLOAD_PROGRAM"
.ie n .IP """TL_DOWNLOAD_ARGS""" 4
.el .IP "\f(CWTL_DOWNLOAD_ARGS\fR" 4
.IX Item "TL_DOWNLOAD_ARGS"
.PD
These override the normal choice of a download program; see the \f(CW\*(C`tlmgr\*(C'\fR
documentation, e.g.,
<https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT\-VARIABLES>.
.ie n .IP """TEXLIVE_INSTALL_ENV_NOCHECK""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_ENV_NOCHECK\fR" 4
.IX Item "TEXLIVE_INSTALL_ENV_NOCHECK"
Omit the check for environment variables containing the string \f(CW\*(C`tex\*(C'\fR.
People developing TeX-related software are likely to have many such
variables.
.ie n .IP """TEXLIVE_INSTALL_NO_CONTEXT_CACHE""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_NO_CONTEXT_CACHE\fR" 4
.IX Item "TEXLIVE_INSTALL_NO_CONTEXT_CACHE"
Omit creating the ConTeXt cache.  This is useful for redistributors.
.ie n .IP """TEXLIVE_INSTALL_NO_RESUME""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_NO_RESUME\fR" 4
.IX Item "TEXLIVE_INSTALL_NO_RESUME"
Omit check for installing on top of a previous installation and then
asking about importing previous settings.
.ie n .IP """TEXLIVE_INSTALL_NO_WELCOME""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_NO_WELCOME\fR" 4
.IX Item "TEXLIVE_INSTALL_NO_WELCOME"
Omit printing the welcome message after successful installation, e.g.,
when testing.
.ie n .IP """TEXLIVE_INSTALL_PAPER""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_PAPER\fR" 4
.IX Item "TEXLIVE_INSTALL_PAPER"
Set the default paper size for all relevant programs; must be either
\&\f(CW\*(C`letter\*(C'\fR or \f(CW\*(C`a4\*(C'\fR. The default is \f(CW\*(C`a4\*(C'\fR.
.ie n .IP """TEXLIVE_INSTALL_PREFIX""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_PREFIX\fR" 4
.IX Item "TEXLIVE_INSTALL_PREFIX"
.PD 0
.ie n .IP """TEXLIVE_INSTALL_TEXDIR""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_TEXDIR\fR" 4
.IX Item "TEXLIVE_INSTALL_TEXDIR"
.ie n .IP """TEXLIVE_INSTALL_TEXMFCONFIG""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_TEXMFCONFIG\fR" 4
.IX Item "TEXLIVE_INSTALL_TEXMFCONFIG"
.ie n .IP """TEXLIVE_INSTALL_TEXMFVAR""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_TEXMFVAR\fR" 4
.IX Item "TEXLIVE_INSTALL_TEXMFVAR"
.ie n .IP """TEXLIVE_INSTALL_TEXMFHOME""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_TEXMFHOME\fR" 4
.IX Item "TEXLIVE_INSTALL_TEXMFHOME"
.ie n .IP """TEXLIVE_INSTALL_TEXMFLOCAL""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_TEXMFLOCAL\fR" 4
.IX Item "TEXLIVE_INSTALL_TEXMFLOCAL"
.ie n .IP """TEXLIVE_INSTALL_TEXMFSYSCONFIG""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_TEXMFSYSCONFIG\fR" 4
.IX Item "TEXLIVE_INSTALL_TEXMFSYSCONFIG"
.ie n .IP """TEXLIVE_INSTALL_TEXMFSYSVAR""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_TEXMFSYSVAR\fR" 4
.IX Item "TEXLIVE_INSTALL_TEXMFSYSVAR"
.PD
Specify the respective directories.  \f(CW\*(C`TEXLIVE_INSTALL_PREFIX\*(C'\fR defaults
to \f(CW\*(C`/usr/local/texlive\*(C'\fR, while \f(CW\*(C`TEXLIVE_INSTALL_TEXDIR\*(C'\fR defaults to
the release directory within that prefix, e.g.,
\&\f(CW\*(C`/usr/local/texlive/2016\*(C'\fR.  All the defaults can be seen by running the
installer interactively and then typing \f(CW\*(C`D\*(C'\fR for the directory menu.
.ie n .IP """NOPERLDOC""" 4
.el .IP "\f(CWNOPERLDOC\fR" 4
.IX Item "NOPERLDOC"
Don't try to run the \f(CW\*(C`\-\-help\*(C'\fR message through \f(CW\*(C`perldoc\*(C'\fR.
.SH "AUTHORS AND COPYRIGHT"
.IX Header "AUTHORS AND COPYRIGHT"
This script and its documentation were written for the TeX Live
distribution (<https://tug.org/texlive>) and both are licensed under the
\&\s-1GNU\s0 General Public License Version 2 or later.
.PP
\&\f(CW$Id:\fR install-tl 55126 2020\-05\-13 17:27:10Z karl $