/home/texlive/karl/Master/tlpkg/bin/tl-update-auto

git-svn-id: svn://tug.org/texlive/trunk@26650 c570f23f-e606-0410-a88d-b1316a301751

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