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

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

2 files changed, 37 insertions, 29 deletions

diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index c56b389576f..5501feaa3eb 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-03" "perl v5.8.8" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2009-09-05" "perl v5.8.8" "User Contributed Perl Documentation"
 .SH "NAME"
 tlmgr \- the TeX Live Manager
 .SH "SYNOPSIS"
@@ -292,43 +292,47 @@ If you want to exclude some packages from being updated (e.g., due to a slow
 link), see the \f(CW\*(C`\-\-exclude\*(C'\fR option below.
 .IP "\fB\-\-self\fR" 4
 .IX Item "--self"
-Update \f(CW\*(C`tlmgr\*(C'\fR itself (that is, the infrastructure packages) if updates to
-it are present. On Windows this includes updates to the private Perl
+Update \f(CW\*(C`tlmgr\*(C'\fR itself (that is, the infrastructure packages) if updates
+to it are present. On Windows this includes updates to the private Perl
 interpreter shipped inside TeX Live.
 .Sp
-If this option is given together with \f(CW\*(C`\-\-all\*(C'\fR or a list of packages
-then \f(CW\*(C`tlmgr\*(C'\fR will be updated first and, if this update the new version
-will be restarted to complete the rest of the updates.
+If this option is given together with either \f(CW\*(C`\-\-all\*(C'\fR or a list of
+packages, then \f(CW\*(C`tlmgr\*(C'\fR will be updated first and, if this update
+succeeds, the new version will be restarted to complete the rest of the
+updates.
 .Sp
-In brief:
+In short:
 .Sp
 .Vb 3
 \&  tlmgr update --self        # update infrastructure only
 \&  tlmgr update --self --all  # update infrastructure and all packages
 \&  tlmgr update --force --all # update all packages but *not* infrastructure
 .Ve
-.IP "\fB\-\-list\fR" 4
-.IX Item "--list"
+.IP "\fB\-\-list\fR [\fIpkg\fR]" 4
+.IX Item "--list [pkg]"
 Concisely list the packages which would be updated, newly installed, or
 removed, without actually changing anything. If no package is given
 acts like \f(CW\*(C`\-\-list \-\-all\*(C'\fR, otherwise lists only updates to the packages
 given as arguments (and its dependencies).
-.IP "\fB\-\-exclude \f(BIpkg\fB\fR" 4
+.IP "\fB\-\-exclude\fR \fIpkg\fR" 4
 .IX Item "--exclude pkg"
-Exclude \fIpkg\fR from the update process. This option can be given
-multiple times. Giving a string \f(CW\*(C`pkg\*(C'\fR here will exclude the package
-\&\f(CW\*(C`pkg\*(C'\fR itself and all packages \f(CW\*(C`pkg.something\*(C'\fR. As an example giving
+Exclude \fIpkg\fR from the update process.  If this option is given more
+than once, its arguments accumulate.
+.Sp
+An argument \fIpkg\fR excludes both the package \fIpkg\fR itself and all
+its related architecture-specific packages \fIpkg.ARCH\fR.  For example,
 .Sp
 .Vb 1
 \&  tlmgr update --all --exclude a2ping
 .Ve
 .Sp
-will not update \f(CW\*(C`a2ping\*(C'\fR itself, nor \f(CW\*(C`a2ping.i386\-linux\*(C'\fR or
-any other arch-package \f(CW\*(C`a2ping.ARCH\*(C'\fR.
+will not update \f(CW\*(C`a2ping\*(C'\fR, \f(CW\*(C`a2ping.i386\-linux\*(C'\fR, or
+any other \f(CW\*(C`a2ping.\*(C'\fR\fI\s-1ARCH\s0\fRpackage.
 .Sp
-Note that if a package is schedules for auto\-installation, auto\-removal,
-or reinstallation of a forcibly removed, and at the same time
-is excluded, tlmgr will warn you and stop. 
+If this option specifies a package that would otherwise be a candidate
+for auto\-installation, auto\-removal, or reinstallation of a forcibly
+removed package, \f(CW\*(C`tlmgr\*(C'\fR quits with an error message.  Excludes are not
+supported in these circumstances.
 .IP "\fB\-\-dry\-run\fR" 4
 .IX Item "--dry-run"
 Nothing is actually installed; instead, the actions to be performed are
@@ -365,16 +369,20 @@ is equivalent to
 .Ve
 .IP "\fB\-\-reinstall\-forcibly\-removed\fR" 4
 .IX Item "--reinstall-forcibly-removed"
-Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will not install packages that it
-considers forcibly removed (that is, removed with `remove \-\-force' or
-whose installation was prohibited by \-\-no\-auto\-install during an
-earlier update). This option makes \f(CW\*(C`tlmgr\*(C'\fR consider all these packages
-as new and re-install them. This can be used to syncronize an
-installation with the server's idea of what is available by calling
+Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will not install packages that have
+been forcibly removed by the user; that is, removed with \f(CW\*(C`remove
+\&\-\-force\*(C'\fR, or whose installation was prohibited by \f(CW\*(C`\-\-no\-auto\-install\*(C'\fR
+during an earlier update.
+.Sp
+This option makes \f(CW\*(C`tlmgr\*(C'\fR ignore the forcible removals and re-install
+all such packages. This can be used to synchronize an installation with
+the server's idea of what is available by calling
 .Sp
 .Vb 1
 \&  tlmgr update --reinstall-forcibly-removed --all
 .Ve
+.Sp
+This option only works in conjunction with \f(CW\*(C`\-\-all\*(C'\fR.
 .IP "\fB\-\-backup\fR and \fB\-\-backupdir\fR \fIdirectory\fR" 4
 .IX Item "--backup and --backupdir directory"
 These two options control the creation of backups of packages \fIbefore\fR
@@ -390,11 +398,11 @@ You can set options via the \f(CW\*(C`option\*(C'\fR action to automatically cre
 backups for all packages, and/or keep only a certain number of
 backups.  Please see the \f(CW\*(C`option\*(C'\fR action for details.
 .Sp
-\&\f(CW\*(C`tlmgr\*(C'\fR unconditionally makes a temporary backup when updating
-packages, in case of download or other failure during an update.  In
-contrast, the purpose of this \f(CW\*(C`\-\-backup\*(C'\fR option is to allow you to save
-a persistent backup in case the actual \fIcontent\fR of the update causes
-problems, e.g., introduces an incompatibility.
+\&\f(CW\*(C`tlmgr\*(C'\fR always makes a temporary backup when updating packages, in case
+of download or other failure during an update.  In contrast, the purpose
+of this \f(CW\*(C`\-\-backup\*(C'\fR option is to allow you to save a persistent backup
+in case the actual \fIcontent\fR of the update causes problems, e.g.,
+introduces an incompatibility.
 .Sp
 The \f(CW\*(C`restore\*(C'\fR action explains how to restore from a backup.
 .IP "\fB\-\-no\-depends\fR" 4
diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf
index 683b81e749e..365f60b532d 100644
--- a/Master/texmf/doc/man/man1/tlmgr.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.pdf