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

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

2 files changed, 45 insertions, 42 deletions

diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index 73a69f32582..7ba3e8ab076 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-08-23" "perl v5.8.8" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2009-08-24" "perl v5.8.8" "User Contributed Perl Documentation"
 .SH "NAME"
 tlmgr \- the TeX Live Manager
 .SH "SYNOPSIS"
@@ -144,7 +144,7 @@ included and supported, but \f(CW\*(C`tlmgr\*(C'\fR is now preferred.)
 .PP
 The most up-to-date version of this documentation is available at
 <http://tug.org/texlive/tlmgr.html>, along with procedures for updating
-tlmgr itself, disaster recovery when it's broken, and test versions.
+\&\f(CW\*(C`tlmgr\*(C'\fR itself, disaster recovery when it's broken, and test versions.
 .SH "OPTIONS"
 .IX Header "OPTIONS"
 The following options to \f(CW\*(C`tlmgr\*(C'\fR are global options not specific to
@@ -194,8 +194,8 @@ This option make \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 tlmgr report any missing or probably 
-untranslated messages in \s-1GUI\s0 mode to \s-1STDERR\s0.
+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.
 .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
@@ -203,7 +203,7 @@ 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 as well as the \f(CW\*(C`tlmgr\*(C'\fR script itself. If paired with \f(CW\*(C`\-v\*(C'\fR,
+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.
 .SH "ACTIONS"
 .IX Header "ACTIONS"
@@ -248,9 +248,9 @@ Nothing is actually installed; instead, the actions to be performed are
 written to the terminal.
 .IP "\fB\-\-force\fR" 4
 .IX Item "--force"
-If updates to the tlmgr itself (and the underlying infrastructure) are
-present tlmgr will bail out and not perform the installation unless this option
-is given.
+If updates to \f(CW\*(C`tlmgr\*(C'\fR itself (or other parts of the basic
+infrastructure) are present, \f(CW\*(C`tlmgr\*(C'\fR will bail out and not perform the
+installation unless this option is given.  Not recommended.
 .Sh "update [\fIoption\fP]... [\fIpkg\fP]..."
 .IX Subsection "update [option]... [pkg]..."
 Updates the packages given as arguments to the latest version available
@@ -258,8 +258,8 @@ at the installation source.  Either \f(CW\*(C`\-\-all\*(C'\fR or at least one \f
 must be specified.  Options:
 .IP "\fB\-\-all\fR" 4
 .IX Item "--all"
-Update all installed packages except for tlmgr itself.  Thus, if updates
-to tlmgr itself are present, this will simply give an error, unless also
+Update all installed packages except for \f(CW\*(C`tlmgr\*(C'\fR itself.  Thus, if updates
+to \f(CW\*(C`tlmgr\*(C'\fR itself are present, this will simply give an error, unless also
 the option \f(CW\*(C`\-\-force\*(C'\fR or \f(CW\*(C`\-\-self\*(C'\fR is given.  (See below.)
 .Sp
 In addition to updating the installed packages, during the update of a
@@ -267,7 +267,7 @@ collection the local installation is (by default) synchronized to the
 status of the collection on the server, for both additions and removals.
 .Sp
 Specifically, if a package has been removed on the server (and thus has
-also been removed from the respective collection), tlmgr will remove the
+also been removed from the respective collection), \f(CW\*(C`tlmgr\*(C'\fR will remove the
 package also on the local installation. This is called ``auto\-remove''
 and is announced as such when using the option \f(CW\*(C`\-\-list\*(C'\fR. This
 auto-removal can be suppressed using the option \f(CW\*(C`\-\-no\-auto\-remove\*(C'\fR.
@@ -285,12 +285,12 @@ To reinstall any such forcibly removed packages use
 \&\f(CW\*(C`\-\-reinstall\-forcibly\-removed\*(C'\fR.
 .IP "\fB\-\-self\fR" 4
 .IX Item "--self"
-Update tlmgr itself (that is, the infrastructure packages) if updates to
+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 tlmgr will be updated first and, if this update the new version
+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.
 .Sp
 In brief:
@@ -310,18 +310,18 @@ Nothing is actually installed; instead, the actions to be performed are
 written to the terminal.  This is a more detailed report than \f(CW\*(C`\-\-list\*(C'\fR.
 .IP "\fB\-\-force\fR" 4
 .IX Item "--force"
-Force update of normal packages, without updating tlmgr itself 
+Force update of normal packages, without updating \f(CW\*(C`tlmgr\*(C'\fR itself 
 (unless the \f(CW\*(C`\-\-self\*(C'\fR option is also given).  Not recommended.
 .Sp
 Also, \f(CW\*(C`update \-\-list\*(C'\fR is still performed regardless of this option.
 .IP "\fB\-\-no\-auto\-remove\fR" 4
 .IX Item "--no-auto-remove"
-Under normal circumstances tlmgr tries to remove packages which have
+Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR tries to remove packages which have
 disappeared on the server when called with \f(CW\*(C`\-\-all\*(C'\fR, as described
 above. This prevents any such removals.
 .IP "\fB\-\-no\-auto\-install\fR" 4
 .IX Item "--no-auto-install"
-Under normal circumstances tlmgr will install packages which are
+Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will install packages which are
 new on the server when called with \f(CW\*(C`\-\-all\*(C'\fR. This prevents any such
 automatic installation. Note that after this the packages that
 would have been auto-installed will be considered as
@@ -340,10 +340,10 @@ is equivalent to
 .Ve
 .IP "\fB\-\-reinstall\-forcibly\-removed\fR" 4
 .IX Item "--reinstall-forcibly-removed"
-Under normal circumstances tlmgr will not install packages that it
+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 tlmgr consider all these packages
+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
 .Sp
@@ -352,24 +352,24 @@ installation with the server's idea of what is available by calling
 .Ve
 .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 before an
-update is started; that is, the backup is of the package as it's
-installed.  If neither of the two are given, no backup package will be
-saved. If \f(CW\*(C`\-\-backupdir\*(C'\fR is given and specifies a writable directory
-then a backup will be made in that location. If only \f(CW\*(C`\-\-backup\*(C'\fR is
-given, then a backup will be made to the directory previously set via
-the \f(CW\*(C`option\*(C'\fR action (see below). If both are given then a backup will
-be made to the specified \fIdirectory\fR.
+These two options control the creation of backups of packages \fIbefore\fR
+updating; that is, backup of packages as currently installed.  If
+neither of these options are given, no backup package will be saved. If
+\&\f(CW\*(C`\-\-backupdir\*(C'\fR is given and specifies a writable directory then a backup
+will be made in that location. If only \f(CW\*(C`\-\-backup\*(C'\fR is given, then a
+backup will be made to the directory previously set via the \f(CW\*(C`option\*(C'\fR
+action (see below). If both are given then a backup will be made to the
+specified \fIdirectory\fR.
 .Sp
 You can set options via the \f(CW\*(C`option\*(C'\fR action to automatically create
 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.
+backups.  Please see the \f(CW\*(C`option\*(C'\fR action for details.
 .Sp
-\&\f(CW\*(C`tlmgr\*(C'\fR always makes a temporary backup when updating packages, in case
-of download or other failure during an update.  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 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.
 .Sp
 The \f(CW\*(C`restore\*(C'\fR action explains how to restore from a backup.
 .IP "\fB\-\-no\-depends\fR" 4
@@ -488,7 +488,7 @@ Possible values for \fIkey\fR are (but see \fBtlmgr option showall\fR for
 the definitive list):
 .PP
 .Vb 9
-\& location (default installation location),
+\& location (default installation source),
 \& formats (create formats at installation time),
 \& docfiles (install documentation files),
 \& srcfiles (install source files),
@@ -499,9 +499,9 @@ the definitive list):
 \& sys_info (location where info pages are linked to by action path)
 .Ve
 .PP
-One common use of \f(CW\*(C`option\*(C'\fR is if you originally installed from \s-1DVD\s0, and
-want to permanently change the installation to get further updates from
-the Internet.  To do this, you can run
+One common use of \f(CW\*(C`option\*(C'\fR is to permanently change the installation to
+get further updates from the Internet, after originally installing from
+\&\s-1DVD\s0.  To do this, you can run
 .PP
 .Vb 1
 \& tlmgr option location http://mirror.ctan.org/systems/texlive/tlnet
@@ -535,19 +535,22 @@ Or you can use:
 \&  tlmgr option -- autobackup -1
 .Ve
 .PP
-The \f(CW\*(C`\-\-\*(C'\fR avoids having the \f(CW\*(C`\-1\*(C'\fR treated as an option.  (In general,
-\&\f(CW\*(C`\-\-\*(C'\fR stops parsing for arguments at the point where it appears; this is
-a general feature of option parsing.)
+The \f(CW\*(C`\-\-\*(C'\fR avoids having the \f(CW\*(C`\-1\*(C'\fR treated as an option.  (For most
+programs, \f(CW\*(C`\-\-\*(C'\fR stops parsing for arguments at the point where it
+appears; this is a general feature of option parsing.)
 .Sh "conf"
 .IX Subsection "conf"
-This option to tlmgr mimicks the \fBtexconfig conf\fR call, but works on
+Show general configuration information for TeX Live, including active
+configuration files, path settings, and more.
+.PP
+This option to \f(CW\*(C`tlmgr\*(C'\fR mimics the \f(CW\*(C`texconfig conf\*(C'\fR call, but works on
 all supported platforms.
 .Sh "path [\-\-w32mode=user|admin] [add|remove]"
 .IX Subsection "path [--w32mode=user|admin] [add|remove]"
-On unix adds or removes symlinks for binaries, man pages, and info pages
+On Unix adds or removes symlinks for binaries, man pages, and info pages
 in the directories specified by the respective options (see above).
 .PP
-On W32 based systems the registry part where the binary directory is
+On Windows, the registry part where the binary directory is
 added or removed is determined in the following way:
 .PP
 If the user has admin rights, and the option \f(CW\*(C`\-\-w32mode\*(C'\fR is not given,
diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf
index 65cde3238c7..5057a2fac00 100644
--- a/Master/texmf/doc/man/man1/tlmgr.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.pdf