summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-05-25 02:36:07 +0000
committerKarl Berry <karl@freefriends.org>2012-05-25 02:36:07 +0000
commit75c191ad55d9f7e8eab51a5d52ad7dcf3358db97 (patch)
tree4ad4aac69d7519e86fbaf5b9eb01079af99be9b9 /Master/texmf/doc/man/man1
parent5a0413d0e30767265d3b08b565fbe59486412724 (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@26650 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man/man1')
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.191
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.man1.pdfbin72599 -> 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
index d6d5c64b053..995713bab1f 100644
--- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
Binary files differ