summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/install-tl.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-06-03 00:23:59 +0000
committerKarl Berry <karl@freefriends.org>2018-06-03 00:23:59 +0000
commited62f6c3f3ff564e386dce340a538a14db5e22e9 (patch)
treed1f8b23dca94ba435e727da0388999dada5b9ee1 /Master/texmf-dist/doc/man/man1/install-tl.1
parentc69b28bd44cae0549ca3e6dd29a10785637521a9 (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@47906 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.149
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"