Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
UPDMAP(1)			 User Commands			     UPDMAP(1)

       updmap -	manage TeX font	maps, per-user
       updmap-sys - manage TeX font maps, system-wide

       updmap [OPTION] ... [COMMAND]
       updmap-sys [OPTION] ... [COMMAND]

       updmap version svn33988 (2014-05-12 15:39:32 +0900)

       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 --all up-
       dmap.cfg", but see below).

       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.

       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.)

       By default, the TeX filename database (ls-R) is also updated.

       --cnffile FILE
	      read FILE	for the	updmap configuration (can  be  given  multiple
	      times, in	which case all the files are used)

       --dvipdfmxoutputdir DIR
	      specify output directory (dvipdfm(x) syntax)

       --dvipsoutputdir	DIR
	      specify output directory (dvips syntax)

       --pdftexoutputdir DIR
	      specify output directory (pdftex syntax)

       --pxdvioutputdir	DIR
	      specify output directory (pxdvi syntax)

       --outputdir DIR
	      specify output directory (for all	files)

       --copy cp generic files rather than using symlinks

	      recreate files even if config hasn't changed

	      do not recreate map files

	      do not run texhash

       --sys  affect system-wide files (equivalent to updmap-sys)

       -n, --dry-run
	      only show	the configuration, no output

       --quiet,	--silent
	      reduce verbosity

       --help show this	message	and exit

	      show version information and exit

       --showoption OPTION
	      show the current setting of OPTION

       --showoptions OPTION
	      show possible settings for OPTION

       --setoption OPTION VALUE
	      set OPTION to value; option names	below

       --setoption OPTION=VALUE
	      as above,	just different syntax

       --enable	MAPTYPE	MAPFILE
	      add  "MAPTYPE  MAPFILE"  to  updmap.cfg,	where  MAPTYPE is Map,
	      MixedMap,	or KanjiMap

       --enable	Map=MAPFILE
	      add "Map MAPFILE"	to updmap.cfg

       --enable	MixedMap=MAPFILE add "MixedMap MAPFILE"	to updmap.cfg

       --enable	KanjiMap=MAPFILE add "KanjiMap MAPFILE"	to updmap.cfg

       --disable MAPFILE
	      disable MAPFILE, of whatever type

	      list all active and inactive maps

	      same as --listmaps, but without unavailable map files

	      disable unavailable map files in updmap.cfg

       Explanation of the map types: the (only)	 difference  between  Map  and
       MixedMap	is that	MixedMap entries are not added to  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 and

       Explanation  of the OPTION names	for --showoptions, --showoption, --se-

	      true,false  (default true)

	      Whether dvips uses bitmaps or outlines, when both	are available.

	      true,false  (default true)

	      Whether dvips includes the standard 35 PostScript	fonts  in  its

	      true,false   (default true)

	      Whether pdftex includes the standard 14 PDF fonts	in its output.

	      true,false  (default false)

	      Whether  maps  for  pxdvi	 (Japanese-patched xdvi) are under up-
	      dmap's control.

	      (any string)

	      (any string)

	      See below.

       LW35   URWkb,URW,ADOBEkb,ADOBE  (default	URWkb)

	      Adapt the	font and file names  of	 the  standard	35  PostScript

       URWkb  URW fonts	with "berry" filenames	  (e.g.	uhvbo8ac.pfb)

       URW    URW fonts	with "vendor" filenames	  (e.g.	n019064l.pfb)

	      Adobe fonts with "berry" filenames  (e.g.	phvbo8an.pfb)

       ADOBE  Adobe fonts with "vendor"	filenames (e.g.	hvnbo___.pfb)

	      These  options are only read and acted on	by updmap; dvips, pdf-
	      tex, etc., do not	know anything about them.  They	work by	chang-
	      ing 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 up-

	      The options kanjiEmbed and kanjiVariant specify special replace-
	      ments  in	the map	lines.	If a map contains the string @kanjiEm-
	      bed@, 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.

       Explanation of trees and	files normally used:

	      If --cnffile 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  -all  updmap.cfg',
	      in the order returned by kpsewhich.

	      In  any  case,  if  multiple updmap.cfg files are	found, all the
	      maps mentioned in	all the	updmap.cfg files are merged.

	      Thus, if updmap.cfg files	are present in all trees, and the  de-
	      fault  layout  is	 used  as shipped with TeX Live, the following
	      files are	read, in the given order.

	      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
	      TEXMFDIST	     $TEXLIVE/YYYY/texmf-dist/web2c/updmap.cfg

	      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
	      TEXMFDIST	     $TEXLIVE/YYYY/texmf-dist/web2c/updmap.cfg

	      (where YYYY is the TeX Live release version).

	      According	to the actions,	updmap might write to one of the given
	      files or create a	new updmap.cfg,	described further below.

       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  --setoption,
	      --enable or --disable.  If the config files are taken from kpse-
	      which output, then the algorithm is more complex:

	      1)  If  $TEXMFCONFIG/web2c/updmap.cfg  or	  $TEXMFHOME/web2c/up-
	      dmap.cfg	appears	in the list of used files, then	the one	listed
	      first by kpsewhich --all	(equivalently,	the  one  returned  by
	      kpsewhich	updmap.cfg), is	used.

	      2) If neither of the above two are present and changes are made,
	      a	new config file	is created in $TEXMFCONFIG/web2c/updmap.cfg.

	      In general, the idea is that if  a  given	 config	 file  is  not
	      writable,	a higher-level one can be used.	 That way, the distri-
	      bution's settings	can be overridden for system-wide using	 TEXM-
	      FLOCAL,  and  then system	settings can be	overridden again for a
	      particular using using TEXMFHOME.

       Resolving multiple definitions of a font:

	      If a font	is defined in more than	one map	file, then the defini-
	      tion coming from the first-listed	updmap.cfg is used.  If	a font
	      is defined multiple times	within the same	map file, one is  cho-
	      sen arbitrarily.	In both	cases a	warning	is issued.

       Disabling maps:

	      updmap.cfg  files	with higher priority (listed earlier) can dis-
	      able maps	mentioned in lower priority (listed later)  updmap.cfg
	      files by writing,	e.g.,

	      #! Map


	      #! MixedMap

	      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,  dis-
	      able  the	 map  You	can create the file $TEXMFCON-
	      FIG/web2c/updmap.cfg with	the content

	      #! Map Map Map

	      and call updmap.

       updmap writes the map files for dvips (  and	 pdftex	 (pdf-	to the TEXMFVAR/fonts/map/updmap/{dvips,pdftex}/ directories.

       The log file is written to TEXMFVAR/web2c/updmap.log.

       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.

       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.

       To see the precise locations of the various files that will be read and
       written,	give the -n option (or read the	source).

       For  step-by-step  instructions	on making new fonts known to TeX, read  For even	 more  terse  instruc-
       tions, read the beginning of the	main updmap.cfg.

       Configuration and input files:

	      Main  configuration  file.   In texmf-dist/web2c by default, but
	      may be located elsewhere depending on your  distribution.	  Each
	      texmf tree read should have its own updmap.cfg.
	      Map file for standard 35 PostScript fonts	for use	with dvips(1).
	      Map  file	 for  standard	35  PostScript fonts for use with pdf-
	      Map file for standard 35 PostScript fonts	for use	with ps2pk(1).

       Output files:
	      For dvips(1).  Same as if option  dvipsPreferOut-
	      line active, else	as
	      For  dvips(1).   Without information from	MixedMap files.	 (Set-
	      ting of dvipsPreferOutline ignored.)
	      For dvips(1).  With information from MixedMap  files.   (Setting
	      of dvipsPreferOutline ignored.)
	      For dvips(1).  Always downloads the standard 35 fonts.  (Setting
	      of dvipsDownloadBase35 ignored.)
	      For dvips(1).  Never downloads the standard 35 fonts.   (Setting
	      of dvipsDownloadBase35 ignored.)
	      For  pdftex(1).	Same  as if option pdftexDown-
	      loadBase14 active, else as
	      For pdftex(1).  Always downloads the standard 14 fonts.
	      For pdftex(1).  Never downloads the standard 14 fonts.
	      Similar to file, but forces all fonts	 to  be	 down-
	      loaded, so this map file can be used with	xdvi(1)	and ps2pk(1).

       Configuration files for dvips(1):

	      Loads instead of

	      Loads instead of

	      Loads instead of

	      Loads  instead of and	has additional
	      optimizations for	PDF generation.
	      Loads instead of

	      Loads instead of  (For compatibility
	      with old versions.)

	      Loads instead of

       Report bugs to:
       TeX Live	home page: <>

TeX Live			   May 2014			     UPDMAP(1)


Want to link to this manual page? Use this URL:

home | help