summaryrefslogtreecommitdiff
path: root/Master/texmf
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2010-09-29 02:17:26 +0000
committerNorbert Preining <preining@logic.at>2010-09-29 02:17:26 +0000
commit443b892fa7fa805d29aac51a2adde0d398aa65b9 (patch)
tree084d636c8d9cbc1306ea8c38b5d2259c91611108 /Master/texmf
parent6eb45d84448f6a54ca21ce0c844eb7ec27ecee2e (diff)
tlmgr backup related doc fixes from Adam Maxwell, thanks
git-svn-id: svn://tug.org/texlive/trunk@19946 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf')
-rwxr-xr-xMaster/texmf/scripts/texlive/tlmgr.pl29
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>