summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/install-tl.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-06-04 00:24:32 +0000
committerKarl Berry <karl@freefriends.org>2018-06-04 00:24:32 +0000
commitc360bfe1d63a4579a3001f35a88c806cf1396712 (patch)
treeb7e451b2b4515a2b6d6cd5f8197fe0f5882aa0f6 /Master/texmf-dist/doc/man/man1/install-tl.1
parent9cd74fcef5e466f36a1e8dc37aeca5265a468f86 (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@47920 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.1132
1 files changed, 33 insertions, 99 deletions
diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1
index 1f791b94881..0350e8e949f 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 "2018-06-02" "perl v5.26.2" "User Contributed Perl Documentation"
+.TH INSTALL-TL 1 "2018-06-03" "perl v5.26.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
@@ -146,9 +146,9 @@ 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 across all platforms supported by TeX Live. For
-information on initially downloading the TeX Live, see
+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
<http://tug.org/texlive/acquire.html>.
.PP
The basic idea of TeX Live installation is for you to choose one of the
@@ -165,7 +165,7 @@ The default is \f(CW\*(C`scheme\-full\*(C'\fR, which installs everything, and th
highly recommended.
.SH "REFERENCES"
.IX Header "REFERENCES"
-Post-installation configuration, package updates, and much more, are
+Post-installation configuration, package updates, and more, are
handled through \fBtlmgr\fR(1), the TeX Live Manager
(<http://tug.org/texlive/tlmgr.html>).
.PP
@@ -226,94 +226,28 @@ 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: 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.
+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
+(<http://tug.org/texlive/doc/install\-tl.html#OPTIONS>).
.Sp
-The default is to pick a mirror automatically, using
+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 <http://ctan.org> for more about \s-1CTAN\s0
-and its mirrors.
-.Sp
-If the repository is on the network, trailing \f(CW\*(C`/\*(C'\fR characters and/or
-trailing \f(CW\*(C`/tlpkg\*(C'\fR and/or \f(CW\*(C`/archive\*(C'\fR components are ignored. For example,
-you could choose a particular \s-1CTAN\s0 mirror with something like this:
-.Sp
-.Vb 1
-\& \-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 directory
-have to be specified. The list of \s-1CTAN\s0 mirrors is available at
-<http://ctan.org/mirrors>.
-.Sp
-If the repository is local, the installation type (compressed or live) is
-automatically determined, by checking for the presence of a
-\&\f(CW\*(C`archive\*(C'\fR directory relative to the root. Compressed is
-preferred if both are available, since it is faster. Here's an example
-of using a local directory:
-.Sp
-.Vb 1
-\& \-repository /local/TL/repository
-.Ve
+used for the entire download. You can use the special argument \f(CW\*(C`ctan\*(C'\fR
+as an abbreviation for this. (See <http://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.
-.Sp
-For backward compatibility and convenience, \f(CW\*(C`\-\-location\*(C'\fR and \f(CW\*(C`\-\-repo\*(C'\fR
-are accepted as aliases for this option.
-.Sp
-Network locations can be specified as any of the following:
-.RS 4
-.ie n .IP """http://server/path/to/tlnet""" 4
-.el .IP "\f(CWhttp://server/path/to/tlnet\fR" 4
-.IX Item "http://server/path/to/tlnet"
-Standard \s-1HTTP.\s0 If the (default) \s-1LWP\s0 method is used, persistent
-connections are supported. \s-1TL\s0 can also use \f(CW\*(C`curl\*(C'\fR or \f(CW\*(C`wget\*(C'\fR to do the
-downloads, or an arbitrary user-specified program, as described in the
-\&\f(CW\*(C`tlmgr\*(C'\fR documentation
-(<http://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT\-VARIABLES).>
-.ie n .IP """ftp://server/path/to/tlnet""" 4
-.el .IP "\f(CWftp://server/path/to/tlnet\fR" 4
-.IX Item "ftp://server/path/to/tlnet"
-If the (default) \s-1LWP\s0 method is used, persistent connections are
-supported.
-.ie n .IP """https://server/path/to/tlnet""" 4
-.el .IP "\f(CWhttps://server/path/to/tlnet\fR" 4
-.IX Item "https://server/path/to/tlnet"
-Again, if the (default) \s-1LWP\s0 method is used, this schema supports
-persistent connections. Some versions of \f(CW\*(C`wget\*(C'\fR do not support https,
-and even when \f(CW\*(C`wget\*(C'\fR supports https, certificates may be rejected even
-when the certificate is fine, due to a lack of local certificate roots.
-Ditto for \f(CW\*(C`curl\*(C'\fR.
-.ie n .IP """user@machine:/path/to/tlnet""" 4
-.el .IP "\f(CWuser@machine:/path/to/tlnet\fR" 4
-.IX Item "user@machine:/path/to/tlnet"
-.PD 0
-.ie n .IP """scp://user@machine/path/to/tlnet""" 4
-.el .IP "\f(CWscp://user@machine/path/to/tlnet\fR" 4
-.IX Item "scp://user@machine/path/to/tlnet"
-.ie n .IP """ssh://user@machine/path/to/tlnet""" 4
-.el .IP "\f(CWssh://user@machine/path/to/tlnet\fR" 4
-.IX Item "ssh://user@machine/path/to/tlnet"
-.PD
-These url-like schemata use \f(CW\*(C`scp\*(C'\fR to transfer files. The use of an
-\&\f(CW\*(C`ssh\-agent\*(C'\fR is highly recommended. (Info:
-<https://en.wikipedia.org/wiki/OpenSSH>,
-<https://en.wikipedia.org/wiki/Ssh\-agent>.)
-.RE
-.RS 4
-.RE
.IP "\fB\-select\-repository\fR" 4
.IX Item "-select-repository"
-This option allows manual selection of a mirror from the current list of
-active \s-1CTAN\s0 mirrors. This option is supported in all installer modes
-(text, wizard, perltk), and will also offer to install from local media
-if available, or from a repository specified on the command line (see
-above). It's useful when the (default) automatic redirection does not
-choose a good host for you.
+This option allows you to choose a particular mirror from the current
+list of active \s-1CTAN\s0 mirrors. This option is supported in all installer
+modes (text, wizard, perltk), 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
@@ -347,12 +281,12 @@ 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 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
-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.
+Display this help and exit. (This help is also 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 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
@@ -380,14 +314,11 @@ release.
.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\-non\-admin\fR" 4
-.IX Item "-non-admin"
-For Windows only: configure for the current user, not for all users.
-.IP "\fB\-persistent\-downloads\fR" 4
-.IX Item "-persistent-downloads"
-.PD 0
.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
@@ -405,6 +336,9 @@ 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.,
<http://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
@@ -436,8 +370,8 @@ 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 has also been given the
-revisions of the used modules are reported, too.
+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
@@ -646,4 +580,4 @@ 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.
.PP
-\&\f(CW$Id:\fR install-tl 47874 2018\-05\-30 01:33:07Z preining $
+\&\f(CW$Id:\fR install-tl 47907 2018\-06\-03 18:09:29Z karl $