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

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

3 files changed, 56 insertions, 20 deletions

diff --git a/Master/texmf/doc/man/man1/asy.pdf b/Master/texmf/doc/man/man1/asy.pdf
index c2e24905568..2a9e3953ce2 100644
--- a/Master/texmf/doc/man/man1/asy.pdf
+++ b/Master/texmf/doc/man/man1/asy.pdf
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index 7edda19155f..df28c7769ad 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-13" "perl v5.8.8" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2009-08-17" "perl v5.8.8" "User Contributed Perl Documentation"
 .SH "NAME"
 tlmgr \- the TeX Live Manager
 .SH "SYNOPSIS"
@@ -714,29 +714,57 @@ Live installer and \f(CW\*(C`tlmgr\*(C'\fR routinely call \fIgenerate\fR for the
 For \f(CW\*(C`updmap\*(C'\fR, however, neither the installer nor \f(CW\*(C`tlmgr\*(C'\fR use
 \&\f(CW\*(C`generate\*(C'\fR, because the result would be to disable all maps which have
 been manually installed via \f(CW\*(C`updmap\-sys\ \-\-enable\*(C'\fR, e.g., for
-proprietary or local fonts.  Only the changes in the \f(CW\*(C`\-\-localcfg\*(C'\fR file
-mentioned below are incorporated by \fIgenerate\fR.  Furthermore, \f(CW\*(C`tlmgr\*(C'\fR
-updates and maintains the final \f(CW\*(C`updmap.cfg\*(C'\fR in \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR (the
-others use \f(CW\*(C`TEXMFSYSVAR\*(C'\fR) because that is the location that
-\&\f(CW\*(C`updmap\-sys\*(C'\fR (via \f(CW\*(C`tcfmgr\*(C'\fR) uses.
+proprietary or local fonts.  The \fIgenerate\fR action only incorporates
+the changes in the \f(CW\*(C`\-\-localcfg\*(C'\fR file mentioned below.  Furthermore,
+\&\f(CW\*(C`tlmgr\*(C'\fR updates and maintains the final \f(CW\*(C`updmap.cfg\*(C'\fR in
+\&\f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR (while the other files are in \f(CW\*(C`TEXMFSYSVAR\*(C'\fR), because
+that is the location that \f(CW\*(C`updmap\-sys\*(C'\fR (via \f(CW\*(C`tcfmgr\*(C'\fR) uses.
 .PP
 Notwithstanding the above, if you only use the fonts and font packages
-within TeX Live, and maintain your local fonts (if any) with the local
-config file, there is nothing wrong with using \f(CW\*(C`generate updmap\*(C'\fR.
-Indeed, we use it ourselves to generate the \f(CW\*(C`updmap.cfg\*(C'\fR file that is
-maintained in the live source repository.
+within TeX Live, and maintain your local fonts (if any) using
+\&\f(CW\*(C`updmap\-local.cfg\*(C'\fR, there is nothing wrong with using \f(CW\*(C`generate
+updmap\*(C'\fR.  Indeed, we use it ourselves to generate the \f(CW\*(C`updmap.cfg\*(C'\fR file
+that is maintained in the live source repository.
 .PP
 In more detail: \f(CW\*(C`generate\*(C'\fR remakes any of the four config files
 \&\f(CW\*(C`language.dat\*(C'\fR, \f(CW\*(C`language.def\*(C'\fR, \f(CW\*(C`fmtutil.cnf\*(C'\fR, and \f(CW\*(C`updmap.cfg\*(C'\fR from
-the information present in the local \s-1TLPDB\s0. If the files
-\&\f(CW\*(C`language\-local.dat\*(C'\fR, \f(CW\*(C`language\-local.def\*(C'\fR, \f(CW\*(C`fmtutil\-local.cnf\*(C'\fR, or
-\&\f(CW\*(C`updmap\-local.cfg\*(C'\fR are present under \f(CW\*(C`TEXMFLOCAL\*(C'\fR in the respective
-directories, their contents will be simply merged into the final files,
-with no error checking of any kind.
+the information present in the local \s-1TLPDB\s0, plus locally-maintained
+files.
+.PP
+The locally-maintained files are \f(CW\*(C`language\-local.dat\*(C'\fR,
+\&\f(CW\*(C`language\-local.def\*(C'\fR, \f(CW\*(C`fmtutil\-local.cnf\*(C'\fR, or \f(CW\*(C`updmap\-local.cfg\*(C'\fR,
+searched for in \f(CW\*(C`TEXMFLOCAL\*(C'\fR in the respective directories.  If they
+are present, the final file is made by starting with the main file,
+omitting any entries that the local file specifies to be disabled, and
+finally appending the local file.
+.PP
+Local files specify entries to be disabled with a comment line like this:
+.PP
+.Vb 2
+\&  #!NAME
+\&  %!NAME
+.Ve
+.PP
+where \f(CW\*(C`fmtutil.cnf\*(C'\fR and \f(CW\*(C`updmap.cfg\*(C'\fR use \f(CW\*(C`#\*(C'\fR, and \f(CW\*(C`language.dat\*(C'\fR and
+\&\f(CW\*(C`language.def\*(C'\fR use \f(CW\*(C`%\*(C'\fR.  In any case, the \fIname\fR is the respective
+format name, map file name (include the \f(CW\*(C`.map\*(C'\fR extension),or
+hyphenation pattern identifier.  Examples:
+.PP
+.Vb 3
+\&  #!pdflatex
+\&  #!lm.map
+\&  %!german
+.Ve
+.PP
+(Of course, you're not likely to actually want to disable those
+particular items.  They're just examples.)
+.PP
+After such a disabling line, the local file can include another entry
+for the same item, if a different definition is desired.
 .PP
 The form \f(CW\*(C`generate language\*(C'\fR recreates both the \f(CW\*(C`language.dat\*(C'\fR and the
-\&\f(CW\*(C`language.def\*(C'\fR files, while the forms with extension only recreates
-the given file.
+\&\f(CW\*(C`language.def\*(C'\fR files, while the forms with extension recreates only
+the given language file.
 .PP
 Options:
 .IP "\fB\-\-dest\fR \fIoutput file\fR" 4
@@ -784,9 +812,17 @@ Currently this option only applies to the update action.  The output format is a
 \&  other output from post actions, not in machine readable form
 .Ve
 .PP
-Currently the header section contains two fields.  The field name and
-value are separated by a tab.  Line endings may be \s-1LF\s0 or \s-1CRLF\s0 depending
-on the current platform.
+The header section currently has two fields: \f(CW\*(C`location\-url\*(C'\fR (the
+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,
+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.
+.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"
diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf
index b91a5ea5c49..604d7fde34e 100644
--- a/Master/texmf/doc/man/man1/tlmgr.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.pdf