From 93f5cb38cf8b22de87c9dd111a1981dd67ca4e4b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 31 May 2018 00:23:53 +0000 Subject: tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@47883 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/install-tl.1 | 76 +++++++++++++++++++++++++++-- 1 file changed, 71 insertions(+), 5 deletions(-) (limited to 'Master/texmf-dist/doc/man/man1/install-tl.1') 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 ; 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 . +.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 () 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 $ -- cgit v1.2.3