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

NAME

       installdeb-myspell - debhelper-like helper for Debian packages containing myspell/hunspell
       dictionaries or Openoffice.org thesauri/hyphenation files.

SYNOPSIS

        installdeb-myspell [--srcdir=dir] [--dico-debug] [--{no-}o2compat] [debhelper options]

DESCRIPTION

       installdeb-myspell is a debhelper like program to help installing myspell/hunspell dicts
       as well as Openoffice.org thesauri or hyphenation files, after contents of an info-myspell
       file whose format is that for old Openoffice.org 2. This needs the --srcdir option
       enabled.

       If in o2 compatibility mode, it will also install appropriate debhelper snippets, info
       file and compatibility symlinks in a way a package containing myspell/hunspell
       dictionaries or Openoffice.org thesauri or hyphenation files can be used in Debian lenny
       and former under Openoffice.org 2 and Mozilla* according to the dictionaries policy valid
       at that time.

       Note that unless --srcdir option is used or o2compat mode is enabled, this program will do
       nothing.

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

       The actions executed by installdeb-myspell are the following (only some of them are done
       if not in o2 compatibility mode):

       Maintainer Scripts
           installdeb-myspell installs the necessary scraps of code in the postinst and postrm
           scripts.

       Language info file
           installdeb-myspell will look for a file named debian/info-myspell or
           debian/package.info-myspell. That file contains myspell/hunspell dictionary, OOO
           thesauri or hyphenation information with lines like

           TYPE LANG COUNTRY NAME

           If this file is successfully parsed and the o2compat option is enabled, it is
           installed in the [tmpdir]/usr/share/myspell/infos/ooo directory.

           A typical info-myspell file for a myspell/hunspell dictionary will contain something
           like

            # Spanish variants
            DICT es ES es_ES
            DICT es AR es_ES
            ...

           while will, for a typical hyphenation file, be something like

            # Danish hyphenation
            HYPH da DK hyph_da_DK

           or for a sample thesaurus,

            THES en US th_en_US

           all with no leading whitespace. Commented lines are allowed.

       Dictionary, thesaurus and hyphenation files installation
           If the --srcdir=dir option is set installdeb-myspell will look for the .aff/.dic files
           in the directory specified by dir and install them in the default target directory
           ([tmpdir]/usr/share/hunspell).  Base name will be extracted from the info-myspell file
           (last string in the line). If target dict uses the ancient Mozilla hyphen form, it
           will be renamed to the lowbar form on installation.  Same (but the renaming) for
           hyphenation and thesaurus files, to be installed in [tmpdir]/usr/share/hyphen and
           [tmpdir]/usr/share/mythes.  If o2compat option is enabled, lenny compatibility
           symlinks will be installed as well.

       Dictionaries alternative symlinks creation
           installdeb-myspell will, according to info extracted from the info-myspell,
           automatically set lang_COUNTRY symlinks to the dict files installed by installdeb-
           myspell. This will only be done when the --srcdir option is used.

           If --srcdir option is used and the info-myspell file contains something like

            # Spanish variants
            DICT es ES es
            DICT es AR es
            ...

           installdeb-myspell will automatically set es_ES and es_AR symlinks

       Mozilla spellchecker compatibility
           For myspell/hunspell dictionaries, Mozilla had a lang{,-COUNTRY} to names translation
           table using hyphens as separators (and for some languages not using country part at
           all) instead of lowbars.

           Shortly, that will no longer be the case. Mozilla will also accept lang_COUNTRY format
           for that translation table, no special things will be needed. In particular, do not
           duplicate entries in both lowbar and hyphen forms. Use lowbar.

       Debconf files
           As opposed to installdeb-ispell and installdeb-wordlist, installdeb-myspell does
           nothing related to debconf files, not needed for myspell/hunspell dicts and OOO
           thesauri and hyphenation files. If you need to add debconf stuff with debhelper
           proceed in the usual way and call dh_installdebconf(1) as for any other package.

OPTIONS

       --dico-debug  Show some installdeb-myspell specific debugging info.
                     Does not enable debhelper debug, you need to enable
                     it separately.

       --srcdir=dir  Will look for .aff/.dic files in the specified directory
                     for myspell/hunspell dict packages, for .dic files in
                     Openoffice.org hyphenation packages and for .dat/.idx
                     files in Openoffice.org thesaurus packages, installing
                     them if present in the default target directory. Base
                     name will be extracted from the info-myspell file. If
                     this option is specified and files are not present an
                     error will appear.

       --{no-}o2compat Disable/enable openoffice2 compatibility. If enabled,
                     info file will be installed in
                     [tmpdir]/usr/share/myspell/infos/ooo and compatibility
                     symlinks will be set from the old
                     [tmpdir]/usr/share/myspell/dicts location. This option
                     is disabled by default.

       --dico-{no-}alt-links {Process/Do not process} alternative symlinks
                     according to info found in the myspell info file.

       The usual debhelper(7) options are accepted.

NOTES

       This program is not part of debhelper, although depends on and is intended to work
       together with it.

SEE ALSO

       debhelper(7)

       This program is part of the dictionaries-common-dev package.  It is intended for use by
       maintainers of packages containing myspell/hunspell dictionaries or Openoffice.org
       thesauri/hyphenation files.  See the documentation under
       /usr/share/doc/dictionaries-common-dev.

AUTHORS

       Rafael Laboissiere <rafael@debian.org>, Agustin Martin <agmartin@debian.org>