summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/tlmgr.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-05-14 00:06:42 +0000
committerKarl Berry <karl@freefriends.org>2017-05-14 00:06:42 +0000
commit6e2d313899247531a754dd437e731d872f09c769 (patch)
tree92dc7adefc36f3d99020c382ac4f138f785a353f /Master/texmf-dist/doc/man/man1/tlmgr.1
parent049186c4da9cfc8548d08a07841b4522249c3dfd (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@44327 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/tlmgr.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.199
1 files changed, 58 insertions, 41 deletions
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 (<http://tug.org/texlive>) 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 $