[tex-live] Sorting out updmap/updmap-sys-troubles

[Norbert Preining]

Hi Ulrike,

On Di, 22 Mai 2012, Ulrike Fischer wrote:
> one recurrent problem with font installation is caused by mixed 
> calls of updmap and updmap-sys (or on miktex of updmap / updmap 
> --admin). 

That was always and still is the case, that is nothing new with 
the new multi updmap implementation.

> it useful if some exact informations could be collected to help 
> people to sort out the map files without breaking something else. 

Sure, let us do that and put infos on a web page.

First of all, I will answer only ONE set of questions, because
updmap and updmap-sys *are*the*same*.

The only difference is that in updmap-sys
	TEXMFCONFIG is set to the value of $TEXMFSYSCONFIG
	TEXMFVAR is set to the value of $TEXMFSYSVAR

> A. updmap
> =========
> 1. Which updmap.cfg's is updmap reading
>    a) root names as "kpse-variable"
>    b) a typical path on unix
>    c) a typical path on windows

Please take a look at the first lines of an updmap-sys call to see
which updmap.cfg files are read.

Furthremore, if you want to know *where* you can put updmap.cfg files,
please use
	kpsewhich -show-path web2c
that is all the texmf trees' web2c dirs normally.

> 2. Which updmap.cfg does "updmap --enable Map" change?

Please see and read the output of updmap --help, I quote:
----
...
  * where changes are saved
    If config files are given on the cmd line, then the first given will
    be used to save changes (by --setoption, --enable or --disable).
    If the config files are taken from kpsewhich, then the algorithm is 
    more complex:
    - if one of $TEXMFHOME/web2c/updmap.cfg or $TEXMFCONFIG/web2c/updmap.cfg
      appears in the list of used files, then the one given *first* by
      kpsewhich --all, or equivalently, the one given by kpsewhich updmap.cfg,
      is used
    - if none of the above two are present, a new config file is created
      in $TEXMFCONFIG/web2c/updmap.cfg (in case there are actual changes)
      and used
...

> 3. In which texmf tree does updmap write the map-files?

TEXMFVAR (see above for -sys vs non-sys variant!)

> 4. Which map-files does updmap write?

I assume you mean the configuration files for dvips/dvipdfm/xdvi/....?
In this case, of course it does the same as it did in the last 15(?) years!
It writes to 
	TEXMFVAR/fonts/map/dvips/updmap
	TEXMFVAR/fonts/map/pdftex/updmap
	TEXMFVAR/fonts/map/dvipdfmx/updmap

And this is clearly visible from the output of updmap-sys:
$ updmap-sys 
...
Files generated:
  /home/norbert/tl/2012/texmf-var/fonts/map/dvips/updmap:
       11482 2012-05-23 07:34:13 builtin35.map
       15945 2012-05-23 07:34:13 download35.map
     1081105 2012-05-23 07:34:13 psfonts_pk.map
     1342738 2012-05-23 07:34:13 psfonts_t1.map
     1337828 2012-05-23 07:34:13 ps2pk.map
          14 2012-05-23 07:34:13 psfonts.map -> psfonts_t1.map
  /home/norbert/tl/2012/texmf-var/fonts/map/pdftex/updmap:
     1337835 2012-05-23 07:34:13 pdftex_dl14.map
     1336262 2012-05-23 07:34:13 pdftex_ndl14.map
          15 2012-05-23 07:34:13 pdftex.map -> pdftex_dl14.map
  /home/norbert/tl/2012/texmf-var/fonts/map/dvipdfmx/updmap:
        5276 2012-05-23 07:34:12 kanjix.map

Transcript written on "/home/norbert/tl/2012/texmf-var/web2c/updmap.log".
updmap: Updating ls-R files.
$

> 5. Does updmap generate a log-file by default?

Please again, read the output, see the last line above.

>    If yes: where is it on unix
>                           on windows

in the same places ... in TEXMFVAR (see above for -sys vs non-sys)

>            when you call updmap manually
>            and when updmap is executed by tlmngr (if ever)

Same.

>    If not: How can you force updmap to write a log-file?
> 
> 
> B. updmap-sys

See above, replace TEXMFVAR with TEXMFSYSVAR

> 6. Does it matter if you run updmap-sys (with sudo?) in a user 
> account or in an admin account?

No that I know.

> C. Resolving troubles
> =====================
> 
> 1. Revert updmap and use updmap-sys from now on: 
>   a) What is the best way to delete local map-files generated by  
> updmap?

remove the above mentioned files or the whole dir in
	TEXMFVAR/fonts/map/

>   b) What is the best way to merge map-files added by "updmap 
> --enable Map" to the updmap.cfg of updmap-sys?

Several options:
. edit the files and copy them over?
. make the same --enable calls wiht the updmap-sys variant

> 2. The other way round: If a user would prefer to use updmap from 
> now on: What should he do to activate all map files which had been 
> added with "updmap-sys --enable Map"? (Or do they work already??)

Yes, they wokr already, since updmap-sys will normally add entries
in TEXMFSYSCONFIG/web2c/updmap.cfg, which is also found from a
user. Thus everything that is activated in TEXMFSYSCONFIG is available
to everyone (which is the intended way!)



Hope that helped.

Best wishes

Norbert
------------------------------------------------------------------------
Norbert Preining            preining@{jaist.ac.jp, logic.at, debian.org}
JAIST, Japan                                 TeX Live & Debian Developer
DSA: 0x09C5B094   fp: 14DF 2E6C 0307 BE6D AD76  A9C0 D2BF 4AA3 09C5 B094
------------------------------------------------------------------------
SCOPWICK (n.)
The flap of skin which is torn off you lip when trying to smoke an
untipped cigarette.
			--- Douglas Adams, The Meaning of Liff