From 609a843951a04417cfb73ae7a49d441807db25f3 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 1 Oct 2008 01:42:41 +0000 Subject: /home/texlive/karl/Master/tlpkg/bin/tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@10808 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf/doc/man/man1/tlmgr.1 | 74 ++++++++++++++++++------------------ Master/texmf/doc/man/man1/tlmgr.pdf | Bin 18634 -> 18868 bytes 2 files changed, 36 insertions(+), 38 deletions(-) (limited to 'Master/texmf') 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 . .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 Binary files a/Master/texmf/doc/man/man1/tlmgr.pdf and b/Master/texmf/doc/man/man1/tlmgr.pdf differ -- cgit v1.2.3