summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-05-14 02:45:38 +0000
committerKarl Berry <karl@freefriends.org>2012-05-14 02:45:38 +0000
commit2ed976d9ff321dd440b14861d284ea3e3d8c5b78 (patch)
treef7ae51fc862f333d3d963c26ec833e124b22e4aa /Master/texmf/doc/man/man1
parent27ab55efa67190aaf7f577eaa27e76e76dbbc940 (diff)
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@26350 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man/man1')
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.190
-rw-r--r--Master/texmf/doc/man/man1/tlmgr.man1.pdfbin74282 -> 72400 bytes
2 files changed, 28 insertions, 62 deletions
diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1
index af73abf13ae..2c9e8856741 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 "2012-05-09" "perl v5.14.2" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2012-05-13" "perl v5.14.2" "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
@@ -662,7 +662,6 @@ the definitive list):
\& sys_bin (directory to which executables are linked by the path action)
\& sys_man (directory to which man pages are linked by the path action)
\& sys_info (directory to which Info files are linked by the path action)
-\& generate_updmap (run the equivalent of tlmgr generate updmap on changes)
\& desktop_integration (Windows\-only: create Start menu shortcuts)
\& fileassocs (Windows\-only: change file associations)
\& multiuser (Windows\-only: install for all users)
@@ -725,9 +724,6 @@ The \f(CW\*(C`sys_bin\*(C'\fR, \f(CW\*(C`sys_man\*(C'\fR, and \f(CW\*(C`sys_info
Unix-like systems to control the generation of links for executables,
info files and man pages. See the \f(CW\*(C`path\*(C'\fR action for details.
.PP
-For the \f(CW\*(C`generate_updmap\*(C'\fR option, see the \f(CW\*(C`updmap\*(C'\fR section in
-generate.
-.PP
The last three options control behaviour on Windows installations. If
\&\f(CW\*(C`desktop_integration\*(C'\fR is set, then some packages will install items in
a sub-folder of the Start menu for \f(CW\*(C`tlmgr gui\*(C'\fR, documentation, etc. If
@@ -1049,31 +1045,20 @@ Do not ask for confirmation, remove immediately.
.PD
.PP
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 \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 by default,
-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, which has been the standard method for adding fonts to TeX
-installations for years. Rather, the \f(CW\*(C`generate\*(C'\fR action only
-incorporates the changes in the \f(CW\*(C`\-\-localcfg\*(C'\fR file mentioned below.
-.PP
-Notwithstanding the above, if you only use the fonts and font packages
-within TeX Live, and rigorously 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. It can be helpful in moving from release to release,
-especially. We use it ourselves to generate the \f(CW\*(C`updmap.cfg\*(C'\fR file in
-the live source repository. If you want to commit yourself to using
-\&\f(CW\*(C`updmap\-local.cfg\*(C'\fR, you can set the \f(CW\*(C`generate_updmap\*(C'\fR option and
-\&\f(CW\*(C`tlmgr\*(C'\fR will run \f(CW\*(C`generate updmap\*(C'\fR for you on update.
-.PP
-In any case, \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 generated 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) historically uses.
+respective files: it recreates them from scratch based on the
+information of the installed packages, plus local adaptions.
+.PP
+The TeX Live installer and \f(CW\*(C`tlmgr\*(C'\fR routinely call \f(CW\*(C`generate\*(C'\fR for
+all of these files.
+.PP
+For managing your own fonts, please see the documentation of
+updmap, which supports multiple updmap.cfg files. So by simply
+editing \s-1TEXMFLOCAL\s0's updmap.cfg they will be accounted for.
+.PP
+In any case, \f(CW\*(C`tlmgr\*(C'\fR updates and maintains \f(CW\*(C`updmap.cfg\*(C'\fR in
+\&\f(CW\*(C`TEXMFDIST\*(C'\fR (while the other generated files are in
+\&\f(CW\*(C`TEXMFSYSVAR\*(C'\fR), because that is the location where the fonts
+are installed.
.PP
In more detail: \f(CW\*(C`generate\*(C'\fR remakes any of the five config files
\&\f(CW\*(C`language.dat\*(C'\fR, \f(CW\*(C`language.def\*(C'\fR, \f(CW\*(C`language.dat.lua\*(C'\fR, \f(CW\*(C`fmtutil.cnf\*(C'\fR,
@@ -1081,29 +1066,30 @@ and \f(CW\*(C`updmap.cfg\*(C'\fR from the information present in the local \s-1T
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`language\-local.dat.lua\*(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
+\&\f(CW\*(C`language\-local.def\*(C'\fR, \f(CW\*(C`language\-local.dat.lua\*(C'\fR, or \f(CW\*(C`fmtutil\-local.cnf\*(C'\fR,
+searched for in \f(CW\*(C`TEXMFLOCAL\*(C'\fR in the respective directories.
+The formerly supported \f(CW\*(C`updmap\-local.cfg\*(C'\fR is not supported anymore,
+since \f(CW\*(C`updmap\*(C'\fR now supports multiple updmap.cfg files, so local
+additions can be put into an updmap.cfg file in \s-1TEXMFLOCAL\s0.
+If local additions 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, namely
one of these:
.PP
-.Vb 3
-\& #!NAME
+.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, \f(CW\*(C`language.dat\*(C'\fR and
+where \f(CW\*(C`fmtutil.cnf\*(C'\fR uses \f(CW\*(C`#\*(C'\fR, \f(CW\*(C`language.dat\*(C'\fR and
\&\f(CW\*(C`language.def\*(C'\fR use \f(CW\*(C`%\*(C'\fR, and \f(CW\*(C`language.dat.lua\*(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:
+case, the \fIname\fR is the respective format name, or hyphenation pattern
+identifier. Examples:
.PP
-.Vb 4
+.Vb 3
\& #!pdflatex
-\& #!lm.map
\& %!german
\& \-\-!usenglishmax
.Ve
@@ -1117,27 +1103,14 @@ 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, the
-\&\f(CW\*(C`language.def\*(C'\fR and the \f(CW\*(C`language.dat.lua\*(C'\fRfiles, while the forms with
+\&\f(CW\*(C`language.def\*(C'\fR and the \f(CW\*(C`language.dat.lua\*(C'\fR files, while the forms with
extension recreates only the given language file.
.PP
-Special consideration for updmap.cfg: in addition to font map files,
-this file specifies the setting of five options: \f(CW\*(C`dvipsPreferOutline\*(C'\fR,
-\&\f(CW\*(C`LW35\*(C'\fR, \f(CW\*(C`dvipsDownloadBase35\*(C'\fR, \f(CW\*(C`pdftexDownloadBase14\*(C'\fR, and
-\&\f(CW\*(C`dvipdfmDownloadBase14\*(C'\fR. The defaults for these as set in
-\&\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. For example:
-.PP
-.Vb 1
-\& dvipsDownloadBase35 true
-.Ve
-.PP
Options:
.IP "\fB\-\-dest\fR \fIoutput_file\fR" 4
.IX Item "--dest output_file"
specifies the output file (defaults to the respective location in
-\&\f(CW\*(C`TEXMFSYSVAR\*(C'\fR for \f(CW\*(C`language*\*(C'\fR and \f(CW\*(C`fmtutil\*(C'\fR, and \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR
+\&\f(CW\*(C`TEXMFSYSVAR\*(C'\fR for \f(CW\*(C`language*\*(C'\fR and \f(CW\*(C`fmtutil\*(C'\fR, and \f(CW\*(C`TEXMFSYSDIST\*(C'\fR
for \f(CW\*(C`updmap\*(C'\fR). If \f(CW\*(C`\-\-dest\*(C'\fR is given to \f(CW\*(C`generate language\*(C'\fR, it serves
as a basename onto which \f(CW\*(C`.dat\*(C'\fR will be appended for the name of the
\&\f(CW\*(C`language.dat\*(C'\fR output file, \f(CW\*(C`.def\*(C'\fR will be
@@ -1172,13 +1145,6 @@ The respective locations are as follows:
\& web2c/fmtutil.cnf (and fmtutil\-local.cnf);
\& web2c/updmap.cfg (and updmap\-local.cfg).
.Ve
-.PP
-Final repetition: as explained above, \f(CW\*(C`tlmgr\*(C'\fR does \fInot\fR use
-\&\f(CW\*(C`generate updmap\*(C'\fR for font map files. Therefore, if you want to make
-use of \f(CW\*(C`updmap\-local.cfg\*(C'\fR, you must run \f(CW\*(C`tlmgr generate updmap\*(C'\fR
-and \f(CW\*(C`updmap\-sys\*(C'\fR yourself after making any local changes. If you
-make yourself responsible for rigorously using \f(CW\*(C`updmap\-local.cfg\*(C'\fR), set
-\&\f(CW\*(C`option generate_updmap\*(C'\fR).
.SH "TLMGR CONFIGURATION FILE"
.IX Header "TLMGR CONFIGURATION FILE"
A small subset of the command line options can be set in a config file
diff --git a/Master/texmf/doc/man/man1/tlmgr.man1.pdf b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
index 4f9cbf2fa51..bf271ce729e 100644
--- a/Master/texmf/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf/doc/man/man1/tlmgr.man1.pdf
Binary files differ