dh_installtex

DH_INSTALLTEX(1)      User Contributed Perl Documentation     DH_INSTALLTEX(1)

NAME
       dh_installtex - register Type 1 fonts, hyphenation patterns, or formats
       with TeX

SYNOPSIS
       dh_installtex [debhelper options] [-n] [--priority=n]
       [--flavor=flavor[,flavor]] [map=MixedMap,file.map] [map=Map,file.map]
       [map=KanjiMap,file.map] [mapfile=file.cfg]
       [hyphen=lang,file[,lhm=n][,rhm=n][,synonym=syn,...]]
       [hyphenfile=file.cnf] [format=format,engine,hyphenfile,rest args]
       [formatfile=file.cnf]

DESCRIPTION
       dh_installtex is a debhelper program that is responsible for updating
       the ls-R databases, registering map files, new formats, and new
       hyphenation patterns with TeX.

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

       WARNING This program does not check for the actual existence of any
       input files in TEXMF trees. If you call it without any further
       specification on which packages to work on (using "-p" or "-N") it will
       add calls to management functions to all packages. In this case don't
       forget to add ${misc:Depends} to all packages' dependencies.

SIMPLE USAGE: Registering Files
       If you only install files into /usr/share/texmf, nothing has to be
       done, tex-common will automatically detect changes and run mktexlsr.

COMPLEX USAGE: Registering fonts, hyphenation patterns and formats
       If in addition, you have to install map files, hyphenation patterns for
       additional languages, or format definitions you can use three different
       methods to specify what should be installed:

       1) Pre made config files: These files can be specified with the
       different typefile= options.  type can be one of map, format and
       hyphen, and these files will be installed into
       /var/lib/tex-common/configdir/ for the respective type (fontmap-cfg for
       map files, hyphen-cnf for hyphenation patterns, and fmtutil-cnf for
       format definitions).

       Example:

               dh_installtex mapfile=foo.cfg formatfile=debian/bar.cnf

       would install foo.cfg as /var/lib/tex-common/fontmap-cfg/texmf/foo.cfg,
       and debian/bar.cnf as /var/lib/tex-common/fmtutil-cnf/texmf/bar.cnf.

       2) Directly on the cmd line: You can specify maps, formats, and
       hyphenations on the cmd line. The items are stored in the respective
       config file 20package

       Example:

               dh_installtex map=Map,foo.map hyphen=ngerman-x-2011-07-01,dehyphn-x-2011-07-01.tex,hyph-de-1996.pat.txt,lhm=2,rhm=2,synonym=ngerman-x-latest,exceptions=hyph-de-1996.hyp.txt

       would install a file /var/lib/tex-common/fontmap-cfg/texmf/package.cfg
       containing the line

               Map foo.map

       and a file /var/lib/tex-common/hyphen-cnf/texmf/package.cnf containing
       the lines

           name=ngerman-x-2011-07-01 file=dehyphn-x-2011-07-01.tex file_patterns=hyph-de-1996.pat.txt lefthyphenmin=2 righthyphenmin=2 synonym=ngerman-x-latest file_exceptions=hyph-de-1996.hyp.txt

       3) Package files: You create a file debian/package.maps or debian/maps,
       debian/package.hyphens or debian/hyphens, debian/package.formats or
       debian/formats. These files are installed with the name of the package.
       Each of these files will be installed into the first package
       dh_installtex 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_installtex

       would install a present debian/package.formats file as
       /var/lib/tex-common/fmtutil-cnf/texmf/package.cnf.

   Mixing the different variants
       The command line items (Variant 2) are merged into the
       debian/package.maps (debian/package.hyphens, debian/package.formats)
       file. If you specify an additional package.cfg/cnf (Variant 1) this
       will raise an error since both files would be installed as
       package.cfg/cnf.

OPTIONS
       -n, --noscripts
           Do not modify postinst/prerm scripts.

       --flavor=flavor[,flavor]
           This option is used to select a different tree then the default
           /usr/share/texmf, and to switch on additional options. The argument
           specify a list from flavors to be selected.  At the moment you can
           select from the following list of flavors: tree:texlive,
           map:config_for_active_maps, map:config_for_all_maps,
           format:add_one:formatname.

           tree:texlive will select the tree /usr/share/texlive/texmf-dist and
           should only be used for files installed into this tree.

           map: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 map: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.

           format:add_one:formatname allows to add the generation of a
           specific format without actually providing it (in a cnf file).
           This is useful if a package adds hyphenation patterns to an
           existing formats.

           format:no_links: Usually, for every format that is specified in a
           configuration file, dh_installtex will create a symlink
           /usr/bin/format that points to the corresponding engine.  For
           example, /usr/bin/latex would be created as a symlink to pdftex.

           The flavor format:no_links inhibits this. If a link already exists,
           dh_installtex will skip this format with an informational message,
           even if this option is not given.

NOTES
       "dh_installtex" adds a dependency relation onto tex-common to
       misc:Depends.

       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.

SEE ALSO
       debhelper(7)

AUTHOR
       This program and its documentation was written by Norbert Preining
       <preining@logic.at> for the Debian Operating System and both are
       licensed under the GNU General Public License Version 2 or later.

perl v5.22.1                      2015-10-14                  DH_INSTALLTEX(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2021 Hurricane Electric. All Rights Reserved.