diff options
Diffstat (limited to 'Master/texmf-dist/doc/man')
| -rw-r--r-- | Master/texmf-dist/doc/man/man1/install-tl.1 | 132 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/man/man1/install-tl.man1.pdf | bin | 52091 -> 49954 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.1 | 113 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf | bin | 136483 -> 139692 bytes |
4 files changed, 131 insertions, 114 deletions
diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1 index 1f791b94881..0350e8e949f 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-02" "perl v5.26.2" "User Contributed Perl Documentation" +.TH INSTALL-TL 1 "2018-06-03" "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 @@ -146,9 +146,9 @@ install\-tl\-advanced.bat [\fIoption\fR]... .SH "DESCRIPTION" .IX Header "DESCRIPTION" This installer creates a runnable TeX Live installation from various -media, including over the network, from local hard disk, a \s-1DVD,\s0 etc. -The installer works across all platforms supported by TeX Live. For -information on initially downloading the TeX Live, see +media, including over the network, from local hard disk, a \s-1DVD,\s0 etc. The +installer works on all platforms supported by TeX Live. For information +on initially downloading TeX Live, see <http://tug.org/texlive/acquire.html>. .PP The basic idea of TeX Live installation is for you to choose one of the @@ -165,7 +165,7 @@ The default is \f(CW\*(C`scheme\-full\*(C'\fR, which installs everything, and th highly recommended. .SH "REFERENCES" .IX Header "REFERENCES" -Post-installation configuration, package updates, and much more, are +Post-installation configuration, package updates, and more, are handled through \fBtlmgr\fR(1), the TeX Live Manager (<http://tug.org/texlive/tlmgr.html>). .PP @@ -226,94 +226,28 @@ 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 -\&\f(CW\*(C`file:/\*(C'\fR url, or a network location. +installation. In short, this can be a directory name or a url using +http(s), ftp, or scp. The documentation for \f(CW\*(C`tlmgr\*(C'\fR has the details +(<http://tug.org/texlive/doc/install\-tl.html#OPTIONS>). .Sp -The default is to pick a mirror automatically, using +For installation, the default is to pick a mirror automatically, using <http://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror is -used for the entire download. You can use the special argument \f(CW\*(C`ctan\*(C'\fR -as an abbreviation for this. See <http://ctan.org> for more about \s-1CTAN\s0 -and its mirrors. -.Sp -If the repository is on the network, trailing \f(CW\*(C`/\*(C'\fR characters and/or -trailing \f(CW\*(C`/tlpkg\*(C'\fR and/or \f(CW\*(C`/archive\*(C'\fR components are ignored. For example, -you could choose a particular \s-1CTAN\s0 mirror with something like this: -.Sp -.Vb 1 -\& \-repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet -.Ve -.Sp -Of course a real hostname and its particular top-level \s-1CTAN\s0 directory -have to be specified. The list of \s-1CTAN\s0 mirrors is available at -<http://ctan.org/mirrors>. -.Sp -If the repository is local, the installation type (compressed or live) is -automatically determined, by checking for the presence of a -\&\f(CW\*(C`archive\*(C'\fR directory relative to the root. Compressed is -preferred if both are available, since it is faster. Here's an example -of using a local directory: -.Sp -.Vb 1 -\& \-repository /local/TL/repository -.Ve +used for the entire download. You can use the special argument \f(CW\*(C`ctan\*(C'\fR +as an abbreviation for this. (See <http://ctan.org> for more about \s-1CTAN\s0 +and its mirrors.) .Sp After installation is complete, you can use that installation as the repository for another installation. If you chose to install less than the full scheme containing all packages, the list of available schemes 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 -active \s-1CTAN\s0 mirrors. This option is supported in all installer modes -(text, wizard, perltk), and will also offer to install from local media -if available, or from a repository specified on the command line (see -above). It's useful when the (default) automatic redirection does not -choose a good host for you. +This option allows you to choose a particular mirror from the current +list of active \s-1CTAN\s0 mirrors. This option is supported in all installer +modes (text, wizard, perltk), and will also offer to install from local +media if available, or from a repository specified on the command line. +It's useful when the (default) automatic redirection does not choose a +good host for you. .IP "\fB\-all\-options\fR" 4 .IX Item "-all-options" Normally options not relevant to the current platform are not shown @@ -347,12 +281,12 @@ Binaries for this platform must be present and they must actually be runnable, or installation will fail. \f(CW\*(C`\-force\-arch\*(C'\fR is a synonym. .IP "\fB\-help\fR, \fB\-\-help\fR, \fB\-?\fR" 4 .IX Item "-help, --help, -?" -Display this help and exit. (This help is on the web at -<http://tug.org/texlive/doc/install\-tl.html>). Sometimes the -\&\f(CW\*(C`perldoc\*(C'\fR and/or \f(CW\*(C`PAGER\*(C'\fR programs on the system have problems, -possibly resulting in control characters being literally output. This -can't always be detected, but you can set the \f(CW\*(C`NOPERLDOC\*(C'\fR environment -variable and \f(CW\*(C`perldoc\*(C'\fR will not be used. +Display this help and exit. (This help is also on the web at +<http://tug.org/texlive/doc/install\-tl.html>). Sometimes the \f(CW\*(C`perldoc\*(C'\fR +and/or \f(CW\*(C`PAGER\*(C'\fR programs on the system have problems, possibly resulting +in control characters being literally output. This can't always be +detected, but you can set the \f(CW\*(C`NOPERLDOC\*(C'\fR environment variable and +\&\f(CW\*(C`perldoc\*(C'\fR will not be used. .IP "\fB\-in\-place\fR" 4 .IX Item "-in-place" This is a quick-and-dirty installation option in case you already have @@ -380,14 +314,11 @@ release. .IX Item "-no-cls" For the text mode installer only: do not clear the screen when entering a new menu (for debugging purposes). -.IP "\fB\-non\-admin\fR" 4 -.IX Item "-non-admin" -For Windows only: configure for the current user, not for all users. -.IP "\fB\-persistent\-downloads\fR" 4 -.IX Item "-persistent-downloads" -.PD 0 .IP "\fB\-no\-persistent\-downloads\fR" 4 .IX Item "-no-persistent-downloads" +.PD 0 +.IP "\fB\-persistent\-downloads\fR" 4 +.IX Item "-persistent-downloads" .PD For network installs, activating this option makes the installer try to set up a persistent connection using the \f(CW\*(C`Net::LWP\*(C'\fR Perl module. This @@ -405,6 +336,9 @@ verified against a cryptographic signature. This option disables such verification. The full description is in the Crytographic Verification section of the \f(CW\*(C`tlmgr\*(C'\fR documentation, e.g., <http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC\-VERIFICATION> +.IP "\fB\-non\-admin\fR" 4 +.IX Item "-non-admin" +For Windows only: configure for the current user, not for all users. .IP "\fB\-portable\fR" 4 .IX Item "-portable" Install for portable use, e.g., on a \s-1USB\s0 stick. Also selectable from @@ -436,8 +370,8 @@ Include verbose debugging messages; repeat for maximum debugging: \f(CW\*(C`\-v \&\-v\*(C'\fR. (Further repeats are accepted but ignored.) .IP "\fB\-version\fR, \fB\-\-version\fR" 4 .IX Item "-version, --version" -Output version information and exit. If \f(CW\*(C`\-v\*(C'\fR has also been given the -revisions of the used modules are reported, too. +Output version information and exit. If \f(CW\*(C`\-v\*(C'\fR is also given, the +versions of the TeX Live modules used are also reported. .SH "PROFILES" .IX Header "PROFILES" A \fIprofile\fR file contains all the values needed to perform an @@ -646,4 +580,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 47874 2018\-05\-30 01:33:07Z preining $ +\&\f(CW$Id:\fR install-tl 47907 2018\-06\-03 18:09:29Z karl $ diff --git a/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf b/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf Binary files differindex 77509798b09..db8a78aa0f2 100644 --- a/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1 index e5a92defdc0..dfac10e4ed1 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-06-02" "perl v5.26.2" "User Contributed Perl Documentation" +.TH TLMGR 1 "2018-06-03" "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 @@ -204,22 +204,102 @@ non-option argument will be the main action. In all cases, between an option name and its value. .IP "\fB\-\-repository\fR \fIurl|path\fR" 4 .IX Item "--repository url|path" -Specifies the package repository from which packages should be installed -or updated, overriding the default package repository found in the -installation's TeX Live Package Database (a.k.a. the \s-1TLPDB,\s0 defined -entirely in the file \f(CW\*(C`tlpkg/texlive.tlpdb\*(C'\fR). +Specify the package repository from which packages should be installed +or updated, either a local directory or network location, as below. This +overridesthe default package repository found in the installation's TeX +Live Package Database (a.k.a. the \s-1TLPDB,\s0 which is given entirely in the +file \f(CW\*(C`tlpkg/texlive.tlpdb\*(C'\fR). .Sp -The documentation for \f(CW\*(C`install\-tl\*(C'\fR has more details about this -(<http://tug.org/texlive/doc/install\-tl.html#OPTIONS>). In short, you can -specify a directory name, http(s) or ftp url, or -\&\f(CW\*(C`scp://user@machine/path/to/tlnet\*(C'\fR. -.Sp -\&\f(CW\*(C`\-\-repository\*(C'\fR changes the repository location only for the current +This \f(CW\*(C`\-\-repository\*(C'\fR option changes the location only for the current run; to make a permanent change, use \f(CW\*(C`option repository\*(C'\fR (see the \&\*(L"option\*(R" action). .Sp +As an example, you can choose a particular \s-1CTAN\s0 mirror with something +like this: +.Sp +.Vb 1 +\& \-repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet +.Ve +.Sp +Of course a real hostname and its particular top-level \s-1CTAN\s0 directory +have to be specified. The list of \s-1CTAN\s0 mirrors is available at +<http://ctan.org/mirrors>. +.Sp +Here's an example of using a local directory: +.Sp +.Vb 1 +\& \-repository /local/TL/repository +.Ve +.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 +Locations can be specified as any of the following: +.RS 4 +.ie n .IP """/some/local/dir""" 4 +.el .IP "\f(CW/some/local/dir\fR" 4 +.IX Item "/some/local/dir" +.PD 0 +.ie n .IP """file:/some/local/dir""" 4 +.el .IP "\f(CWfile:/some/local/dir\fR" 4 +.IX Item "file:/some/local/dir" +.PD +Equivalent ways of specifying a local directory. +.ie n .IP """ctan""" 4 +.el .IP "\f(CWctan\fR" 4 +.IX Item "ctan" +.PD 0 +.ie n .IP """http://mirror.ctan.org/systems/texlive/tlnet""" 4 +.el .IP "\f(CWhttp://mirror.ctan.org/systems/texlive/tlnet\fR" 4 +.IX Item "http://mirror.ctan.org/systems/texlive/tlnet" +.PD +Pick a \s-1CTAN\s0 mirror automatically, trying for one that is both nearby and +up-to-date. The chosen mirror is used for the entire download. The bare +\&\f(CW\*(C`ctan\*(C'\fR is merely an alias for the full url. (See <http://ctan.org> for +more about \s-1CTAN\s0 and its mirrors.) +.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 """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 supports persistent +connections. Unfortunately, some versions of \f(CW\*(C`wget\*(C'\fR and \f(CW\*(C`curl\*(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. The simplest workaround for this problem is to use +http or ftp. +.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 """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 forms are equivalent; they all use \f(CW\*(C`scp\*(C'\fR to transfer files. Using +\&\f(CW\*(C`ssh\-agent\*(C'\fR is recommended. (Info: +<https://en.wikipedia.org/wiki/OpenSSH>, +<https://en.wikipedia.org/wiki/Ssh\-agent>.) +.RE +.RS 4 +.Sp +If the repository is on the network, trailing \f(CW\*(C`/\*(C'\fR characters and/or +trailing \f(CW\*(C`/tlpkg\*(C'\fR and/or \f(CW\*(C`/archive\*(C'\fR components are ignored. +.RE .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 @@ -2092,9 +2172,12 @@ 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 "ENVIRONMENT VARIABLES" .IX Header "ENVIRONMENT VARIABLES" -For ease in scripting and debugging, \f(CW\*(C`tlmgr\*(C'\fR looks for the following -environment variables. They are not of interest for normal user -installations. +\&\f(CW\*(C`tlmgr\*(C'\fR uses many of the standard TeX environment variables, as +reported by, e.g., \f(CW\*(C`tlmgr conf\*(C'\fR (\*(L"conf\*(R"). +.PP +In addition, for ease in scripting and debugging, \f(CW\*(C`tlmgr\*(C'\fR looks for the +following environment variables. These 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" @@ -2160,4 +2243,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 tlmgr.pl 47874 2018\-05\-30 01:33:07Z preining $ +\&\f(CW$Id:\fR tlmgr.pl 47907 2018\-06\-03 18:09:29Z karl $ diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf Binary files differindex d3564c35a0d..ae81c3076c0 100644 --- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf |