From 1ad49dbb624e03790f577abb2521cb7a98d503f1 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 20 Oct 2019 23:53:55 +0000 Subject: tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@52469 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/tlmgr.1 | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) (limited to 'Master/texmf-dist/doc/man/man1/tlmgr.1') diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1 index 7448ff22aea..87e27319dc4 100644 --- a/Master/texmf-dist/doc/man/man1/tlmgr.1 +++ b/Master/texmf-dist/doc/man/man1/tlmgr.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "TLMGR 1" -.TH TLMGR 1 "2019-05-24" "perl v5.30.0" "User Contributed Perl Documentation" +.TH TLMGR 1 "2019-10-20" "perl v5.30.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -429,10 +429,12 @@ If \f(CW\*(C`\-v\*(C'\fR has been given the revisions of the used modules are re .PD If the \f(CW\*(C`\-\-clean\*(C'\fR option is not specified, this action makes a backup of the given packages, or all packages given \f(CW\*(C`\-\-all\*(C'\fR. These backups are -saved to the value of the \f(CW\*(C`\-\-backupdir\*(C'\fR option, if that is an existing and -writable directory. If \f(CW\*(C`\-\-backupdir\*(C'\fR is not given, the \f(CW\*(C`backupdir\*(C'\fR -option setting in the \s-1TLPDB\s0 is used, if present. If both are missing, -no backups are made. +saved to the value of the \f(CW\*(C`\-\-backupdir\*(C'\fR option, if that is an existing +and writable directory. If \f(CW\*(C`\-\-backupdir\*(C'\fR is not given, the \f(CW\*(C`backupdir\*(C'\fR +option setting in the \s-1TLPDB\s0 is used, if present. If both are missing, no +backups are made. (The installer sets \f(CW\*(C`backupdir\*(C'\fR to +\&\f(CW\*(C`.../tlpkg/backups\*(C'\fR, under the \s-1TL\s0 root installation directory, so it is +usually defined; see the \*(L"option\*(R" description for more information.) .Sp If the \f(CW\*(C`\-\-clean\*(C'\fR option is specified, backups are pruned (removed) instead of saved. The optional integer value \fIN\fR may be specified to @@ -948,10 +950,11 @@ testing installations, etc. When disabled, the respective files are not downloaded at all. .PP The options \f(CW\*(C`autobackup\*(C'\fR and \f(CW\*(C`backupdir\*(C'\fR determine the defaults for -the actions \f(CW\*(C`update\*(C'\fR, \f(CW\*(C`backup\*(C'\fR and \f(CW\*(C`restore\*(C'\fR. These three actions -need a directory in which to read or write the backups. If +the actions \f(CW\*(C`update\*(C'\fR, \f(CW\*(C`backup\*(C'\fR and \f(CW\*(C`restore\*(C'\fR. These three actions +need a directory in which to read or write the backups. If \&\f(CW\*(C`\-\-backupdir\*(C'\fR is not specified on the command line, the \f(CW\*(C`backupdir\*(C'\fR -option value is used (if set). +option value is used (if set). The \s-1TL\s0 installer sets \f(CW\*(C`backupdir\*(C'\fR to +\&\f(CW\*(C`.../tlpkg/backups\*(C'\fR, under the \s-1TL\s0 root installation directory. .PP The \f(CW\*(C`autobackup\*(C'\fR option (de)activates automatic generation of backups. Its value is an integer. If the \f(CW\*(C`autobackup\*(C'\fR value is \f(CW\*(C`\-1\*(C'\fR, no @@ -1543,8 +1546,8 @@ installation with the server's idea of what is available: .IX Item "--backupdir directory" .PD These two options control the creation of backups of packages \fIbefore\fR -updating; that is, backup of packages as currently installed. If -neither options is given, no backup will made. If \f(CW\*(C`\-\-backupdir\*(C'\fR is +updating; that is, backing up packages as currently installed. If +neither option is given, no backup will made. 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 \*(L"option\*(R" action (see @@ -2258,9 +2261,9 @@ If xz is available (either from the system or \s-1TL\s0) and working, use that. .RE .RS 4 .Sp -lz4 and gzip are much faster in creating tlmgr's local backups. -The unconditional use of xz for the tlnet containers is unaffected, -to minimize download sizes. +lz4 and gzip are faster in creating tlmgr's local backups, hence they +are preferred. The unconditional use of xz for the tlnet containers is +unaffected, to minimize download sizes. .RE .ie n .IP """TEXLIVE_DOWNLOADER""" 4 .el .IP "\f(CWTEXLIVE_DOWNLOADER\fR" 4 @@ -2322,4 +2325,4 @@ This script and its documentation were written for the TeX Live distribution () and both are licensed under the \&\s-1GNU\s0 General Public License Version 2 or later. .PP -\&\f(CW$Id:\fR tlmgr.pl 51217 2019\-05\-24 21:47:41Z karl $ +\&\f(CW$Id:\fR tlmgr.pl 52467 2019\-10\-20 22:10:34Z karl $ -- cgit v1.2.3