summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-05-24 00:14:07 +0000
committerKarl Berry <karl@freefriends.org>2009-05-24 00:14:07 +0000
commitf4c177c2f968c468d88aea4eee2b700ae0ab834a (patch)
treef7f40793b128539fa67ea13bf7ac65275506a6a3
parent7d3cc6e014583a405c33b4ca231652c19fed8de9 (diff)
autobackup doc tweaks
git-svn-id: svn://tug.org/texlive/trunk@13436 c570f23f-e606-0410-a88d-b1316a301751
-rwxr-xr-xMaster/texmf/scripts/texlive/tlmgr.pl41
1 files changed, 19 insertions, 22 deletions
diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index 9ad4383923c..7149c325dd9 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -1266,7 +1266,7 @@ sub action_update {
if ($autobackup) {
# check the format, we currently allow only natural numbers, and -1
if ($autobackup eq "-1") {
- debug ("Automatic backups activated, keeping \\infty backups.\n");
+ debug ("Automatic backups activated, keeping all backups.\n");
$opts{"backup"} = 1;
} elsif ($autobackup eq "0") {
debug ("Automatic backups disabled.\n");
@@ -3087,6 +3087,7 @@ In the second form, if I<value> is not given, the setting for I<key> is
displayed. If I<value> is present, I<key> is set to I<value>.
Possible values for I<key> are:
+
C<location> (default installation location),
C<formats> (create formats at installation time),
C<docfiles> (install documentation files),
@@ -3097,13 +3098,11 @@ Possible values for I<key> are:
C<sys_man> (location where man pages are linked to by action symlinks)
C<sys_info> (location where info pages are linked to by action symlinks)
-Perhaps the most common use of C<option> is if you originally installed from
-DVD, and want to permanently change the installation to get further
-updates from the Internet. To do this, you can run
-
- tlmgr option location http://mirror.ctan.org/systems/texlive/tlnet/YYYY
+One common use of C<option> is if you originally installed from DVD, and
+want to permanently change the installation to get further updates from
+the Internet. To do this, you can run
-where YYYY is the TeX Live release year.
+ tlmgr option location http://mirror.ctan.org/systems/texlive/tlnet
The two options C<autobackup> and C<backupdir> determine defaults for
the C<update>, C<backup> and C<restore> actions. These three actions
@@ -3111,27 +3110,25 @@ need a directory to write to or read from the backups. If
C<--backupdir> is not specified on the command line, the C<backupdir>
option value is used (if set).
-The C<autobackup> option (de)activates the automatic generation of
-backups. Its value is an integer. If C<autobackup> is C<-1>, backups
-will not be removed by default. If C<autobackup> is 0 or positive, it
-specifies the number of backups to be kept. Thus, backups are disabled
-with 0 as the values.
-
-B<Warning:> If you want to set the optin C<autobackup> on the command line
-it might be interpreted as an option. In this case you have to use
+The C<autobackup> option (de)activates automatic generation of backups.
+Its value is an integer. If the C<autobackup> value is C<-1>, no
+backups are removed. If C<autobackup> is 0 or more, it specifies the
+number of backups to keep. Thus, backups are disabled if the value is
+0. In the C<--clean> mode of the C<backup> action this option also
+specifies the number to be kept.
- tlmgr option -- autobackup -1
+To setup C<autobackup> to C<-1> on the command line, use
-The C<--> makes tlmgr stop parsing for options at that place.
+ tlmgr option autobackup infty
-Alternatively, you can ue C<infty> instead of C<-1>, so the above is
-equivalent to
+Or you can use:
- tlmgr option autobackup infty
+ tlmgr option -- autobackup -1
+The C<--> avoids having the C<-1> treated as an option. (In general,
+C<--> stops parsing for arguments at the point where it appears; this is
+a general feature of option parsing.)
-In the C<--clean> mode of the C<backup> action this option also
-specifies the number to be kept.
=head2 symlinks [add|remove]