diff options
author | Karl Berry <karl@freefriends.org> | 2018-05-31 00:23:53 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-05-31 00:23:53 +0000 |
commit | 93f5cb38cf8b22de87c9dd111a1981dd67ca4e4b (patch) | |
tree | 0e40533f8dab26b15314e7739961227717cab770 /Master/texmf-dist/doc/man/man1/tlmgr.1 | |
parent | 57dda8169eebf7677b95a1505791f20daaa18b81 (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/tlmgr.1')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.1 | 101 |
1 files changed, 99 insertions, 2 deletions
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1 index 90a526efb5b..6c4fe099cf9 100644 --- a/Master/texmf-dist/doc/man/man1/tlmgr.1 +++ b/Master/texmf-dist/doc/man/man1/tlmgr.1 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "TLMGR 1" -.TH TLMGR 1 "2018-05-28" "perl v5.26.2" "User Contributed Perl Documentation" +.TH TLMGR 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 @@ -217,6 +217,8 @@ run; to make a permanent change, use \f(CW\*(C`option repository\*(C'\fR (see th .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 +See \*(L"\s-1SUPPORTED URL SCHEMATA\*(R"\s0 for details on the supported schemata. .IP "\fB\-\-gui\fR [\fIaction\fR]" 4 .IX Item "--gui [action]" \&\f(CW\*(C`tlmgr\*(C'\fR has a graphical interface as well as the command line @@ -2087,10 +2089,105 @@ If a value is not saved in the database the string \f(CW\*(C`(not set)\*(C'\fR i .PP If you are developing a program that uses this output, and find that changes would be helpful, do not hesitate to write the mailing list. +.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_COMPRESSOR""" 4 +.el .IP "\f(CWTEXLIVE_COMPRESSOR\fR" 4 +.IX Item "TEXLIVE_COMPRESSOR" +This option allows selecting a different compressor program for +backups and intermediate rollback containers. The order of selection is: +.RS 4 +.IP "1." 8 +If the environment variable \f(CW\*(C`TEXLIVE_COMPRESSOR\*(C'\fR is +defined, use it; abort if it doesn't work. Possible values: +\&\f(CW\*(C`lz4\*(C'\fR, \f(CW\*(C`gzip\*(C'\fR, \f(CW\*(C`xz\*(C'\fR. +.IP "2." 8 +If lz4 is available (either from the system or \s-1TL\s0) and working, use that. +.IP "3." 8 +If gzip is available (from the system) and working, use that. +.IP "4." 8 +If xz is available (either from the system or \s-1TL\s0) and working, use that. +.RE +.RS 4 +.Sp +lz4 and gzip are much faster in creating tlmgr's local backups. +The unconditional use of xz for the tlnet containers is unaffected, +to minimize download sizes. +.RE +.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 .SH "AUTHORS AND COPYRIGHT" .IX Header "AUTHORS AND COPYRIGHT" 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 tlmgr.pl 47855 2018\-05\-28 00:31:12Z preining $ +\&\f(CW$Id:\fR tlmgr.pl 47874 2018\-05\-30 01:33:07Z preining $ |