diff options
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/install-tl.1')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/install-tl.1 | 49 |
1 files changed, 46 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1 index 99de00e29c7..1f791b94881 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-01" "perl v5.26.2" "User Contributed Perl Documentation" +.TH INSTALL-TL 1 "2018-06-02" "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 @@ -226,7 +226,7 @@ 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 +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. .Sp The default is to pick a mirror automatically, using @@ -264,6 +264,48 @@ 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 @@ -546,7 +588,8 @@ user installations. .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., <http://tug.org/texlive/doc/tlmgr.html#xxx> +documentation, e.g., +<http://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" |