summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-08-17 02:34:18 +0000
committerKarl Berry <karl@freefriends.org>2009-08-17 02:34:18 +0000
commitbcbe1934257fd2cc4758acd98bd0012edfd94231 (patch)
tree6ea2d3f7e376f05d00b6e5d812e3b87b7ab749d6
parent681df3b59a3cd229e9aac32d35c8d4536655d875 (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@14720 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf/doc/man/man1/asy.pdfbin11007 -> 11139 bytes
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.176
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.pdfbin39223 -> 40321 bytes
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
Binary files differ
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
Binary files differ