summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/install-tl.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-10-10 23:43:26 +0000
committerKarl Berry <karl@freefriends.org>2023-10-10 23:43:26 +0000
commit5ec656d8c6bbc8c9df68368cc5d0c375d40d081f (patch)
treef326cb990d102b4bcd69d71e4106019c0d26e19d /Master/texmf-dist/doc/man/man1/install-tl.1
parentc5b9960966f8243ba449a63f523882046752fcad (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@68510 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.1250
1 files changed, 86 insertions, 164 deletions
diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1
index 9a30d983186..9e2343fa324 100644
--- a/Master/texmf-dist/doc/man/man1/install-tl.1
+++ b/Master/texmf-dist/doc/man/man1/install-tl.1
@@ -1,4 +1,5 @@
-.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -15,29 +16,12 @@
.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'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.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\}
@@ -68,87 +52,25 @@
. \}
.\}
.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 "2023-03-12" "perl v5.36.1" "User Contributed Perl Documentation"
+.TH INSTALL-TL 1 2023-08-07 "perl v5.38.0" "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"
+.SH NAME
install\-tl \- TeX Live cross\-platform installer
-.SH "SYNOPSIS"
+.SH SYNOPSIS
.IX Header "SYNOPSIS"
install-tl [\fIoption\fR]...
.PP
install\-tl\-windows.bat [\fIoption\fR]...
-.SH "DESCRIPTION"
+.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
+media, including over the network, from local hard disk, a DVD, 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>.
@@ -167,7 +89,7 @@ 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"
+.SH REFERENCES
.IX Header "REFERENCES"
Post-installation configuration, package updates, and more, are
handled through \fBtlmgr\fR(1), the TeX Live Manager
@@ -181,7 +103,7 @@ For step-by-step instructions, see
.PP
For the full documentation of TeX Live, see
<https://tug.org/texlive/doc>.
-.SH "EXAMPLES"
+.SH EXAMPLES
.IX Header "EXAMPLES"
With no options, \f(CW\*(C`install\-tl\*(C'\fR drops you into an interactive menu where
essentially all default settings can be changed. With options, you can
@@ -205,38 +127,38 @@ entering the interactive menu.
.ie n .IP """install\-tl \-\-profile"" \fItexlive.profile\fR" 4
.el .IP "\f(CWinstall\-tl \-\-profile\fR \fItexlive.profile\fR" 4
.IX Item "install-tl --profile texlive.profile"
-Install, without interaction, according to the given \s-1TL\s0 profile file;
-see \*(L"\s-1PROFILES\*(R"\s0 below. To initialize from the profile and then enter the
+Install, without interaction, according to the given TL profile file;
+see "PROFILES" below. To initialize from the profile and then enter the
interactive menu, add \f(CW\*(C`\-\-init\-from\-profile\*(C'\fR.
.PP
Full documentation follows.
-.SH "OPTIONS"
+.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.
.PP
The options relating to customization of the installation can also be
-selected in the interactive installation menus (\s-1GUI\s0 or text).
+selected in the interactive installation menus (GUI or text).
.IP "\fB\-gui\fR [[=]\fImodule\fR]" 4
.IX Item "-gui [[=]module]"
.PD 0
-.IP "\fB\-no\-gui\fR" 4
+.IP \fB\-no\-gui\fR 4
.IX Item "-no-gui"
.PD
-If no \fImodule\fR is given, starts the Tcl/Tk (see below) \s-1GUI\s0 installer.
+If no \fImodule\fR is given, starts the Tcl/Tk (see below) GUI 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
+.el .IP \f(CWtext\fR 4
.IX Item "text"
The text mode user interface (default on Unix systems, including Macs).
Same as the \f(CW\*(C`\-no\-gui\*(C'\fR option.
.ie n .IP """tcl"" (or ""perltk"" or ""wizard"" or ""expert"" or nothing)" 4
-.el .IP "\f(CWtcl\fR (or ``perltk'' or ``wizard'' or ``expert'' or nothing)" 4
-.IX Item "tcl (or perltk or wizard or expert or nothing)"
+.el .IP "\f(CWtcl\fR (or ""perltk"" or ""wizard"" or ""expert"" or nothing)" 4
+.IX Item "tcl (or ""perltk"" or ""wizard"" or ""expert"" or nothing)"
The Tcl/Tk user interface (default on Windows). It starts
with a small number of configuration options, roughly equivalent
to what the former wizard option offers, but a button \f(CW\*(C`Advanced\*(C'\fR
@@ -245,16 +167,16 @@ takes you to a screen with roughly the same options as the former
.RE
.RS 4
.Sp
-The default \s-1GUI\s0 requires Tcl/Tk. This was standard on Macs, but has been
+The default GUI requires Tcl/Tk. This was standard on Macs, but has been
removed in the latest macOS releases. It's often already installed on
GNU/Linux, or can be easily installed through a distro package manager.
For Windows, TeX Live provides a Tcl/Tk runtime.
.RE
.IP "\fB\-lang\fR \fIllcode\fR" 4
.IX Item "-lang llcode"
-By default, the Tcl \s-1GUI\s0 uses the language detection built into
+By default, the Tcl GUI uses the language detection built into
Tcl/Tk. If that fails you can select a different language by
-giving this option with a language code (based on \s-1ISO 639\-1\s0).
+giving this option with a language code (based on ISO 639\-1).
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
@@ -272,30 +194,30 @@ For installation, the default is to pick a mirror automatically, using
<https://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror is
then 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.)
+about CTAN 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
+.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
+list of active CTAN mirrors. This option is supported in the \f(CW\*(C`text\*(C'\fR
and \f(CW\*(C`gui\*(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
+.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"
+Giving this command line option allows configuring such "foreign"
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 (e.g., because
-precompiled binaries were not provided by \s-1TL\s0 for your platform), this
+precompiled binaries were not provided by TL for your platform), 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
@@ -307,18 +229,18 @@ rename \f(CW\*(C`custom\*(C'\fR before doing each.
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\-fakenet\fR" 4
+.IP \fB\-debug\-fakenet\fR 4
.IX Item "-debug-fakenet"
Pretend we're doing a network install. This is for the sole purpose of
testing the code to handle broken downloads, via moving package files
aside in a tlnet mirror hierarchy.
-.IP "\fB\-debug\-setup\-vars\fR" 4
+.IP \fB\-debug\-setup\-vars\fR 4
.IX Item "-debug-setup-vars"
Print final values of directory variables; for more debugging
information on how they were set, also specify \f(CW\*(C`\-v\*(C'\fR.
-.IP "\fB\-debug\-translation\fR" 4
+.IP \fB\-debug\-translation\fR 4
.IX Item "-debug-translation"
-In the former Perl/Tk \s-1GUI\s0 modes, this option reported any missing,
+In the former Perl/Tk GUI modes, this option reported any missing,
or more likely untranslated, messages to standard error. Not yet
implemented for the Tcl interface. Helpful for translators to see
what remains to be done.
@@ -336,7 +258,7 @@ and/or \f(CW\*(C`PAGER\*(C'\fR programs on the system have problems, possibly re
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
+.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
@@ -344,10 +266,10 @@ 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
+installer interfaces. USE AT YOUR OWN RISK.
.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
+Similar to \fB\-profile\fR (see "PROFILES" 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
@@ -357,13 +279,13 @@ 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
+for example, \f(CW\*(C`/usr/local/texlive/YYYY/install\-tl.log\*(C'\fR for the \fIYYYY\fR
release.
-.IP "\fB\-no\-cls\fR" 4
+.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.
-.IP "\fB\-no\-continue\fR" 4
+.IP \fB\-no\-continue\fR 4
.IX Item "-no-continue"
Quit early on installation failure of a non-core package.
.Sp
@@ -375,10 +297,10 @@ If the retry also fails, by default the installer proceeds to completion
anyway, with the idea that it was a transient network problem and
reinstallation will succeed later. If this option is specified, and the
retry fails, the installer aborts.
-.IP "\fB\-no\-doc\-install\fR" 4
+.IP \fB\-no\-doc\-install\fR 4
.IX Item "-no-doc-install"
.PD 0
-.IP "\fB\-no\-src\-install\fR" 4
+.IP \fB\-no\-src\-install\fR 4
.IX Item "-no-src-install"
.PD
Do not install the documentation resp. source package files, both for
@@ -401,19 +323,19 @@ been installed without them, you can get them like this (using the
The source files mentioned here are those relating to TeX packages, such
as \f(CW\*(C`.dtx\*(C'\fR files. The sources that are compiled to make the binaries are
available separately: see <https://tug.org/texlive/svn/>.
-.IP "\fB\-no\-installation\fR" 4
+.IP \fB\-no\-installation\fR 4
.IX Item "-no-installation"
Do not perform any installation. This is for debugging the
initialization and setup routines without touching the disk.
-.IP "\fB\-no\-interaction\fR" 4
+.IP \fB\-no\-interaction\fR 4
.IX Item "-no-interaction"
Do not enter the interactive menu; immediately perform the installation
after initialization and option parsing. Also omit the check for a
previous installation and asking about importing previous settings.
-.IP "\fB\-no\-persistent\-downloads\fR" 4
+.IP \fB\-no\-persistent\-downloads\fR 4
.IX Item "-no-persistent-downloads"
.PD 0
-.IP "\fB\-persistent\-downloads\fR" 4
+.IP \fB\-persistent\-downloads\fR 4
.IX Item "-persistent-downloads"
.PD
For network installs, activating this option makes the installer try to
@@ -424,15 +346,15 @@ 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
+LWP 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
+By default, if a GnuPG \f(CW\*(C`gpg\*(C'\fR binary is found in PATH, 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
+.IP \fB\-non\-admin\fR 4
.IX Item "-non-admin"
For Windows only: configure for the current user, not for all users.
.ie n .IP "\fB\-paper\fR ""a4""\fB|\fR""letter""" 4
@@ -441,11 +363,11 @@ For Windows only: configure for the current user, not for all users.
Set the default paper size for all TeX Live programs, as specified.
The default is \f(CW\*(C`a4\*(C'\fR. The paper size can be set after installation with
the \f(CW\*(C`tlmgr paper\*(C'\fR command.
-.IP "\fB\-portable\fR" 4
+.IP \fB\-portable\fR 4
.IX Item "-portable"
-Install for portable use, e.g., on a \s-1USB\s0 stick. See the
+Install for portable use, e.g., on a USB stick. See the
\&\f(CW\*(C`instopt_portable\*(C'\fR description below for details.
-.IP "\fB\-print\-platform\fR" 4
+.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.
@@ -454,8 +376,8 @@ Print the TeX Live identifier for the detected platform
.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
+ignored. See "PROFILES" below.
+.IP \fB\-q\fR 4
.IX Item "-q"
Omit normal informational messages.
.IP "\fB\-scheme\fR \fIscheme\fR" 4
@@ -469,13 +391,13 @@ menu list.
.IP "\fB\-texdir\fR \fIdir\fR" 4
.IX Item "-texdir dir"
Specify the system installation directory; the default is
-\&\f(CW\*(C`/usr/local/texlive/YYYY\*(C'\fR for release \s-1YYYY.\s0 Specifying this option also
+\&\f(CW\*(C`/usr/local/texlive/YYYY\*(C'\fR for release YYYY. Specifying this option also
causes the \f(CW\*(C`TEXMFLOCAL\*(C'\fR, \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR, and \f(CW\*(C`TEXMFSYSVAR\*(C'\fR
directories to be set as subdirectories of \fIdir\fR, so they don't have to
be set individually.
.Sp
-There is a brief summary of these directories trees at \*(L"\s-1DIRECTORY
-TREES\*(R"\s0 below; for details on the trees set up by default, and their
+There is a brief summary of these directories trees at "DIRECTORY
+TREES" below; for details on the trees set up by default, and their
intended usage, see the main TeX Live documentation at
<https://tug.org/texlive/doc>.
.IP "\fB\-texuserdir\fR \fIdir\fR" 4
@@ -493,8 +415,8 @@ across releases, which is usually desirable. Specifying the \f(CW\*(C`\-texdir\*
option changes this, putting \f(CW\*(C`TEXMFLOCAL\*(C'\fR under the main tree. The
\&\f(CW\*(C`\-texmflocal\*(C'\fR option can be used to specify an explicit directory.
.Sp
-Anything installed here must follow the TeX directory structure (\s-1TDS\s0),
-e.g., \f(CW\*(C`TEXMFHOME/tex/latex/mypkg/mypkg.sty\*(C'\fR. \s-1TDS\s0 reference:
+Anything installed here must follow the TeX directory structure (TDS),
+e.g., \f(CW\*(C`TEXMFHOME/tex/latex/mypkg/mypkg.sty\*(C'\fR. TDS reference:
<https://tug.org/tds>.
.IP "\fB\-texmfhome\fR \fIdir\fR" 4
.IX Item "-texmfhome dir"
@@ -502,7 +424,7 @@ Specify the \f(CW\*(C`TEXMFHOME\*(C'\fR directory; the default is \f(CW\*(C`~/te
Macs, where it is \f(CW\*(C`~/Library/texmf\*(C'\fR. Analogously to \f(CW\*(C`TEXMFLOCAL\*(C'\fR, the
\&\f(CW\*(C`\-texuserdir\*(C'\fR option changes this default.
.Sp
-Also as with \f(CW\*(C`TEXMFLOCAL\*(C'\fR, anything installed here must follow the \s-1TDS.\s0
+Also as with \f(CW\*(C`TEXMFLOCAL\*(C'\fR, anything installed here must follow the TDS.
.IP "\fB\-texmfsysconfig\fR \fIdir\fR" 4
.IX Item "-texmfsysconfig dir"
.PD 0
@@ -519,7 +441,7 @@ Specify the \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR and \f(CW\*(C`TEXMFSYSVAR\*(C'\fR s
Specify the \f(CW\*(C`TEXMFCONFIG\*(C'\fR and \f(CW\*(C`TEXMFVAR\*(C'\fR user directories.
The defaults are \f(CW\*(C`~/.texliveYYYY/texmf\-{config,var}\*(C'\fR, except on Macs,
where the leading dot is omitted (\f(CW\*(C`~/texliveYYYY/...\*(C'\fR).
-.IP "\fB\-v\fR" 4
+.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.)
@@ -527,7 +449,7 @@ Include verbose debugging messages; repeat for maximum debugging: \f(CW\*(C`\-v
.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"
+.SH PROFILES
.IX Header "PROFILES"
A \fIprofile\fR file normally contains all the values needed to perform an
installation. After a normal installation has finished, a profile for
@@ -569,7 +491,7 @@ For example, a line
.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
+under "path options") suffices to install the "small" 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
@@ -610,7 +532,7 @@ 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;
+Set remote repository to a multiplexed CTAN 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
@@ -619,7 +541,7 @@ 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, without touching the
+Install for portable use, e.g., on a USB stick, without touching the
host system. Specifically, this forces the user directories
\&\f(CW\*(C`TEXMFHOME\*(C'\fR, \f(CW\*(C`TEXMFCONFIG\*(C'\fR, \f(CW\*(C`TEXMFVAR\*(C'\fR to be identical to the system
directories \f(CW\*(C`TEXMFLOCAL\*(C'\fR, \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR, \f(CW\*(C`TEXMFSYSVAR\*(C'\fR,
@@ -658,7 +580,7 @@ Here is the current list:
\&\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:
+variable \f(CW\*(C`binary_\*(C'\fR\fIPLATFORM\fR can be set with value 1. For example:
.PP
.Vb 1
\& binary_x86_64\-linux 1
@@ -680,35 +602,35 @@ 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 """NOPERLDOC""" 4
-.el .IP "\f(CWNOPERLDOC\fR" 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.
.ie n .IP """TEXLIVE_DOWNLOADER""" 4
-.el .IP "\f(CWTEXLIVE_DOWNLOADER\fR" 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
+.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
+.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
+.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
+.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_DISKCHECK""" 4
-.el .IP "\f(CWTEXLIVE_INSTALL_NO_DISKCHECK\fR" 4
+.el .IP \f(CWTEXLIVE_INSTALL_NO_DISKCHECK\fR 4
.IX Item "TEXLIVE_INSTALL_NO_DISKCHECK"
If set to 1, omit free disk space check. By default, if a
POSIX-compliant \f(CW\*(C`df\*(C'\fR program (supporting \f(CW\*(C`\-Pk\*(C'\fR) is available, the
@@ -717,41 +639,41 @@ location, and will abort installation if there is insufficient disk
space, plus a margin of 100MB. An equivalent check is made on Windows
(not involving \f(CW\*(C`df\*(C'\fR).
.ie n .IP """TEXLIVE_INSTALL_NO_RESUME""" 4
-.el .IP "\f(CWTEXLIVE_INSTALL_NO_RESUME\fR" 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
+.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
+.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
+.el .IP \f(CWTEXLIVE_INSTALL_PREFIX\fR 4
.IX Item "TEXLIVE_INSTALL_PREFIX"
.PD 0
.ie n .IP """TEXLIVE_INSTALL_TEXMFCONFIG""" 4
-.el .IP "\f(CWTEXLIVE_INSTALL_TEXMFCONFIG\fR" 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
+.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
+.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
+.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
+.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
+.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
@@ -792,7 +714,7 @@ environment variable \f(CW\*(C`TEXLIVE_INSTALL_\*(C'\fR\fItree\fR which override
default; command line and profile settings both override environment
variable settings.
.PP
-The defaults vary slightly on Macs, as explained above in \*(L"\s-1OPTIONS\*(R"\s0.
+The defaults vary slightly on Macs, as explained above in "OPTIONS".
.PP
For the user trees, the default value uses \f(CW\*(C`~\*(C'\fR, and this is left as a
literal \f(CW\*(C`~\*(C'\fR in \f(CW\*(C`texmf.cnf\*(C'\fR. That way, each user can have their own
@@ -804,7 +726,7 @@ system directories.
.PP
For more on the directory trees and their intended usage, see the main
TeX Live documentation at <https://tug.org/texlive/doc>.
-.SH "BUGS"
+.SH BUGS
.IX Header "BUGS"
The \f(CW\*(C`install\-tl\*(C'\fR script copies itself into the installed tree.
Usually, it can be run from there, using the installed tree as the
@@ -822,6 +744,6 @@ installed packages in an existing installed tree. Use \f(CW\*(C`tlmgr\*(C'\fR in
.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.
+GNU General Public License Version 2 or later.
.PP
-\&\f(CW$Id:\fR install-tl 66578 2023\-03\-12 17:33:10Z karl $
+\&\f(CW$Id:\fR install-tl 67839 2023\-08\-07 21:47:31Z preining $