summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-09-05 01:23:38 +0000
committerKarl Berry <karl@freefriends.org>2009-09-05 01:23:38 +0000
commit061769af951c974e56fcd06ac3b1a3c7cbd468f8 (patch)
tree81f1dba6d4e0945d5728bf5895a046833096886c
parent1e84ab3051a0600270f3312d1c24135183c9fc40 (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@15119 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/doc.html5
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.166
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.pdfbin44014 -> 44207 bytes
3 files changed, 42 insertions, 29 deletions
diff --git a/Master/doc.html b/Master/doc.html
index a5effe08944..09576dc305a 100644
--- a/Master/doc.html
+++ b/Master/doc.html
@@ -3621,6 +3621,10 @@ directories), sorted by package name.
<a href="texmf-dist/doc/latex/lipsum/lipsum.pdf">lipsum.pdf</a>
</small>
+<li><b><a href="texmf-dist/doc/latex/listings-ext">latex/listings-ext</a>:</b><small>
+ <a href="texmf-dist/doc/latex/listings-ext/listings-ext.pdf">listings-ext.pdf</a>
+ </small>
+
<li><b><a href="texmf-dist/doc/latex/listings">latex/listings</a>:</b><small>
<a href="texmf-dist/doc/latex/listings/listings.pdf">listings.pdf</a>
</small>
@@ -6081,6 +6085,7 @@ directories), sorted by package name.
<a href="texmf/doc/man/man1/epstopdf.pdf">epstopdf.pdf</a>
<a href="texmf/doc/man/man1/etex.pdf">etex.pdf</a>
<a href="texmf/doc/man/man1/extconv.pdf">extconv.pdf</a>
+ <a href="texmf/doc/man/man1/extractbb.pdf">extractbb.pdf</a>
<a href="texmf/doc/man/man1/extractres.pdf">extractres.pdf</a>
<a href="texmf/doc/man/man1/findhyph.pdf">findhyph.pdf</a>
<a href="texmf/doc/man/man1/fixdlsrps.pdf">fixdlsrps.pdf</a>
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
--- a/Master/texmf/doc/man/man1/tlmgr.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.pdf
Binary files differ