Provided by: dictionaries-common-dev_1.29.5_all bug

NAME

       installdeb-aspell - debhelper-like utility for maintainers of aspell dictionary Debian
       packages

SYNOPSIS

        installdeb-aspell [debhelper options]

DESCRIPTION

       installdeb-aspell is a debhelper like program that is responsible for installing
       appropriate debhelper snippets in an aspell dictionary package, according to the Debian
       Spell Dictionaries and Tools Policy.

       For more details, see
        /usr/share/doc/dictionaries-common-dev/dsdt-policy.txt.gz

       The actions executed by installdeb-aspell are the following:

       •   Maintainer Scripts

           installdeb-aspell installs the necessary scraps of code in the postinst and postrm
           scripts.

       •   Language info file

           installdeb-aspell also checks a file containing aspell dictionary information, called
           debian/info-aspell or debian/package.info-aspell.  If this file is successfully
           parsed, it is installed in the /var/lib/dictionaries-common/aspell directory.

       •   Substvars substitutions

           This script will populate a substvars file, so Depends line in control file can
           contain ${aspell:Depends} to automatically care for dictionaries-common dependencies.

           This requires "Build-Depends" on at least dictionaries-common-dev 1.23.0 and is highly
           recommended.

       •   Debconf files

           As opposed to installdeb-ispell and installdeb-wordlist, neither installdeb-aspell nor
           installdeb-hunspell do anything related to debconf files, since both aspell and
           hunspell rely on the environment variable "LANG" for default dictionary selection
           instead of using symlinks set after a debconf question on dictionary installation. For
           that reason if you need to add debconf stuff with debhelper to your aspell or hunspell
           dictionary package do it in the usual way and call dh_installdebconf(1) as for any
           other package.

       •   Extra installdeb-aspell options in Language info file

           For benefit of aspell dictionaries using aspell-autobuildhash, installdeb-aspell
           script will look for 'auto-compat' and 'auto-contents' fields in $lang.info-aspell,
           containing base name(s) of your compat and, if needed, contents file(s).  If
           'auto-compat' entry is found two debhelper snippets are added, one to create/reset
           compatfile(s) in postinst and the other to remove files in a removal list (initially
           containing compat files) from postrm.  If 'auto-contents' entry is found, contents
           file at debian/ will be parsed and its contents added to the removal list, otherwise a
           hash with the same basename of the compatfile is expected and added to the removal
           list.  If you use a contents file and enable it in 'auto-contents' you usually will
           need only the same base name enabled in 'auto-compat'.

           If you are interested in a simple install of a pristine aspell dictionary with a
           minimal debian/rules please look at dh_aspell-simple(1).  You will still need an
           aspell-info file, but compat/contents stuff will be guessed if not explicitly provided
           in the aspell-info file.

           /usr/lib/aspell/$dict.rws -> /var/lib/aspell/$dict.rws symlinks are no longer created
           automatically by this script.  They are now created by new aspell-autobuildhash
           together with the relevant hashes.  Make sure to depend on at least dictionaries-
           common 1.23 (See dictionaries-common.checklist).

OPTIONS

       The usual dephelper(1) options are accepted.

NOTES

       This program is not part of debhelper, although it is intended to be used in aspell
       dictionary packages using debhelper in its building.

SEE ALSO

       debhelper(1), dictionaries-common.checklist, dsdt-policy.txt

       This program is part of the dictionaries-common-dev package. It is intended to be used by
       maintainers of aspell dictionary packages for Debian. See the documentation under
       /usr/share/doc/dictionaries-common-dev.

AUTHORS

       Rafael Laboissiere, Agustin Martin