dh_installtexfonts - register Type 1 fonts with TeX

dh_installtexfonts [debhelper options] [-n] [--priority=n] [--flavor=flavor] [maptype=mapfile ...] [cfg-file[=n] ...]

dh_installtexfonts is a debhelper program that is responsible for registering Type 1 fonts with TeX.

Your package should depend on tex-common so that the update-* commands are available. (This program adds that dependency to ${misc:Depends}.)

Registering map files for TeX can be done in the following ways:

1) You can specify cfg files on the cmd line, optionally providing a priority by affixing =n to it. These cfg files will be installed into /etc/texmf/updmap.d/ with the specified priority, if present, or with the default priority and their original name.

Example:

        dh_installtexfonts foo.cfg dvips/bar.cfg=42

would install foo.cfg as /etc/texmf/updmap.d/10foo.cfg, and dvips/bar.cfg as /etc/texmf/updmap.d/42bar.cfg.

2) You can specify map lines on the cmdline, where the map type and the map files is connected with =. These map lines are stored in a cfg file 10package.cfg.

Example:

        dh_installtexfonts Map=foo.map MixedMap=bar.map

would install a file /etc/texmf/updmap.d/10package.cfg containing the lines

        Map foo.map
        MixedMap bar.map

3) You create a file debian/package.maps or debian/maps. These files are installed with default priority and the name of the package. The file debian/maps will be installed into the first package dh_installtexfonts is told to act on. By default this is the first binary package in debian/control, but if you use -p, -i, or -a flags, it will be the first package specified by those flags.

Example:

        dh_installtexfonts

would install a present debian/package.maps file as /etc/texmf/updmap.d/10package.cfg.

The command line maps (Variant 2) are merged into the debian/package.maps file and the merged file is installed as 10package.cfg. If you specify an additional package.cfg (Variant 1) without a different priority than the default one on the cmd line, this will raise an error since both files would be installed as 10package.cfg. You can only specify package.cfg without a different priority than the default one if no debian/package.maps nor any command line Map files are present.

If the provided cfg files do not contain the pseudo-comment as described in the Debian TeX Policy, Font configuration, an additional header with explanation, warning and the pseudo-comment is added.

This program automatically generates the postinst and postrm commands needed to register the fonts with TeX. See dh_installdeb(1) for an explanation of how this works.

-n, --noscripts

Do not modify postinst/prerm scripts.

--priority=n

Set the default priority to n instead of 10.

--flavor=flavor

This option will be used to switch additional options on. At the moment you can select for flavor either config_for_active_maps or config_for_all_maps. config_for_active_maps will create a file config.bar for each active (i.e. uncommented) map in each of the cfg file generated by one of the three methods described above. These files are installed in /usr/share/texmf/dvips/config/. If you select config_for_all_maps the script will generate config.bar even for those map files which are present in a cfg file, but deactivated by a comment. The file config.bar is used when called by `dvips -Pbar ...'. Thus it allows the activation of single map files even if they are not automatically activated via the updmap(-sys) mechanism. Default is not to generate any config files.

Note that this command is not idempotent. dh_clean -k should be called between invocations of this command, unless using the -n option. Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts. Please refer to the Debian TeX policy for details about fonts configuration for TeX by Debian packages.

debhelper(7)

Norbert Preining <preining@logic.at>