summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/install-tl.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-05-31 00:23:53 +0000
committerKarl Berry <karl@freefriends.org>2018-05-31 00:23:53 +0000
commit93f5cb38cf8b22de87c9dd111a1981dd67ca4e4b (patch)
tree0e40533f8dab26b15314e7739961227717cab770 /Master/texmf-dist/doc/man/man1/install-tl.1
parent57dda8169eebf7677b95a1505791f20daaa18b81 (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@47883 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.176
1 files changed, 71 insertions, 5 deletions
diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1
index d061a018e30..0ef02027840 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-07-29" "perl v5.26.1" "User Contributed Perl Documentation"
+.TH INSTALL-TL 1 "2018-05-30" "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
@@ -227,9 +227,8 @@ 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, \f(CW\*(C`https://\*(C'\fR, or
-\&\f(CW\*(C`ftp://\*(C'\fR url. (No other protocols are supported, and \f(CW\*(C`https://\*(C'\fR may
-not work on all platforms.)
+\&\f(CW\*(C`file:/\*(C'\fR url, or a network location. See \*(L"\s-1SUPPORTED URL SCHEMATA\*(R"\s0
+for details.
.Sp
The default is to pick a mirror automatically, using
<http://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror is
@@ -531,11 +530,78 @@ 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 <http://tug.org/texlive/doc>.
+.SH "SUPPORTED URL SCHEMATA"
+.IX Header "SUPPORTED URL SCHEMATA"
+The following \s-1URL\s0 schemata are supported
+.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 schema, is supported without any restrictions. If the (default)
+\&\s-1LWP\s0 method is used, this schema supports persistent connections.
+.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, this schema supports persistent connections.
+.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"
+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 this schema. Furthermore, even if
+\&\f(CW\*(C`wget\*(C'\fR supports https, it might check the certificate. \f(CW\*(C`curl\*(C'\fR generally
+supports https.
+.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 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.
.SH "ENVIRONMENT VARIABLES"
.IX Header "ENVIRONMENT VARIABLES"
For ease in scripting and debugging, \f(CW\*(C`install\-tl\*(C'\fR will look 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 options allow selecting different download programs then the ones
+automatically selected by the installer. The order of selection is:
+.RS 4
+.IP "1." 8
+If the environment variable \f(CW\*(C`TEXLIVE_DOWNLOADER\*(C'\fR is
+defined, use it; abort if the specified program doesn't work.
+Possible values: \f(CW\*(C`curl\*(C'\fR, \f(CW\*(C`wget\*(C'\fR.
+.IP "2." 8
+If the environment variable \f(CW\*(C`TL_DOWNLOAD_PROGRAM\*(C'\fR is
+defined (can be any value), use it together with
+\&\f(CW\*(C`TL_DOWNLOAD_ARGS\*(C'\fR; abort if it doesn't work.
+.IP "3." 8
+If \s-1LWP\s0 is available and working, use that (by far the most
+efficient method, as it supports persistent downloads).
+.IP "4." 8
+If curl is available (from the system) and working, use that.
+.IP "5." 8
+If wget is available (either from the system or \s-1TL\s0) and working, use that.
+.RE
+.RS 4
+.Sp
+\&\s-1TL\s0 still provides \f(CW\*(C`wget\*(C'\fR binaries for some platforms, so
+some download method should always be available.
+.RE
.ie n .IP """TEXLIVE_INSTALL_ENV_NOCHECK""" 4
.el .IP "\f(CWTEXLIVE_INSTALL_ENV_NOCHECK\fR" 4
.IX Item "TEXLIVE_INSTALL_ENV_NOCHECK"
@@ -592,4 +658,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 44918 2017\-07\-29 23:39:45Z preining $
+\&\f(CW$Id:\fR install-tl 47874 2018\-05\-30 01:33:07Z preining $