NAME

       ispell-wrapper - smart wrapper for ispell

SYNOPSIS

        ispell-wrapper [--emacs=name] [--language=regexp] [--dry-run] [ispell options] file

          Options (all long only options):
           --emacs=name           Set the language to use by emacs dict name
           --language=regexp      Set the language to use by name
           --dry-run              Only show what would have done

DESCRIPTION

       ispell-wrapper is a wrapper script for ispell intended to be used in a Debian system in conjunction with
       the infrastructure introduced by the dictionaries-common package. Option --dry-run will show the string
       to be run without doing anything else.

       It automatically sets the -d, -w, and -T options to ispell as a function of the chosen language.  Of
       course, this only works for dictionary packages that comply with the above mentioned Policy.

       Here is how the language is defined (in order of priority):

       1)  By  matching  the emacs dict name given in --emacs option to the name of one of the emacs dicts names
           provided by installed  languages  in  the  system.  This  match  must  be  exact  (although  is  case
           insensitive).  Note that this will override any value given in the --language option.

       2)  By matching the regexp given in option --language to the list of installed languages in the system.

       3)  By  matching  the  regexp  stored  in the environment variable ISPELLDEFAULT to the list of installed
           languages in the system.

       4)  By using the value stored in the user-specific file ~/.ispell-default (use select-default-iwrap(1) to
           set it).

       5)  By using  the  value  stored  in  the  site-wide  file  /etc/dictionaries-common/ispell-default  (use
           select-default-ispell(8) as superuser to set it).

       Note:  regexp  matches  are  case-insensitive  and the ISO-8859-1 special characters are transformed into
       their ASCII equivalents.  German ess-zet is equivalent to the character "s" and the ae  ligature  to  the
       character "e".

EXAMPLE

       Let  us  say  that  the  following  dictionaries are installed in the system (as appearing in the Debconf
       question at installation time):

           castellano (Spanish TeX mode)
           castellano8 (Spanish 8 bit)
           português (European Portuguese)
           português brasileiro (Brazilian Portuguese)

       Choosing the regexp (either in the --language option or in the environment variable ISPELLDEFAULT) to  be
       "span" will yield an error, since two languages will match ("castellano" and "castellano8").  However, if
       the regexp is "span.*8", the language "castellano8 (Spanish 8 bit)" will be chosen.

ENVIRONMENT

       ISPELLDEFAULT
           Regexp that matches the name of the default language to use, if no --language option is given.

FILES

       $HOME/.ispell-default
           Contains  the  name  of the language to use, if no --language option is given or if the ISPELLDEFAULT
           environment variable is not set.  This is a user-specific choice.

       /etc/dictionaries-common/ispell-default
           Name of the language to use when everything above is not set. This is a system-wide setting.

SEE ALSO

       select-default-ispell(8), select-default-iwrap(1)

AUTHORS

       Rafael Laboissiere

1.29.7                                              2023-9-07                                  ISPELL-WRAPPER(1)