summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/updmap.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/updmap.1')
-rw-r--r--Master/texmf/doc/man/man1/updmap.1360
1 files changed, 0 insertions, 360 deletions
diff --git a/Master/texmf/doc/man/man1/updmap.1 b/Master/texmf/doc/man/man1/updmap.1
deleted file mode 100644
index 41b80248ec3..00000000000
--- a/Master/texmf/doc/man/man1/updmap.1
+++ /dev/null
@@ -1,360 +0,0 @@
-.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.40.10.
-.TH UPDMAP "1" "June 2012" "TeX Live" "User Commands"
-.SH NAME
-updmap \- manage TeX font maps, per-user
-.br
-updmap-sys \- manage TeX font maps, system-wide
-.SH SYNOPSIS
-.B updmap
-[\fIOPTION\fR] ... [\fICOMMAND\fR]
-.br
-.B updmap-sys
-[\fIOPTION\fR] ... [\fICOMMAND\fR]
-.SH DESCRIPTION
-updmap (TeX Live, multi) version $Id: updmap.pl 26891 2012\-06\-10 22:41:49Z karl $
-.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
-(the ones returned by running "kpsewhich \fB\-\-all\fR updmap.cfg", but see below).
-.PP
-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
-By default, the TeX filename database (ls\-R) is also updated.
-.SH OPTIONS
-.TP
-\fB\-\-cnffile\fR FILE
-read FILE for the updmap configuration
-(can be given multiple times, in which case
-all the files are used)
-.TP
-\fB\-\-dvipdfmxoutputdir\fR DIR
-specify output directory (dvipdfm(x) syntax)
-.TP
-\fB\-\-dvipsoutputdir\fR DIR
-specify output directory (dvips syntax)
-.TP
-\fB\-\-pdftexoutputdir\fR DIR
-specify output directory (pdftex syntax)
-.TP
-\fB\-\-pxdvioutputdir\fR DIR
-specify output directory (pxdvi syntax)
-.TP
-\fB\-\-outputdir\fR DIR
-specify output directory (for all files)
-.TP
-\fB\-\-copy\fR
-cp generic files rather than using symlinks
-.TP
-\fB\-\-force\fR
-recreate files even if config hasn't changed
-.TP
-\fB\-\-nomkmap\fR
-do not recreate map files
-.TP
-\fB\-\-nohash\fR
-do not run texhash
-.TP
-\fB\-n\fR, \fB\-\-dry\-run\fR
-only show the configuration, no output
-.TP
-\fB\-\-quiet\fR, \fB\-\-silent\fR
-reduce verbosity
-.SS "Commands:"
-.TP
-\fB\-\-help\fR
-show this message and exit
-.TP
-\fB\-\-version\fR
-show version information and exit
-.TP
-\fB\-\-showoption\fR OPTION
-show the current setting of OPTION
-.TP
-\fB\-\-showoptions\fR OPTION
-show possible settings for OPTION
-.TP
-\fB\-\-setoption\fR OPTION VALUE
-set OPTION to value; option names below
-.TP
-\fB\-\-setoption\fR OPTION=VALUE
-as above, just different syntax
-.TP
-\fB\-\-enable\fR MAPTYPE MAPFILE
-add "MAPTYPE MAPFILE" to updmap.cfg,
-where MAPTYPE is Map, MixedMap, or KanjiMap
-.TP
-\fB\-\-enable\fR Map=MAPFILE
-add "Map MAPFILE" to updmap.cfg
-.HP
-\fB\-\-enable\fR MixedMap=MAPFILE add "MixedMap MAPFILE" to updmap.cfg
-.HP
-\fB\-\-enable\fR KanjiMap=MAPFILE add "KanjiMap MAPFILE" to updmap.cfg
-.TP
-\fB\-\-disable\fR MAPFILE
-disable MAPFILE, of whatever type
-.TP
-\fB\-\-listmaps\fR
-list all active and inactive maps
-.TP
-\fB\-\-listavailablemaps\fR
-same as \fB\-\-listmaps\fR, but without
-unavailable map files
-.TP
-\fB\-\-syncwithtrees\fR
-disable unavailable map files in updmap.cfg
-.PP
-Explanation of the map types: the (only) difference between Map and
-MixedMap is that MixedMap entries are not added to psfonts_pk.map.
-The purpose is to help users with devices that render Type 1 outline
-fonts worse than mode\-tuned Type 1 bitmap fonts. So, MixedMap is used
-for fonts that are available as both Type 1 and Metafont.
-KanjiMap entries are added to psfonts_t1.map and kanjix.map.
-.PP
-Explanation of the OPTION names for \fB\-\-showoptions\fR, \fB\-\-showoptions\fR, \fB\-\-setoption\fR:
-.TP
-dvipsPreferOutline
-true|false (default true)
-.IP
-Whether dvips uses bitmaps or outlines, when both are available.
-.TP
-dvipsDownloadBase35
-true|false (default true)
-.IP
-Whether dvips includes the standard 35 PostScript fonts in its output.
-.TP
-pdftexDownloadBase14
-true|false (default true)
-.IP
-Whether pdftex includes the standard 14 PDF fonts in its output.
-.TP
-pxdviUse
-true|false (default false)
-.IP
-Whether maps for pxdvi (Japanese\-patched xdvi) are under updmap's control.
-.TP
-kanjiEmbed
-(any string)
-.TP
-kanjiVariant
-(any string)
-.IP
-See below.
-.TP
-LW35
-URWkb|URW|ADOBEkb|ADOBE (default URWkb)
-.IP
-Adapt the font and file names of the standard 35 PostScript fonts.
-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
-file which the programs read, so they can be overridden by specifying
-command\-line options or configuration files to the programs, as
-explained at the beginning of updmap.cfg.
-.IP
-The options kanjiEmbed and kanjiVariant specify special replacements
-in the map lines. If a map contains the string @kanjiEmbed@, then
-this will be replaced by the value of that option; similarly for
-kanjiVariant. In this way, users of Japanese TeX can select different
-fonts to be included in the final output.
-.SH ENVIRONMENT
-.PP
-Explanation of trees and files normally used:
-.IP
-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, 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.
-.IP
-Thus, if updmap.cfg files are present in all trees, and the default
-layout is used as shipped with TeX Live, the following files are
-read, in the given order.
-.nf
-.IP
-For updmap\-sys:
-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 $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 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
-updmap\-local.cfg is used instead. In this case, updmap recognizes the
-previous syntax for disabling map files in updmap\-local.cfg (this
-syntax is different from what is used now).
-.IP
-According to the actions, updmap might write to one of the given files
-or create a new updmap.cfg, described further below.
-.IP
-Where changes are saved: if config files are given on the command
-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 $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 $TEXMFCONFIG/web2c/updmap.cfg.
-.IP
-Resolving multiple definitions of a font:
-.IP
-If a font is defined in more than one map file, then the definition
-coming from the first\-listed updmap.cfg is used. If a font is
-defined multiple times within the same map file, one is chosen
-arbitrarily. In both cases a warning is issued.
-.IP
-Disabling maps:
-.IP
-updmap.cfg files with higher priority (listed earlier) can disable
-maps mentioned in lower priority (listed later) updmap.cfg files by
-writing, e.g.,
-.IP
-#! Map mapname.map
-.IP
-or
-.IP
-#! MixedMap mapname.map
-.IP
-in the higher\-priority updmap.cfg file.
-.IP
-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
-$TEXMFCONFIG/web2c/updmap.cfg with the content
-.IP
-#! Map belleek.map
-Map mt\-plus.map
-Map mt\-yy.map
-.IP
-and call updmap.
-.IP
-updmap writes the map files for dvips (psfonts.map) and pdftex
-(pdftex.map) to the TEXMFVAR/fonts/map/updmap/{dvips,pdftex}/
-directories.
-.IP
-The log file is written to TEXMFVAR/web2c/updmap.log.
-.IP
-When updmap\-sys is run, TEXMFSYSCONFIG and TEXMFSYSVAR are used
-instead of TEXMFCONFIG and TEXMFVAR, respectively. This is the only
-difference between updmap\-sys and updmap.
-.IP
-Other locations may be used if you give them on the command line, or
-these trees don't exist, or you are not using the original TeX Live.
-.IP
-To see the precise locations of the various files that
-will be read and written, give the \fB\-n\fR option (or read the source).
-.SH EXAMPLES
-.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 updmap.cfg.
-.SH FILES
-Configuration and input files:
-.IP "\fIupdmap\&.cfg\fP"
-Main configuration file\&. In
-\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"
-Map file for standard 35 PostScript fonts for
-use with \fBdvips\fP(1)\&.
-.IP "\fIpdftex35\&.map\fP"
-Map file for standard 35 PostScript fonts for
-use with \fBpdftex\fP(1)\&.
-.IP "\fIps2pk35\&.map\fP"
-Map file for standard 35 PostScript fonts for
-use with \fBps2pk\fP(1)\&.
-.PP
-Output files:
-.IP "\fIpsfonts\&.map\fP"
-For \fBdvips\fP(1)\&.
-Same as \fIpsfonts_t1\&.map\fP if option \fBdvipsPreferOutline\fP active,
-else as \fIpsfonts_pk\&.map\fP.
-.IP "\fIpsfonts_pk\&.map\fP"
-For \fBdvips\fP(1)\&.
-Without information from MixedMap files\&.
-(Setting of \fBdvipsPreferOutline\fP ignored\&.)
-.IP "\fIpsfonts_t1\&.map\fP"
-For \fBdvips\fP(1)\&.
-With information from MixedMap files\&.
-(Setting of \fBdvipsPreferOutline\fP ignored\&.)
-.IP "\fIdownload35\&.map\fP"
-For \fBdvips\fP(1)\&.
-Always downloads the standard 35 fonts\&.
-(Setting of \fBdvipsDownloadBase35\fP ignored\&.)
-.IP "\fIbuiltin35\&.map\fP"
-For \fBdvips\fP(1)\&.
-Never downloads the standard 35 fonts\&.
-(Setting of \fBdvipsDownloadBase35\fP ignored\&.)
-.IP "\fIpdftex\&.map\fP"
-For \fBpdftex\fP(1)\&.
-Same as \fIpdftex_dl14\&.map\fP if option \fBpdftexDownloadBase14\fP active,
-else as \fIpdftex_ndl14\&.map\fP.
-.IP "\fIpdftex_dl14\&.map\fP"
-For \fBpdftex\fP(1)\&.
-Always downloads the standard 14 fonts\&.
-.IP "\fIpdftex_ndl14\&.map\fP"
-For \fBpdftex\fP(1)\&.
-Never downloads the standard 14 fonts\&.
-.IP "\fIps2pk\&.map\fP"
-Similar to \fIpsfonts.map\fP file, but
-forces all fonts to be downloaded, so this map file can be used with
-\fBxdvi\fP(1) and \fBps2pk\fP(1)\&.
-.PP
-Configuration files for \fBdvips\fP(1):
-.IP "\fIconfig\&.builtin35\fP"
-Loads \fIbuiltin35\&.map\fP instead
-of \fIpsfonts\&.map\fP\&.
-.IP "\fIconfig\&.download35\fP"
-Loads \fIdownload35\&.map\fP instead
-of \fIpsfonts\&.map\fP\&.
-.IP "\fIconfig\&.outline\fP"
-Loads \fIpsfonts_t1\&.map\fP instead
-of \fIpsfonts\&.map\fP\&.
-.IP "\fIconfig\&.pdf\fP"
-Loads \fIpsfonts_t1\&.map\fP instead
-of \fIpsfonts\&.map\fP and has additional optimizations for PDF generation\&.
-.IP "\fIconfig\&.pk\fP"
-Loads \fIpsfonts_pk\&.map\fP instead
-of \fIpsfonts\&.map\fP\&.
-.IP "\fIconfig\&.www\fP"
-Loads \fIpsfonts_t1\&.map\fP instead
-of \fIpsfonts\&.map\fP\&.
-(For compatibility with old versions\&.)
-.IP "\fIconfig\&.gstopk\fP"
-Loads \fIpsfonts_t1\&.map\fP instead
-of \fIpsfonts\&.map\fP\&.
-.SH "REPORTING BUGS"
-Report bugs to: tex\-k@tug.org
-.br
-TeX Live home page: <http://tug.org/texlive/>