summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/updmap.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/updmap.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/updmap.181
1 files changed, 33 insertions, 48 deletions
diff --git a/Master/texmf-dist/doc/man/man1/updmap.1 b/Master/texmf-dist/doc/man/man1/updmap.1
index 32a750f63a0..5bc81acc69d 100644
--- a/Master/texmf-dist/doc/man/man1/updmap.1
+++ b/Master/texmf-dist/doc/man/man1/updmap.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.43.3.
-.TH UPDMAP "1" "August 2013" "TeX Live" "User Commands"
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.40.9.
+.TH UPDMAP "1" "August 2012" "TeX Live" "User Commands"
.SH NAME
updmap \- manage TeX font maps, per-user
.br
@@ -11,7 +11,7 @@ updmap-sys \- manage TeX font maps, system-wide
.B updmap-sys
[\fIOPTION\fR] ... [\fICOMMAND\fR]
.SH DESCRIPTION
-updmap (TeX Live, multi) version $Id: updmap.pl 31440 2013\-08\-15 22:39:10Z karl $
+updmap (TeX Live, multi) version $Id: updmap.pl 27264 2012\-07\-31 05:10:29Z preining $
.PP
Update the default font map files used by pdftex, dvips, and dvipdfm(x),
and optionally pxdvi, as determined by all configuration files updmap.cfg
@@ -21,12 +21,6 @@ Among other things, these map files are used to determine which fonts
should be used as bitmaps and which as outlines, and to determine which
font files are included in the PDF or PostScript output.
.PP
-updmap\-sys is intended to affect the system\-wide configuration, while
-updmap affects personal configuration files only, overriding the system
-files. As a consequence, once updmap has been run, even a single time,
-running updmap\-sys no longer has any effect. (updmap\-sys issues a
-warning in this situation.)
-.PP
By default, the TeX filename database (ls\-R) is also updated.
.SH OPTIONS
.TP
@@ -62,9 +56,6 @@ do not recreate map files
\fB\-\-nohash\fR
do not run texhash
.TP
-\fB\-\-sys\fR
-affect system\-wide files (equivalent to updmap\-sys)
-.TP
\fB\-n\fR, \fB\-\-dry\-run\fR
only show the configuration, no output
.TP
@@ -124,22 +115,22 @@ KanjiMap entries are added to psfonts_t1.map and kanjix.map.
Explanation of the OPTION names for \fB\-\-showoptions\fR, \fB\-\-showoption\fR, \fB\-\-setoption\fR:
.TP
dvipsPreferOutline
-true,false (default true)
+true|false (default true)
.IP
Whether dvips uses bitmaps or outlines, when both are available.
.TP
dvipsDownloadBase35
-true,false (default true)
+true|false (default true)
.IP
Whether dvips includes the standard 35 PostScript fonts in its output.
.TP
pdftexDownloadBase14
-true,false (default true)
+true|false (default true)
.IP
Whether pdftex includes the standard 14 PDF fonts in its output.
.TP
pxdviUse
-true,false (default false)
+true|false (default false)
.IP
Whether maps for pxdvi (Japanese\-patched xdvi) are under updmap's control.
.TP
@@ -152,24 +143,13 @@ kanjiVariant
See below.
.TP
LW35
-URWkb,URW,ADOBEkb,ADOBE (default URWkb)
+URWkb|URW|ADOBEkb|ADOBE (default URWkb)
.IP
Adapt the font and file names of the standard 35 PostScript fonts.
-.nf
-.TP
-URWkb
-URW fonts with "berry" filenames (e.g. uhvbo8ac.pfb)
-.TP
-URW
-URW fonts with "vendor" filenames (e.g. n019064l.pfb)
-.fi
-.TP
-ADOBEkb
-Adobe fonts with "berry" filenames (e.g. phvbo8an.pfb)
-.TP
-ADOBE
-Adobe fonts with "vendor" filenames (e.g. hvnbo___.pfb)
-.fi
+URWkb URW fonts with "berry" filenames (e.g. uhvbo8ac.pfb)
+URW URW fonts with "vendor" filenames (e.g. n019064l.pfb)
+ADOBEkb Adobe fonts with "berry" filenames (e.g. phvbo8an.pfb)
+ADOBE Adobe fonts with "vendor" filenames (e.g. hvnbo___.pfb)
.IP
These options are only read and acted on by updmap; dvips, pdftex, etc.,
do not know anything about them. They work by changing the default map
@@ -189,7 +169,10 @@ Explanation of trees and files normally used:
If \fB\-\-cnffile\fR is specified on the command line (possibly multiple
times), its value(s) are used. Otherwise, updmap reads all the
updmap.cfg files found by running `kpsewhich \fB\-all\fR updmap.cfg', in the
-order returned by kpsewhich.
+order returned by kpsewhich, with one exception: an updmap.cfg found
+in TEXMFLOCAL is given higher priority than the updmap.cfg in
+TEXMFMAIN, to ensure that local adjustments by administrators take
+precedence over what is shipped in TeX Live.
.IP
In any case, if multiple updmap.cfg files are found, all the maps
mentioned in all the updmap.cfg files are merged.
@@ -200,24 +183,26 @@ read, in the given order.
.nf
.IP
For updmap\-sys:
-TEXMFSYSCONFIG \fI$TEXLIVE/YYYY/texmf\-config/web2c/updmap.cfg\fP
-TEXMFSYSVAR \fI$TEXLIVE/YYYY/texmf\-var/web2c/updmap.cfg\fP
-TEXMFLOCAL \fI$TEXLIVE/texmf\-local/web2c/updmap.cfg\fP
-TEXMFDIST \fI$TEXLIVE/YYYY/texmf\-dist/web2c/updmap.cfg\fP
+TEXMFSYSCONFIG $TEXLIVE/YYYY/texmf\-config/web2c/updmap.cfg
+TEXMFSYSVAR $TEXLIVE/YYYY/texmf\-var/web2c/updmap.cfg
+TEXMFLOCAL $TEXLIVE/texmf\-local/web2c/updmap.cfg
+TEXMFMAIN $TEXLIVE/YYYY/texmf/web2c/updmap.cfg
+TEXMFDIST $TEXLIVE/YYYY/texmf\-dist/web2c/updmap.cfg
.IP
For updmap:
TEXMFCONFIG $HOME/.texliveYYYY/texmf\-config/web2c/updmap.cfg
TEXMFVAR $HOME/.texliveYYYY/texmf\-var/web2c/updmap.cfg
-TEXMFHOME \fI$HOME/texmf/web2c/updmap.cfg\fP
-TEXMFSYSCONFIG \fI$TEXLIVE/YYYY/texmf\-config/web2c/updmap.cfg\fP
-TEXMFSYSVAR \fI$TEXLIVE/YYYY/texmf\-var/web2c/updmap.cfg\fP
-TEXMFLOCAL \fI$TEXLIVE/texmf\-local/web2c/updmap.cfg\fP
-TEXMFDIST \fI$TEXLIVE/YYYY/texmf\-dist/web2c/updmap.cfg\fP
+TEXMFHOME $HOME/texmf/web2c/updmap.cfg
+TEXMFSYSCONFIG $TEXLIVE/YYYY/texmf\-config/web2c/updmap.cfg
+TEXMFSYSVAR $TEXLIVE/YYYY/texmf\-var/web2c/updmap.cfg
+TEXMFLOCAL $TEXLIVE/texmf\-local/web2c/updmap.cfg
+TEXMFMAIN $TEXLIVE/YYYY/texmf/web2c/updmap.cfg
+TEXMFDIST $TEXLIVE/YYYY/texmf\-dist/web2c/updmap.cfg
.IP
(where YYYY is the TeX Live release version).
.fi
.IP
-There is one exception to keep upgradability from earlier versions
+There is another exception to keep upgradability from earlier versions
of TeX Live: if a file TEXMFLOCAL/web2c/updmap\-local.cfg exists
(formerly used by tlmgr to merge local fonts), then the file
TEXMFLOCAL/web2c/updmap.cfg is ignored (if it exists) and that
@@ -233,13 +218,13 @@ line, then the first one given will be used to save any changes from
\fB\-\-setoption\fR, \fB\-\-enable\fR or \fB\-\-disable\fR. If the config files are taken
from kpsewhich output, then the algorithm is more complex:
.IP
-1) If \fI$TEXMFCONFIG/web2c/updmap.cfg\fP or \fI$TEXMFHOME/web2c/updmap.cfg\fP
+1) If $TEXMFCONFIG/web2c/updmap.cfg or $TEXMFHOME/web2c/updmap.cfg
appears in the list of used files, then the one listed first by
kpsewhich \fB\-\-all\fR (equivalently, the one returned by kpsewhich
updmap.cfg), is used.
.IP
2) If neither of the above two are present and changes are made, a
-new config file is created in \fI$TEXMFCONFIG/web2c/updmap.cfg\fP.
+new config file is created in $TEXMFCONFIG/web2c/updmap.cfg.
.IP
Resolving multiple definitions of a font:
.IP
@@ -265,7 +250,7 @@ in the higher\-priority updmap.cfg file.
As an example, suppose you have a copy of MathTime Pro fonts
and want to disable the Belleek version of the fonts; that is,
disable the map belleek.map. You can create the file
-\fI$TEXMFCONFIG/web2c/updmap.cfg\fP with the content
+$TEXMFCONFIG/web2c/updmap.cfg with the content
.IP
#! Map belleek.map
Map mt\-plus.map
@@ -292,12 +277,12 @@ will be read and written, give the \fB\-n\fR option (or read the source).
.PP
For step\-by\-step instructions on making new fonts known to TeX, read
http://tug.org/fonts/fontinstall.html. For even more terse
-instructions, read the beginning of the main updmap.cfg.
+instructions, read the beginning of updmap.cfg.
.SH FILES
Configuration and input files:
.IP "\fIupdmap\&.cfg\fP"
Main configuration file\&. In
-\fItexmf-dist/web2c\fP by default, but may be located elsewhere
+\fItexmf/web2c\fP by default, but may be located elsewhere
depending on your distribution\&. Each texmf tree read should have its
own \fIupdmap.cfg\fP.
.IP "\fIdvips35\&.map\fP"