From 6e2d313899247531a754dd437e731d872f09c769 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 14 May 2017 00:06:42 +0000 Subject: tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@44327 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/tlmgr.1 | 99 ++++++++++++++++++++-------------- 1 file changed, 58 insertions(+), 41 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 4d5138ac327..8d33fd40422 100644 --- a/Master/texmf-dist/doc/man/man1/tlmgr.1 +++ b/Master/texmf-dist/doc/man/man1/tlmgr.1 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "TLMGR 1" -.TH TLMGR 1 "2017-05-11" "perl v5.24.1" "User Contributed Perl Documentation" +.TH TLMGR 1 "2017-05-13" "perl v5.24.1" "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 @@ -610,9 +610,12 @@ category, short and long description, sizes, installation status, and TeX Live revision number. If \fIpkg\fR is not locally installed, searches in the remote installation source. .PP -For normal packages (not collections or schemes), the sizes of the -four groups of files (run/src/doc/bin files) are shown. For collections -and schemes the \fBaccumulated\fR size including depending packages. +For normal packages (not collections or schemes), the sizes of the four +groups of files (run/src/doc/bin files) are shown separately. For +collections, the cumulative size is shown, including all +directly-dependent packages (but not dependent collections). For +schemes, the cumulative size is also shown, including all +directly-dependent collections and packages. .PP If \fIpkg\fR is not found locally or remotely, the search action is used and lists matching packages and files. @@ -792,7 +795,8 @@ Its value is an integer. If the \f(CW\*(C`autobackup\*(C'\fR value is \f(CW\*(C backups are removed. If \f(CW\*(C`autobackup\*(C'\fR is 0 or more, it specifies the number of backups to keep. Thus, backups are disabled if the value is 0. In the \f(CW\*(C`\-\-clean\*(C'\fR mode of the \f(CW\*(C`backup\*(C'\fR action this option also -specifies the number to be kept. +specifies the number to be kept. The default value is 1, so that +backups are made, but only one backup is kept. .PP To setup \f(CW\*(C`autobackup\*(C'\fR to \f(CW\*(C`\-1\*(C'\fR on the command line, use: .PP @@ -808,13 +812,14 @@ The \f(CW\*(C`sys_bin\*(C'\fR, \f(CW\*(C`sys_man\*(C'\fR, and \f(CW\*(C`sys_info Unix-like systems to control the generation of links for executables, info files and man pages. See the \f(CW\*(C`path\*(C'\fR action for details. .PP -The last three options control behavior on Windows installations. If -\&\f(CW\*(C`desktop_integration\*(C'\fR is set, then some packages will install items in -a sub-folder of the Start menu for \f(CW\*(C`tlmgr gui\*(C'\fR, documentation, etc. If -\&\f(CW\*(C`fileassocs\*(C'\fR is set, Windows file associations are made (see also the -\&\f(CW\*(C`postaction\*(C'\fR action). Finally, if \f(CW\*(C`multiuser\*(C'\fR is set, then adaptions -to the registry and the menus are done for all users on the system -instead of only the current user. All three options are on by default. +The last three options also affect behavior on Windows installations. +If \f(CW\*(C`desktop_integration\*(C'\fR is set, then some packages will install items +in a sub-folder of the Start menu for \f(CW\*(C`tlmgr gui\*(C'\fR, documentation, etc. +If \f(CW\*(C`fileassocs\*(C'\fR is set, Windows file associations are made (see also +the \f(CW\*(C`postaction\*(C'\fR action). Finally, if \f(CW\*(C`multiuser\*(C'\fR is set, then +adaptions to the registry and the menus are done for all users on the +system instead of only the current user. All three options are on by +default. .SS "paper" .IX Subsection "paper" .IP "\fBpaper [a4|letter]\fR" 4 @@ -954,20 +959,29 @@ Remove each \fIpkg\fR specified. Removing a collection removes all package dependencies (unless \f(CW\*(C`\-\-no\-depends\*(C'\fR is specified), but not any collection dependencies of that collection. However, when removing a package, dependencies are never removed. Options: -.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 \fIbefore\fR -removal; 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. +.IP "\fB\-\-backup\fR" 4 +.IX Item "--backup" +.PD 0 +.IP "\fB\-\-backupdir\fR \fIdirectory\fR" 4 +.IX Item "--backupdir directory" +.PD +These options behave just as with the \*(L"update\*(R" action (q.v.), except +they apply to making backups of packages before they are removed. The +default is to make such a backup, that is, to save a copy of packages +before removal. +.Sp +See \*(L"update\*(R" action for more. .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. +neither option is given, no backup will be 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 \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 make +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. The default is to make one +backup. .Sp The \f(CW\*(C`restore\*(C'\fR action explains how to restore from a backup. .IP "\fB\-\-no\-depends\fR" 4 @@ -1273,28 +1287,31 @@ installation with the server's idea of what is available: .Vb 1 \& tlmgr update \-\-reinstall\-forcibly\-removed \-\-all .Ve -.IP "\fB\-\-backup\fR and \fB\-\-backupdir\fR \fIdirectory\fR" 4 -.IX Item "--backup and --backupdir directory" +.IP "\fB\-\-backup\fR" 4 +.IX Item "--backup" +.PD 0 +.IP "\fB\-\-backupdir\fR \fIdirectory\fR" 4 +.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 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. +neither options is given, no backup will made 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 \*(L"option\*(R" 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. +You can also set options via the \f(CW\*(C`/option\*(C'\fR action to automatically make +backups for all packages, and/or keep only a certain number of backups. .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. 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. +of this \f(CW\*(C`\-\-backup\*(C'\fR option is to save a persistent backup in case the +actual \fIcontent\fR of the update causes problems, e.g., introduces an TeX +incompatibility. .Sp -The \f(CW\*(C`restore\*(C'\fR action explains how to restore from a backup. +The \*(L"restore\*(R" action explains how to restore from a backup. .IP "\fB\-\-no\-depends\fR" 4 .IX Item "--no-depends" If you call for updating a package normally all depending packages @@ -1951,4 +1968,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 44289 2017\-05\-11 02:41:34Z preining $ +\&\f(CW$Id:\fR tlmgr.pl 44325 2017\-05\-13 23:31:11Z karl $ -- cgit v1.2.3