/home/texlive/karl/Master/tlpkg/bin/tl-update-auto

git-svn-id: svn://tug.org/texlive/trunk@14861 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 41 insertions, 17 deletions

diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index 7ba3e8ab076..b8f5e71d357 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-08-24" "perl v5.8.8" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2009-08-25" "perl v5.8.8" "User Contributed Perl Documentation"
 .SH "NAME"
 tlmgr \- the TeX Live Manager
 .SH "SYNOPSIS"
@@ -154,12 +154,16 @@ non-option argument will be the main action.
 In all cases, \f(CW\*(C`\-\-\*(C'\fR\fIoption\fR and
 \&\f(CW\*(C`\-\*(C'\fR\fIoption\fR are equivalent, and an \f(CW\*(C`=\*(C'\fR is optional between an option
 name and its value.
-.IP "\fB\-\-location\fR \fIlocation\fR" 4
-.IX Item "--location location"
-Specifies the location from which packages should be installed or
-updated, overriding the location found in the installation's TeX Live
-Package Database (\s-1TLPDB\s0).  The documentation for \f(CW\*(C`install\-tl\*(C'\fR has more
-details about this.
+.IP "\fB\-\-repo[sitory]\fR \fIurl|path\fR" 4
+.IX Item "--repo[sitory] url|path"
+.PD 0
+.IP "\fB\-\-location\fR \fIurl|path\fR" 4
+.IX Item "--location url|path"
+.PD
+Specifies the package repository from which packages should be 
+installed or updated, overriding the default package repository
+found in the installation's TeX Live Package Database (\s-1TLPDB\s0).  
+The documentation for \f(CW\*(C`install\-tl\*(C'\fR has more details about this.
 .IP "\fB\-\-gui\fR [\fIaction\fR]" 4
 .IX Item "--gui [action]"
 You can give this option together with an action to be brought directly
@@ -488,7 +492,7 @@ Possible values for \fIkey\fR are (but see \fBtlmgr option showall\fR for
 the definitive list):
 .PP
 .Vb 9
-\& location (default installation source),
+\& location (default package repository),
 \& formats (create formats at installation time),
 \& docfiles (install documentation files),
 \& srcfiles (install source files),
@@ -620,7 +624,7 @@ those extra settings at present.
 .Sh "arch list|add|remove \fIarch\fP..."
 .IX Subsection "arch list|add|remove 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.
+(\f(CW\*(C`i386\-linux\*(C'\fR, ...) available at the package repository.
 .PP
 \&\f(CW\*(C`arch add\*(C'\fR \fIarch\fR... adds the executables for each given architecture
 \&\fIarch\fR to the installation. 
@@ -661,8 +665,8 @@ dependencies.  When given with schemes and collections, \f(CW\*(C`\-\-list\*(C'\
 outputs their dependencies in a similar way.
 .Sh "list [\-\-only\-installed] [collections|schemes|\fIpkg\fP...]"
 .IX Subsection "list [--only-installed] [collections|schemes|pkg...]"
-With no argument, lists all packages available at the default install
-location, prefixing those already installed with \f(CW\*(C`i\*(C'\fR.
+With no argument, lists all packages available at the package repository,
+prefixing those already installed with \f(CW\*(C`i\*(C'\fR.
 .PP
 With the single word \f(CW\*(C`collections\*(C'\fR or \f(CW\*(C`schemes\*(C'\fR as the argument, lists
 the request type.
@@ -819,13 +823,16 @@ messages for human consumption are written to stderr (normally they are
 written to stdout).  The idea is that a program can get all the
 information it needs by reading stdout.
 .PP
-Currently this option only applies to the update action.  The output format is as follows:
+Currently this option only applies to the 
+update and 
+install actions.  
+The output format is as follows:
 .PP
 .Vb 7
 \&  fieldname "\et" value
 \&  ...
 \&  "end-of-header"
-\&  pkgname status localrev serverrev size
+\&  pkgname status localrev serverrev size estrem esttot
 \&  ...
 \&  "end-of-updates"
 \&  other output from post actions, not in machine readable form
@@ -836,18 +843,20 @@ repository source from which updates are being drawn), and
 \&\f(CW\*(C`total\-bytes\*(C'\fR (the total number of bytes to be downloaded).
 .PP
 The \fIlocalrev\fR and \fIserverrev\fR fields for each package are the
-revision numbers in the location installation and server repository,
+revision numbers in the local installation and server repository,
 respectively.  The \fIsize\fR field is the number of bytes to be
 downloaded, i.e., the size of the compressed tar file for a network
-installation, not the unpacked size.
+installation, not the unpacked size. The estrem and esttot fields 
+are only present for updated and auto-install packages, and contain
+the estimated remaining time and the estimated total time.
 .PP
 Line endings may be either \s-1LF\s0 or \s-1CRLF\s0 depending on the current platform.
 .ie n .IP """location\-url""\fR \fIlocation" 4
 .el .IP "\f(CWlocation\-url\fR \fIlocation\fR" 4
 .IX Item "location-url location"
 The \fIlocation\fR may be a url (including \f(CW\*(C`file:///foo/bar/...\*(C'\fR), or a
-directory name (\f(CW\*(C`/foo/bar\*(C'\fR).  It is the server repository from which
-the new package information was drawn.
+directory name (\f(CW\*(C`/foo/bar\*(C'\fR).  It is the use package repository
+from which the new package information was drawn.
 .ie n .IP """total\-bytes""\fR \fIcount" 4
 .el .IP "\f(CWtotal\-bytes\fR \fIcount\fR" 4
 .IX Item "total-bytes count"
@@ -892,6 +901,15 @@ version on the server.
 .IX Item "a"
 Automatically-determined need for installation, the package is new on
 the server and is (most probably) part of an installed collection.
+.ie n .IP """i""" 8
+.el .IP "\f(CWi\fR" 8
+.IX Item "i"
+Package will be installed and isn't present in the local installation
+(action install).
+.ie n .IP """I""" 8
+.el .IP "\f(CWI\fR" 8
+.IX Item "I"
+Package is already present but will be reinstalled (action install).
 .RE
 .RS 4
 .RE
@@ -907,6 +925,12 @@ present on the server.
 .IX Item "size"
 The size in bytes of the package on the server.  The sum of all the
 package sizes is given in the \f(CW\*(C`total\-bytes\*(C'\fR header field mentioned above.
+.IP "\fIestrem\fR" 4
+.IX Item "estrem"
+The estimated remaining time.
+.IP "\fIesttot\fR" 4
+.IX Item "esttot"
+The estimated total time.
 .PP
 If you are developing a program that uses this output, and find that
 changes would be helpful, do not hesitate to write the mailing list.