tlmgr backup related doc fixes from Adam Maxwell, thanks

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

1 files changed, 17 insertions, 12 deletions

diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index 534cf38015d..0b67eca84d7 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -5004,20 +5004,21 @@ If the package on the server is older than the package already installed
 downgrade.  Also, packages for uninstalled platforms are not installed.
 
 
-=head2 backup [--clean[=I<N>]] [--backupdir I<dir>] [--all] [I<pkg>]...
+=head2 backup [--clean[=I<N>]] [--backupdir I<dir>] [--all | I<pkg>]...
 
 If the C<--clean> option is not specified, this action makes a backup of
 the given packages, or all packages given C<--all>. These backups are
-saved to the value of C<--backupdir> option if that is an existing and
-writable directory; if C<--backupdir> is not given, the C<backupdir>
+saved to the value of the C<--backupdir> option, if that is an existing and
+writable directory. If C<--backupdir> is not given, the C<backupdir>
 option setting in the TLPDB is used, if present.  If both are missing,
 no backups are made.
 
 If the C<--clean> option is specified, backups are cleaned (pruned)
-instead of made.  If the value for the C<--clean> switch is not given,
-the value of the C<autobackup> option is used. If both are missing,
-an error is issued.  For the details of backup cleaning, see the
-C<option> action below.
+instead of saved. The optional value I<N> may be specified to set the
+number of backups that will be retained when cleaning. If C<N> is not
+given, the value of the C<autobackup> option is used. If both are
+missing, an error is issued. For more details of backup cleaning, see
+the C<option> action.
 
 Options:
 
@@ -5025,18 +5026,22 @@ Options:
 
 =item B<--backupdir> I<directory>
 
-The I<directory> argument is required and must specify an existing
-directory where backups are to be placed.
+Overrides the C<backupdir> option setting in the TLPDB.
+The I<directory> argument is required and must specify an existing,
+writeable directory where backups are to be placed.
 
 =item B<--all>
 
-Make a backup of all packages in the TeX Live installation.  This will
-take quite a lot of space and time.
+If C<--clean> is not specified, this will make a backup of all packages 
+in the TeX Live installation; this will take quite a lot of space and time.
+If C<--clean> is specified, all packages will be cleaned.
 
 =item B<--clean>[=I<N>]
 
 Instead of making backups, prune the backup directory of old backups, as
-explained above.
+explained above. Use the I<N> argument to override the C<autobackup> option
+set in the TLPDB. Note that you must also use C<--all> or a list of
+packages, as appropriate.
 
 =item B<--dry-run>