summaryrefslogtreecommitdiff
path: root/Master/texmf
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-10-01 01:42:41 +0000
committerKarl Berry <karl@freefriends.org>2008-10-01 01:42:41 +0000
commit609a843951a04417cfb73ae7a49d441807db25f3 (patch)
treeb51e4c7128de701a3979d82eb6a90b48dbeb70b4 /Master/texmf
parent41813fafceeeb30cbeca5ace4a03c98a156b68eb (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@10808 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf')
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.174
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.pdfbin18634 -> 18868 bytes
2 files changed, 36 insertions, 38 deletions
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index 97a62e9e33f..71fdd3596c6 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 "2008-09-28" "perl v5.8.8" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2008-09-30" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
tlmgr \- the TeX Live Manager
.SH "SYNOPSIS"
@@ -146,7 +146,8 @@ The most up-to-date version of this documentation is available at
<http://tug.org/texlive/tlmgr.html>.
.SH "OPTIONS"
.IX Header "OPTIONS"
-The following options have to be given \fIbefore\fR you specify the action.
+The following options to \f(CW\*(C`tlmgr\*(C'\fR have to be given \fIbefore\fR you specify
+the main action to perform.
.IP "\fB\-\-location\fR \fIlocation\fR" 4
.IX Item "--location location"
Specifies the location from which packages should be installed or
@@ -207,32 +208,33 @@ written to the terminal.
.IX Item "update [option] [pkg...]"
Updates the packages given as arguments to the latest version available
at the installation source. Either \f(CW\*(C`\-\-all\*(C'\fR or at least one \fIpkg\fR name
-must be specified.
-.Sp
-Furthermore, it \fBremoves\fR packages which have disappeared on the server.
-To not remove any locally installed packages it does check that the
-package came from the server by checking for inclusion in collections.
-Both options \f(CW\*(C`\-\-dry\-run\*(C'\fR and \f(CW\*(C`\-\-list\*(C'\fR will mention the packages
-to be removed. See <\-\-no\-remova> for a way to supress that.
-.Sp
-Options:
+must be specified. Options:
.RS 4
.IP "\fB\-\-all\fR" 8
.IX Item "--all"
-Update already-installed packages, and install new packages in installed
-collections. (Packages in uninstalled collections are not considered.)
+Update all installed packages. For packages contained in an installed
+collection, also install new packages and remove deleted packages in
+those collections. Packages not contained in an installed collection
+are not considered for addition or removal.
+.Sp
+More precisely, if both the server and the local installation have a
+collection C, and C on the server contains a package A that is not
+present locally, A will be added. Conversely, if the local collection C
+contains a package B, but B is no longer in the server's C, then B will
+be deleted.
.IP "\fB\-\-list\fR" 8
.IX Item "--list"
-List the packages which would be updated or newly installed.
-.IP "\fB\-\-no\-remove\fR" 8
-.IX Item "--no-remove"
-Under normal circumstances tlmgr tries to remove packages which have
-disappeared on the server when called with \f(CW\*(C`\-\-all\*(C'\fR. This prevents
-these removals.
+Concisely list the packages which would be updated, newly installed, or
+removed, without actually changing anything.
.IP "\fB\-\-dry\-run\fR" 8
.IX Item "--dry-run"
Nothing is actually installed; instead, the actions to be performed are
-written to the terminal. (A more verbose report than \f(CW\*(C`\-\-list\*(C'\fR.)
+written to the terminal. This is a more detailed report than \f(CW\*(C`\-\-list\*(C'\fR.
+.IP "\fB\-\-no\-remove\fR" 8
+.IX Item "--no-remove"
+Under normal circumstances tlmgr tries to remove packages which have
+disappeared on the server when called with \f(CW\*(C`\-\-all\*(C'\fR, as described
+above. This prevents any such removals.
.IP "\fB\-\-backupdir\fR \fIdirectory\fR" 8
.IX Item "--backupdir directory"
\&\fIdirectory\fR specifies a directory where the package as installed will
@@ -342,20 +344,20 @@ where \s-1YYYY\s0 is the TeX Live release year.
.PD 0
.IP "\fBpaper letter\fR" 4
.IX Item "paper letter"
-.IP "\fB[xdvi|dvips|pdftex|dvipdfm|dvipdfmx|context] paper [help|papersize|\-\-list]\fR" 4
+.IP "\fB[xdvi|dvips|pdftex|dvipdfm|dvipdfmx|context] paper [help|\f(BIpapersize\fB|\-\-list]\fR" 4
.IX Item "[xdvi|dvips|pdftex|dvipdfm|dvipdfmx|context] paper [help|papersize|--list]"
.PD
-Configures the system wide paper settings, either for all programs in
-one go, or just for the specified program. The last form with \fB\-\-list\fR
-outputs all known papersizes for the specified program.
-.IP "\fBarch list\fR" 4
-.IX Item "arch list"
-Prints the names of the architectures (\f(CW\*(C`i386\-linux\*(C'\fR, ...) available at
-the default install location.
-.IP "\fBarch add \f(BIarch\fB...\fR" 4
-.IX Item "arch add arch..."
-Add executables for each given architecture \fIarch\fR to the installation.
-Options:
+Configures the system wide paper settings, either for all programs at
+once (first two forms), or just for the specified program (third
+form). The third form with \f(CW\*(C`\-\-list\*(C'\fR outputs all known papersizes for the
+specified program.
+.IP "\fBarch list|add\fR \fIarch\fR..." 4
+.IX Item "arch list|add arch..."
+\&\f(CW\*(C`arch list\*(C'\fR lists the TeX Live names of all the architectures
+(\f(CW\*(C`i386\-linux\*(C'\fR, ...) available at the default install location.
+.Sp
+\&\f(CW\*(C`arch add\*(C'\fR \fIarch\fR adds the executables for each given architecture
+\&\fIarch\fR to the installation. Options:
.RS 4
.IP "\fB\-\-dry\-run\fR" 8
.IX Item "--dry-run"
@@ -388,7 +390,7 @@ for the package if it is not locally installed.
.IP "\fBlist [collections|schemes]\fR" 4
.IX Item "list [collections|schemes]"
With no argument, lists all packages available at the default install
-location, prefixing those already installed with \f(CW\*(C`i \*(C'\fR.
+location, prefixing those already installed with "\f(CW\*(C`i\*(C'\fR".
.Sp
With an argument lists only collections or schemes, as requested.
.IP "\fBcheck [\f(BIoption\fB...] [files|collections|all]\fR" 4
@@ -397,12 +399,8 @@ Executes one (or all) check(s) on the consistency of the installation.
.RS 4
.IP "\fBfiles\fR" 8
.IX Item "files"
-Checks that all files listed in the TeX Live Database (texlive.tlpdb)
+Checks that all files listed in the TeX Live Database (\f(CW\*(C`texlive.tlpdb\*(C'\fR)
are actually present, and lists those missing.
-.Sp
-Note that on Windows that will not work currently, since Windows does not
-ship find. Also MacOS seems to ship a strange find implementation that does
-not support \-wholename, so that will break, too.
.IP "\fBcollections\fR" 8
.IX Item "collections"
Lists those packages which occur as dependencies in an installed collections,
diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf
index 465c17524cb..f4a0ab0e5b1 100644
--- a/Master/texmf/doc/man/man1/tlmgr.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.pdf
Binary files differ