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

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

3 files changed, 41 insertions, 11 deletions

diff --git a/Master/texmf/doc/man/man1/asy.pdf b/Master/texmf/doc/man/man1/asy.pdf
index 2a9e3953ce2..3aa2a6d4681 100644
--- a/Master/texmf/doc/man/man1/asy.pdf
+++ b/Master/texmf/doc/man/man1/asy.pdf
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index c7b8e42f451..4cafecf108f 100644
--- a/Master/texmf/doc/man/man1/tlmgr.1
+++ b/Master/texmf/doc/man/man1/tlmgr.1
@@ -129,7 +129,7 @@
 .\" ========================================================================
 .\"
 .IX Title "TLMGR 1"
-.TH TLMGR 1 "2009-09-10" "perl v5.8.8" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2009-09-12" "perl v5.8.8" "User Contributed Perl Documentation"
 .SH "NAME"
 tlmgr \- the TeX Live Manager
 .SH "SYNOPSIS"
@@ -142,14 +142,39 @@ configuration options.
 .PP
 The most up-to-date version of this documentation is available at
 <http://tug.org/texlive/tlmgr.html>, along with procedures for updating
-\&\f(CW\*(C`tlmgr\*(C'\fR itself, disaster recovery when it's broken, and test versions.
+\&\f(CW\*(C`tlmgr\*(C'\fR itself and information about test versions.
+.SH "EXAMPLES"
+.IX Header "EXAMPLES"
+After successfully installing TeX Live, here are a few common operations
+with \f(CW\*(C`tlmgr\*(C'\fR:
+.ie n .IP """tlmgr update \-\-all""" 4
+.el .IP "\f(CWtlmgr update \-\-all\fR" 4
+.IX Item "tlmgr update --all"
+Make your local TeX installation correspond to what is the package
+repository (typically on \s-1CTAN\s0).
+.ie n .IP """tlmgr update \-\-list""" 4
+.el .IP "\f(CWtlmgr update \-\-list\fR" 4
+.IX Item "tlmgr update --list"
+Report what would be updated without actually updating anything.
+.ie n .IP """tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet""" 4
+.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 installed TeX Live from the \s-1DVD\s0 image.
+.ie n .IP """tlmgr show""\fR \fIpkgname" 4
+.el .IP "\f(CWtlmgr show\fR \fIpkgname\fR" 4
+.IX Item "tlmgr show pkgname"
+Display detailed information about \fIpkgname\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
+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. Although we present \f(CW\*(C`tlmgr\*(C'\fR invocation in the above order,
-all options 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
+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.
 .IP "\fB\-\-repository\fR \fIurl|path\fR" 4
@@ -160,6 +185,10 @@ 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>).
 .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
+option action).
+.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.
 .IP "\fB\-\-gui\fR [\fIaction\fR]" 4
@@ -192,12 +221,13 @@ 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.
 .IP "\fB\-\-pause\fR" 4
 .IX Item "--pause"
-This option make \fBtlmgr\fR wait for user input before exiting.  Useful on
+This option makes \fBtlmgr\fR wait for user input before exiting.  Useful on
 Windows to avoid command windows disappearing.
 .IP "\fB\-\-debug\-translation\fR" 4
 .IX Item "--debug-translation"
-This switch will make \f(CW\*(C`tlmgr\*(C'\fR report any missing or probably 
-untranslated messages in \s-1GUI\s0 mode to standard error.
+This switch makes \f(CW\*(C`tlmgr\*(C'\fR report, in \s-1GUI\s0 mode, any missing, or more
+likely untranslated, messages to standard error.  Helpful for
+translators to see what remains to be done.
 .PP
 The standard options for TeX Live programs are also accepted:
 \&\f(CW\*(C`\-\-help/\-h/\-?\*(C'\fR, \f(CW\*(C`\-\-version\*(C'\fR, \f(CW\*(C`\-q\*(C'\fR (no informational messages), \f(CW\*(C`\-v\*(C'\fR
@@ -649,7 +679,7 @@ Search the TeX Live Database of the installation medium, instead of the
 local installation.
 .Sh "show [\-\-list] \fIpkg\fP..."
 .IX Subsection "show [--list] pkg..."
-Shows information about \fIpkg\fR: the name, category, installation status,
+Display information about \fIpkg\fR: the name, category, installation status,
 short and long description.  Searches in the remote installation source
 for the package if it is not locally installed.
 .PP
diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf
index 0a4a7dcf4b7..f08035ee15b 100644
--- a/Master/texmf/doc/man/man1/tlmgr.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.pdf