From 061769af951c974e56fcd06ac3b1a3c7cbd468f8 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 5 Sep 2009 01:23:38 +0000 Subject: /home/texlive/karl/Master/tlpkg/bin/tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@15119 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf/doc/man/man1/tlmgr.1 | 66 ++++++++++++++++++++---------------- Master/texmf/doc/man/man1/tlmgr.pdf | Bin 44014 -> 44207 bytes 2 files changed, 37 insertions(+), 29 deletions(-) (limited to 'Master/texmf') diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1 index c56b389576f..5501feaa3eb 100644 --- a/Master/texmf/doc/man/man1/tlmgr.1 +++ b/Master/texmf/doc/man/man1/tlmgr.1 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "TLMGR 1" -.TH TLMGR 1 "2009-09-03" "perl v5.8.8" "User Contributed Perl Documentation" +.TH TLMGR 1 "2009-09-05" "perl v5.8.8" "User Contributed Perl Documentation" .SH "NAME" tlmgr \- the TeX Live Manager .SH "SYNOPSIS" @@ -292,43 +292,47 @@ If you want to exclude some packages from being updated (e.g., due to a slow link), see the \f(CW\*(C`\-\-exclude\*(C'\fR option below. .IP "\fB\-\-self\fR" 4 .IX Item "--self" -Update \f(CW\*(C`tlmgr\*(C'\fR itself (that is, the infrastructure packages) if updates to -it are present. On Windows this includes updates to the private Perl +Update \f(CW\*(C`tlmgr\*(C'\fR itself (that is, the infrastructure packages) if updates +to it are present. On Windows this includes updates to the private Perl interpreter shipped inside TeX Live. .Sp -If this option is given together with \f(CW\*(C`\-\-all\*(C'\fR or a list of packages -then \f(CW\*(C`tlmgr\*(C'\fR will be updated first and, if this update the new version -will be restarted to complete the rest of the updates. +If this option is given together with either \f(CW\*(C`\-\-all\*(C'\fR or a list of +packages, then \f(CW\*(C`tlmgr\*(C'\fR will be updated first and, if this update +succeeds, the new version will be restarted to complete the rest of the +updates. .Sp -In brief: +In short: .Sp .Vb 3 \& tlmgr update --self # update infrastructure only \& tlmgr update --self --all # update infrastructure and all packages \& tlmgr update --force --all # update all packages but *not* infrastructure .Ve -.IP "\fB\-\-list\fR" 4 -.IX Item "--list" +.IP "\fB\-\-list\fR [\fIpkg\fR]" 4 +.IX Item "--list [pkg]" Concisely list the packages which would be updated, newly installed, or removed, without actually changing anything. If no package is given acts like \f(CW\*(C`\-\-list \-\-all\*(C'\fR, otherwise lists only updates to the packages given as arguments (and its dependencies). -.IP "\fB\-\-exclude \f(BIpkg\fB\fR" 4 +.IP "\fB\-\-exclude\fR \fIpkg\fR" 4 .IX Item "--exclude pkg" -Exclude \fIpkg\fR from the update process. This option can be given -multiple times. Giving a string \f(CW\*(C`pkg\*(C'\fR here will exclude the package -\&\f(CW\*(C`pkg\*(C'\fR itself and all packages \f(CW\*(C`pkg.something\*(C'\fR. As an example giving +Exclude \fIpkg\fR from the update process. If this option is given more +than once, its arguments accumulate. +.Sp +An argument \fIpkg\fR excludes both the package \fIpkg\fR itself and all +its related architecture-specific packages \fIpkg.ARCH\fR. For example, .Sp .Vb 1 \& tlmgr update --all --exclude a2ping .Ve .Sp -will not update \f(CW\*(C`a2ping\*(C'\fR itself, nor \f(CW\*(C`a2ping.i386\-linux\*(C'\fR or -any other arch-package \f(CW\*(C`a2ping.ARCH\*(C'\fR. +will not update \f(CW\*(C`a2ping\*(C'\fR, \f(CW\*(C`a2ping.i386\-linux\*(C'\fR, or +any other \f(CW\*(C`a2ping.\*(C'\fR\fI\s-1ARCH\s0\fRpackage. .Sp -Note that if a package is schedules for auto\-installation, auto\-removal, -or reinstallation of a forcibly removed, and at the same time -is excluded, tlmgr will warn you and stop. +If this option specifies a package that would otherwise be a candidate +for auto\-installation, auto\-removal, or reinstallation of a forcibly +removed package, \f(CW\*(C`tlmgr\*(C'\fR quits with an error message. Excludes are not +supported in these circumstances. .IP "\fB\-\-dry\-run\fR" 4 .IX Item "--dry-run" Nothing is actually installed; instead, the actions to be performed are @@ -365,16 +369,20 @@ is equivalent to .Ve .IP "\fB\-\-reinstall\-forcibly\-removed\fR" 4 .IX Item "--reinstall-forcibly-removed" -Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will not install packages that it -considers forcibly removed (that is, removed with `remove \-\-force' or -whose installation was prohibited by \-\-no\-auto\-install during an -earlier update). This option makes \f(CW\*(C`tlmgr\*(C'\fR consider all these packages -as new and re-install them. This can be used to syncronize an -installation with the server's idea of what is available by calling +Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will not install packages that have +been forcibly removed by the user; that is, removed with \f(CW\*(C`remove +\&\-\-force\*(C'\fR, or whose installation was prohibited by \f(CW\*(C`\-\-no\-auto\-install\*(C'\fR +during an earlier update. +.Sp +This option makes \f(CW\*(C`tlmgr\*(C'\fR ignore the forcible removals and re-install +all such packages. This can be used to synchronize an installation with +the server's idea of what is available by calling .Sp .Vb 1 \& tlmgr update --reinstall-forcibly-removed --all .Ve +.Sp +This option only works in conjunction with \f(CW\*(C`\-\-all\*(C'\fR. .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 @@ -390,11 +398,11 @@ You can set options via the \f(CW\*(C`option\*(C'\fR action to automatically cre 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. .Sp -\&\f(CW\*(C`tlmgr\*(C'\fR unconditionally 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. +\&\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. .Sp The \f(CW\*(C`restore\*(C'\fR action explains how to restore from a backup. .IP "\fB\-\-no\-depends\fR" 4 diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf index 683b81e749e..365f60b532d 100644 Binary files a/Master/texmf/doc/man/man1/tlmgr.pdf and b/Master/texmf/doc/man/man1/tlmgr.pdf differ -- cgit v1.2.3