{
    "mode": "man",
    "parameter": "dh_installtex",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/dh_installtex/1/json",
    "generated": "2026-06-15T13:13:27Z",
    "synopsis": "dhinstalltex [debhelper options] [-n] [--flavor=flavor[,flavor]] [map=MixedMap,file.map]\n[map=Map,file.map] [map=KanjiMap,file.map] [mapfile=file.cfg]\n[hyphen=lang,file[,lhm=n][,rhm=n][,synonym=syn,...]]  [hyphenfile=file.cnf]\n[format=format,engine,hyphenfile,rest args] [formatfile=file.cnf]",
    "sections": {
        "NAME": {
            "content": "dhinstalltex - register Type 1 fonts, hyphenation patterns, or formats with TeX\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "dhinstalltex [debhelper options] [-n] [--flavor=flavor[,flavor]] [map=MixedMap,file.map]\n[map=Map,file.map] [map=KanjiMap,file.map] [mapfile=file.cfg]\n[hyphen=lang,file[,lhm=n][,rhm=n][,synonym=syn,...]]  [hyphenfile=file.cnf]\n[format=format,engine,hyphenfile,rest args] [formatfile=file.cnf]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "dhinstalltex is a debhelper program that is responsible for updating the ls-R databases,\nregistering map files, new formats, and new hyphenation patterns with TeX.\n\nYour package should depend on an appropriate version of tex-common so that the update-*\ncommands are available. (This program adds that dependency to ${misc:Depends}.)\n\nWARNING This program does not check for the actual existence of any input files in TEXMF\ntrees. If you call it without any further specification on which packages to work on (using\n\"-p\" or \"-N\") it will add calls to management functions to all packages. In this case don't\nforget to add ${misc:Depends} to all packages' dependencies.\n",
            "subsections": [
                {
                    "name": "SIMPLE USAGE: Registering Files",
                    "content": "If you only install files into /usr/share/texmf, nothing has to be done, tex-common will\nautomatically detect changes and run mktexlsr.\n"
                },
                {
                    "name": "COMPLEX USAGE: Registering fonts, hyphenation patterns and formats",
                    "content": "If in addition, you have to install map files, hyphenation patterns for additional languages,\nor format definitions you can use three different methods to specify what should be\ninstalled:\n\n1) Pre made config files: These files can be specified with the different typefile= options.\ntype can be one of map, format and hyphen, and these files will be installed into\n/var/lib/tex-common/configdir/ for the respective type (fontmap-cfg for map files, hyphen-cnf\nfor hyphenation patterns, and fmtutil-cnf for format definitions).\n\nExample:\n\ndhinstalltex mapfile=foo.cfg formatfile=debian/bar.cnf\n\nwould install foo.cfg as /var/lib/tex-common/fontmap-cfg/texmf/foo.cfg, and debian/bar.cnf as\n/var/lib/tex-common/fmtutil-cnf/texmf/bar.cnf.\n\n2) Directly on the cmd line: You can specify maps, formats, and hyphenations on the cmd line.\nThe items are stored in the respective config file 20package\n\nExample:\n\ndhinstalltex 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\n\nwould install a file /var/lib/tex-common/fontmap-cfg/texmf/package.cfg containing the line\n\nMap foo.map\n\nand a file /var/lib/tex-common/hyphen-cnf/texmf/package.cnf containing the lines\n\nname=ngerman-x-2011-07-01 file=dehyphn-x-2011-07-01.tex filepatterns=hyph-de-1996.pat.txt lefthyphenmin=2 righthyphenmin=2 synonym=ngerman-x-latest fileexceptions=hyph-de-1996.hyp.txt\n\n3) Package files: You create a file debian/package.maps or debian/maps,\ndebian/package.hyphens or debian/hyphens, debian/package.formats or debian/formats. These\nfiles are installed with the name of the package. Each of these files will be installed into\nthe first package dhinstalltex is told to act on. By default this is the first binary\npackage in debian/control, but if you use -p, -i, or -a flags, it will be the first package\nspecified by those flags.\n\nExample:\n\ndhinstalltex\n\nwould install a present debian/package.formats file as\n/var/lib/tex-common/fmtutil-cnf/texmf/package.cnf.\n"
                },
                {
                    "name": "Mixing the different variants",
                    "content": "The command line items (Variant 2) are merged into the debian/package.maps\n(debian/package.hyphens, debian/package.formats) file. If you specify an additional\npackage.cfg/cnf (Variant 1) this will raise an error since both files would be installed as\npackage.cfg/cnf.\n"
                }
            ]
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-n --noscripts",
                    "content": "Do not modify postinst/prerm scripts.\n\n--flavor=flavor[,flavor]\nThis option is used to select a different tree then the default /usr/share/texmf, and to\nswitch on additional options. The argument specify a list from flavors to be selected.\nAt the moment you can select from the following list of flavors: tree:texlive,\nmap:configforactivemaps, map:configforallmaps, format:addone:ffoorrmmaattnnaammee.\n\ntree:texlive will select the tree /usr/share/texlive/texmf-dist and should only be used\nfor files installed into this tree.\n\nmap:configforactivemaps will create a file config.bar for each active (i.e.\nuncommented) map in each of the cfg file generated by one of the three methods described\nabove. These files are installed in /usr/share/texmf/dvips/config/.\n\nIf you select map:configforallmaps the script will generate config.bar even for those\nmap files which are present in a cfg file, but deactivated by a comment.\n\nThe file config.bar is used when called by `dvips -Pbar ...'. Thus it allows the\nactivation of single map files even if they are not automatically activated via the\nupdmap(-sys) mechanism.\n\nDefault is not to generate any config files.\n\nformat:addone:ffoorrmmaattnnaammee allows one to add the generation of a specific format without\nactually providing it (in a cnf file).  This is useful if a package adds hyphenation\npatterns to an existing formats.\n\nformat:nolinks: Usually, for every format that is specified in a configuration file,\ndhinstalltex will create a symlink /usr/bin/format that points to the corresponding\nengine.  For example, /usr/bin/latex would be created as a symlink to pdftex.\n\nThe flavor format:nolinks inhibits this. If a link already exists, dhinstalltex will\nskip this format with an informational message, even if this option is not given.\n",
                    "flag": "-n",
                    "long": "--noscripts"
                }
            ]
        },
        "NOTES": {
            "content": "\"dhinstalltex\" adds a dependency relation onto tex-common to misc:Depends.\n\nNote that this command is not idempotent. \"dhclean -k\" should be called between invocations\nof this command, unless using the -n option.  Otherwise, it may cause multiple instances of\nthe same text to be added to maintainer scripts.\n\nPlease refer to the Debian TeX policy for details about fonts configuration for TeX by Debian\npackages.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "debhelper(7)\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "This program and its documentation was written by Norbert Preining for the Debian Operating\nSystem and both are licensed under the GNU General Public License Version 2 or later.\n\n\n\nperl v5.32.1                                 2021-09-04                             DHINSTALLTEX(1)",
            "subsections": []
        }
    },
    "summary": "dhinstalltex - register Type 1 fonts, hyphenation patterns, or formats with TeX",
    "flags": [
        {
            "flag": "-n",
            "long": "--noscripts",
            "arg": null,
            "description": "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:configforactivemaps, map:configforallmaps, format:addone:ffoorrmmaattnnaammee. tree:texlive will select the tree /usr/share/texlive/texmf-dist and should only be used for files installed into this tree. map:configforactivemaps 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:configforallmaps 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:addone:ffoorrmmaattnnaammee allows one 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:nolinks: Usually, for every format that is specified in a configuration file, dhinstalltex 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:nolinks inhibits this. If a link already exists, dhinstalltex will skip this format with an informational message, even if this option is not given."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "debhelper",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/debhelper/7/json"
        }
    ]
}