summaryrefslogtreecommitdiff
path: root/Master/texmf
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-01-09 02:25:20 +0000
committerKarl Berry <karl@freefriends.org>2010-01-09 02:25:20 +0000
commit1a3e4e82c7adf1f9b2d8fe8a210915b102265ec9 (patch)
treec06e4350558c7e3699f7190ea38387e7bd6103df /Master/texmf
parent6cc09b6f974471c8c85962bba8a1ba9eb87c463b (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@16647 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf')
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.155
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.man1.pdfbin52940 -> 53781 bytes
2 files changed, 37 insertions, 18 deletions
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index 1af20caf69a..f0bcbd35709 100644
--- a/Master/texmf/doc/man/man1/tlmgr.1
+++ b/Master/texmf/doc/man/man1/tlmgr.1
@@ -124,7 +124,7 @@
.\" ========================================================================
.\"
.IX Title "TLMGR 1"
-.TH TLMGR 1 "2010-01-04" "perl v5.10.1" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2010-01-09" "perl v5.10.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -814,12 +814,12 @@ The \f(CW\*(C`generate\*(C'\fR action overwrites any manual changes made in the
respective files: it recreates them from scratch.
.PP
For \f(CW\*(C`fmtutil\*(C'\fR and the language files, this is normal, and both the TeX
-Live installer and \f(CW\*(C`tlmgr\*(C'\fR routinely call \fIgenerate\fR for them.
+Live installer and \f(CW\*(C`tlmgr\*(C'\fR routinely call \f(CW\*(C`generate\*(C'\fR for them.
.PP
For \f(CW\*(C`updmap\*(C'\fR, however, \f(CW\*(C`tlmgr\*(C'\fR does \fInot\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. The \fIgenerate\fR action only incorporates
+proprietary or local fonts. The \f(CW\*(C`generate\*(C'\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
@@ -852,7 +852,7 @@ Local files specify entries to be disabled with a comment line like this:
.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
+format name, map file name (include the \f(CW\*(C`.map\*(C'\fR extension), or
hyphenation pattern identifier. Examples:
.PP
.Vb 3
@@ -865,7 +865,9 @@ hyphenation pattern identifier. Examples:
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.
+for the same item, if a different definition is desired. In general,
+except for the special disabling lines, the local files follow the same
+syntax as the master files.
.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 recreates only
@@ -878,7 +880,11 @@ this file specifies the setting of five options: \f(CW\*(C`dvipsPreferOutline\*(
\&\f(CW\*(C`updmap\-hdr.cfg\*(C'\fR are usually fine. If you want to change them, you can
include changed settings for any or all of these five options in your
\&\f(CW\*(C`updmap\-local.cfg\*(C'\fR file and they will be respected by \f(CW\*(C`generate
-updmap\*(C'\fR.
+updmap\*(C'\fR, for example:
+.PP
+.Vb 1
+\& dvipsDownloadBase35 true
+.Ve
.PP
Options:
.IP "\fB\-\-dest\fR \fIoutput file\fR" 4
@@ -894,6 +900,19 @@ output file, we recommend invoking \f(CW\*(C`tlmgr\*(C'\fR twice.)
.IX Item "--localcfg local conf file"
specifies the (optional) local additions (defaults to the respective
location in \f(CW\*(C`TEXMFLOCAL\*(C'\fR).
+.IP "\fB\-\-rebuild\-sys\fR" 4
+.IX Item "--rebuild-sys"
+tells tlmgr to run necessary programs after config files have been
+regenerated. These are: \f(CW\*(C`updmap\-sys\*(C'\fR after \f(CW\*(C`generate updmap\*(C'\fR,
+\&\f(CW\*(C`fmtutil\-sys \-\-all\*(C'\fR after \f(CW\*(C`generate fmtutil\*(C'\fR,
+\&\f(CW\*(C`fmtutil\-sys \-\-byhyphen .../language.dat\*(C'\fR after \f(CW\*(C`generate language.dat\*(C'\fR,
+and
+\&\f(CW\*(C`fmtutil\-sys \-\-byhyphen .../language.def\*(C'\fR after \f(CW\*(C`generate language.def\*(C'\fR.
+.Sp
+These subsequent calls cause the newly-generated files to actually take
+effect. This is not done by default since those calls are lengthy
+processes and one might want to made several related changes in
+succession before invoking these programs.
.PP
The respective locations are as follows:
.PP
@@ -936,25 +955,25 @@ the repository specified on the command line, and an arbitrary other one.
Furthermore is allows to quit \f(CW\*(C`tlmgr\*(C'\fR.
.IP "\fBOptions\fR" 4
.IX Item "Options"
-Provides access to three groups of options, \fBGeneral\fR (for almost all
-options), \fBPaper\fR (configuration of default paper sizes),
-\&\fBArchitectures\fR (only on Unix, configuration of the supported/installed
-architectures), as well as a toggle to turn on and off Debug mode.
+Provides access to three groups of options, \fIGeneral\fR (for almost all
+options), \fIPaper\fR (configuration of default paper sizes),
+\&\fIArchitectures\fR (only on Unix, configuration of the supported/installed
+architectures), as well as a toggle to turn on and off debugging mode.
.IP "\fBActions\fR" 4
.IX Item "Actions"
-Provides access to some useful items, like updating the filename database
-(ls-R, mktexlsr, texhash), rebuilding of all formats (fmtutil-sys \-\-all),
-updating the font map database (updmap-sys), and handling of symbolic
-links in system directories (only Unix), as well as removal of the
-full TeX Live installation (only Unix).
+Provides access to a variety of items, such as updating the filename
+database (aka ls-R, mktexlsr, texhash), rebuilding of all formats
+(\f(CW\*(C`fmtutil\-sys \-\-all\*(C'\fR), updating the font map database (\f(CW\*(C`updmap\-sys\*(C'\fR),
+and handling of symbolic links in system directories (only Unix), as
+well as removal of the full TeX Live installation (only Unix).
.IP "\fBHelp\fR" 4
.IX Item "Help"
Currently only gives basic information on the installed version, authors,
license.
.SS "Main display"
.IX Subsection "Main display"
-The main display lists all packages, installed and \- if a repository is
-loaded \- also those that are available but not installed.
+The main display lists all packages, installed and, if a repository is
+loaded, also those that are available but not installed.
.PP
Each line of the package list contains of the following items:
.IP "a checkbox" 4
@@ -1031,7 +1050,7 @@ packages).
.IP "Backup" 4
.IX Item "Backup"
makes a backup of the selected packages, acts like \f(CW\*(C`tlmgr backup\*(C'\fR. This
-action needs the options \fBbackupdir\fR set (see Options \-> General).
+action needs the option \f(CW\*(C`backupdir\*(C'\fR set (see Options \-> General).
.PP
Finally, the status area at the bottom of the window gives additional
information what is going on.
diff --git a/Master/texmf/doc/man/man1/tlmgr.man1.pdf b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
index 46b447b50c0..b1f76f5efd9 100644
--- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
Binary files differ