diff options
Diffstat (limited to 'Master/texmf/doc')
-rw-r--r-- | Master/texmf/doc/man/man1/tlmgr.1 | 91 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/tlmgr.man1.pdf | bin | 72599 -> 72973 bytes |
2 files changed, 46 insertions, 45 deletions
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1 index 910c4dbde74..394784f5394 100644 --- a/Master/texmf/doc/man/man1/tlmgr.1 +++ b/Master/texmf/doc/man/man1/tlmgr.1 @@ -152,8 +152,8 @@ files. Schemes typically contain a mix of collections and packages, but each package is included in exactly one collection, no more and no less. Installation can be customized and managed at any level. .PP -For the full documentation of TeX Live, see -<http://tug.org/texlive/doc>. +See <http://tug.org/texlive/doc> for all the TeX Live documentation +available. .SH "EXAMPLES" .IX Header "EXAMPLES" After successfully installing TeX Live, here are a few common operations @@ -162,7 +162,7 @@ with \f(CW\*(C`tlmgr\*(C'\fR: .el .IP "\f(CWtlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet\fR" 4 .IX Item "tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet" Tell \f(CW\*(C`tlmgr\*(C'\fR to use a nearby \s-1CTAN\s0 mirror for future updates; useful if -you want continuing updates, and installed TeX Live from the \s-1DVD\s0 image. +you installed TeX Live from the \s-1DVD\s0 image and want continuing updates. .ie n .IP """tlmgr update \-\-list""" 4 .el .IP "\f(CWtlmgr update \-\-list\fR" 4 .IX Item "tlmgr update --list" @@ -172,29 +172,30 @@ Report what would be updated without actually updating anything. .IX Item "tlmgr update --all" Make your local TeX installation correspond to what is in the package repository (typically useful when updating from \s-1CTAN\s0). -.ie n .IP """tlmgr show"" \fIpkg\fR" 4 -.el .IP "\f(CWtlmgr show\fR \fIpkg\fR" 4 -.IX Item "tlmgr show pkg" +.ie n .IP """tlmgr info"" \fIpkg\fR" 4 +.el .IP "\f(CWtlmgr info\fR \fIpkg\fR" 4 +.IX Item "tlmgr info pkg" Display detailed information about \fIpkg\fR, such as the installation status and description. .PP -For all the capabilities and details of \f(CW\*(C`tlmgr\*(C'\fR, please see the +For all the capabilities and details of \f(CW\*(C`tlmgr\*(C'\fR, please read the following voluminous information. .SH "OPTIONS" .IX Header "OPTIONS" The following options to \f(CW\*(C`tlmgr\*(C'\fR are global options, not specific to any action. All options, whether global or action-specific, can be -given at any place and in arbitrary order. The first non-option -argument will be the main action. In all cases, \f(CW\*(C`\-\-\*(C'\fR\fIoption\fR and -\&\f(CW\*(C`\-\*(C'\fR\fIoption\fR are equivalent, and an \f(CW\*(C`=\*(C'\fR is optional between an option -name and its value. +given anywhere on the command line, and in any order. The first +non-option argument will be the main action. In all cases, +\&\f(CW\*(C`\-\-\*(C'\fR\fIoption\fR and \f(CW\*(C`\-\*(C'\fR\fIoption\fR are equivalent, and an \f(CW\*(C`=\*(C'\fR is optional +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 (\s-1TLPDB\s0, a file named -\&\f(CW\*(C`texlive.tlpdb\*(C'\fR). The documentation for \f(CW\*(C`install\-tl\*(C'\fR has more details -about this (http://tug.org/texlive/doc/install\-tl.html <http://tug.org/texlive/doc/install-tl.html>). +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). The documentation for +\&\f(CW\*(C`install\-tl\*(C'\fR has more details about this +(http://tug.org/texlive/doc/install\-tl.html <http://tug.org/texlive/doc/install-tl.html>). .Sp \&\f(CW\*(C`\-\-repository\*(C'\fR changes the repository location only for the current run; to make a permanent change, use \f(CW\*(C`option repository\*(C'\fR (see the @@ -204,41 +205,42 @@ For backward compatibility and convenience, \f(CW\*(C`\-\-location\*(C'\fR and \ are accepted as aliases for this option. .IP "\fB\-\-gui\fR [\fIaction\fR]" 4 .IX Item "--gui [action]" -You can give this option together with an action to be brought directly -into the respective screen of the \s-1GUI\s0. For example, running +\&\f(CW\*(C`tlmgr\*(C'\fR has a graphical interface as well as the command-line +interface. You can give this option, \f(CW\*(C`\-\-gui\*(C'\fR, together with an action +to be brought directly into the respective screen of the \s-1GUI\s0. For +example, running .Sp .Vb 1 \& tlmgr \-\-gui update .Ve .Sp -starts you directly at the update screen. +starts you directly at the update screen. Without any action, the +\&\s-1GUI\s0 will be started at the main screen. .IP "\fB\-\-gui\-lang\fR \fIllcode\fR" 4 .IX Item "--gui-lang llcode" Normally the \s-1GUI\s0 tries to deduce your language from the environment (on Windows via the registry, on Unix via \f(CW\*(C`LC_MESSAGES\*(C'\fR). If that fails you -can select a different language by giving this option a two-letter -(\s-1ISO\s0 639\-1) language code (with the exception for selecting simplified -or traditional Chinese). Currently supported (but not necessarily -completely translated) are: -English (en, default), Czech (cs), German (de), French (fr), -Italian (it), Dutch (nl), Polish (pl), Russian (ru), Slovak (sk), -Slovenian (sl), Serbian (sr), Vietnamese (vi), simplified Chinese (zh-cn), -and traditional Chinese (zh-tw). +can select a different language by giving this option with a language +code (based on \s-1ISO\s0 639\-1). Currently supported (but not necessarily +completely translated) are: English (en, default), Czech (cs), German +(de), French (fr), Italian (it), Japanese (ja), Dutch (nl), Polish (pl), +Brazilian Portuguese (pt_br), Russian (ru), Slovak (sk), Slovenian (sl), +Serbian (sr), Vietnamese (vi), simplified Chinese (zh-cn), and +traditional Chinese (zh-tw). .IP "\fB\-\-machine\-readable\fR" 4 .IX Item "--machine-readable" -In lieu of the normal output intended for human consumption, write to -standard output in a fixed format more suitable for machine parsing. -See the \*(L"MACHINE-READABLE \s-1OUTPUT\s0\*(R" section below for details. +Instead of the normal output intended for human consumption, write (to +standard output) a fixed format more suitable for machine parsing. See +the \*(L"MACHINE-READABLE \s-1OUTPUT\s0\*(R" section below. .IP "\fB\-\-package\-logfile\fR \fIfile\fR" 4 .IX Item "--package-logfile file" -\&\fBtlmgr\fR logs all package actions (install, remove, update, failed +\&\f(CW\*(C`tlmgr\*(C'\fR logs all package actions (install, remove, update, failed updates, failed restores) to a separate log file, by default -\&\f(CW\*(C`TEXMFSYSVAR/web2c/tlmgr.log\*(C'\fR. This option allows you to select a -different file for that. This is separate from normal logging; for -that, see the option \f(CW\*(C`\-v\*(C'\fR below, and TeXLive::TLUtils. +\&\f(CW\*(C`TEXMFSYSVAR/web2c/tlmgr.log\*(C'\fR. This option allows you to specific a +different file for the log. .IP "\fB\-\-pause\fR" 4 .IX Item "--pause" -This option makes \fBtlmgr\fR wait for user input before exiting. Useful on +This option makes \f(CW\*(C`tlmgr\*(C'\fR wait for user input before exiting. Useful on Windows to avoid command windows disappearing. .IP "\fB\-\-persistent\-downloads\fR" 4 .IX Item "--persistent-downloads" @@ -246,20 +248,19 @@ Windows to avoid command windows disappearing. .IP "\fB\-\-no\-persistent\-downloads\fR" 4 .IX Item "--no-persistent-downloads" .PD -For net installs, activating this option makes tlmgr try to set up a -persistent connection using the Net::LWP Perl module. -This opens only one connection between your computer and the server -per session and reuses it, instead of initiating a new download for -each package. +For network-based installations, this option (on by default) makes +\&\f(CW\*(C`tlmgr\*(C'\fR try to set up a persistent connection (using the Net::LWP +Perl module). The idea is to open and reuse only one connection per +session between your computer and the server, instead of initiating a +new download for each package. .Sp -This option is turned on by default, and tlmgr will -fall back to using wget if this is not possible. If you want to disable -usage of \s-1LWP\s0 and persistent connections, please use -\&\fB\-\-no\-persistent\-downloads\fR. +If this is not possible, \f(CW\*(C`tlmgr\*(C'\fR will fall back to using \f(CW\*(C`wget\*(C'\fR. To +disable these persistent connections, use \f(CW\*(C`\-\-no\-persistent\-downloads\*(C'\fR. .IP "\fB\-\-no\-execute\-actions\fR" 4 .IX Item "--no-execute-actions" Suppress the execution of the execute actions as defined in the tlpsrc -files. Only use at your own risk. +files. Documented only for completeness, as this is only useful in +debugging. .IP "\fB\-\-debug\-translation\fR" 4 .IX Item "--debug-translation" In \s-1GUI\s0 mode, this switch makes \f(CW\*(C`tlmgr\*(C'\fR report any missing, or more @@ -272,8 +273,8 @@ The standard options for TeX Live programs are also accepted: the TeXLive::TLUtils documentation. .PP The \f(CW\*(C`\-\-version\*(C'\fR option shows version information about the TeX Live -release and about the \f(CW\*(C`tlmgr\*(C'\fR script itself. If paired with \f(CW\*(C`\-v\*(C'\fR, -revision number for the used TeX Live Perl modules are shown, too. +release and about the \f(CW\*(C`tlmgr\*(C'\fR script itself. If \f(CW\*(C`\-v\*(C'\fR is given as +well, revision number for the used TeX Live Perl modules are shown, too. .SH "ACTIONS" .IX Header "ACTIONS" .SS "help" diff --git a/Master/texmf/doc/man/man1/tlmgr.man1.pdf b/Master/texmf/doc/man/man1/tlmgr.man1.pdf Binary files differindex d6d5c64b053..995713bab1f 100644 --- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf +++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf |