.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "ISPELL-WRAPPER 1"
.TH ISPELL-WRAPPER 1 "2021-2-22" "1.28.4" " "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
ispell\-wrapper \- smart wrapper for ispell
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& 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
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBispell-wrapper\fR 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.
.PP
It automatically sets the \fB\-d\fR, \fB\-w\fR, and \fB\-T\fR 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.
.PP
Here is how the language is defined (in order of priority):
.IP "1)" 4
.IX Item "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.
.IP "2)" 4
.IX Item "2)"
By matching the regexp given in option \-\-language to the list of
installed languages in the system.
.IP "3)" 4
.IX Item "3)"
By matching the regexp stored in the environment variable
\&\s-1ISPELLDEFAULT\s0 to the list of installed languages in the system.
.IP "4)" 4
.IX Item "4)"
By using the value stored in the user-specific file ~/.ispell\-default
(use \fBselect\-default\-iwrap\fR\|(1) to set it).
.IP "5)" 4
.IX Item "5)"
By using the value stored in the site-wide file
/etc/dictionaries\-common/ispell\-default (use \fBselect\-default\-ispell\fR\|(8)
as superuser to set it).
.PP
Note: regexp matches are case-insensitive and the \s-1ISO\-8859\-1\s0 special
characters are transformed into their \s-1ASCII\s0 equivalents.  German
ess-zet is equivalent to the character \*(L"s\*(R" and the ae ligature to the
character \*(L"e\*(R".
.SH "EXAMPLE"
.IX Header "EXAMPLE"
Let us say that the following dictionaries are installed in the system
(as appearing in the Debconf question at installation time):
.PP
.Vb 4
\&    castellano (Spanish TeX mode)
\&    castellano8 (Spanish 8 bit)
\&    portugu\[^e]s (European Portuguese)
\&    portugu\[^e]s brasileiro (Brazilian Portuguese)
.Ve
.PP
Choosing the regexp (either in the \-\-language option or in the
environment variable \s-1ISPELLDEFAULT\s0) to be \*(L"span\*(R" will yield an error,
since two languages will match (\*(L"castellano\*(R" and \*(L"castellano8\*(R").
However, if the regexp is \*(L"span.*8\*(R", the language \*(L"castellano8
(Spanish 8 bit)\*(R" will be chosen.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
.IP "\s-1ISPELLDEFAULT\s0" 4
.IX Item "ISPELLDEFAULT"
Regexp that matches the name of the default language to use, if no
\&\-\-language option is given.
.SH "FILES"
.IX Header "FILES"
.ie n .IP "$HOME/.ispell\-default" 4
.el .IP "\f(CW$HOME\fR/.ispell\-default" 4
.IX Item "$HOME/.ispell-default"
Contains the name of the language to use, if no \-\-language option is
given or if the \s-1ISPELLDEFAULT\s0 environment variable is not set.  This
is a user-specific choice.
.IP "/etc/dictionaries\-common/ispell\-default" 4
.IX Item "/etc/dictionaries-common/ispell-default"
Name of the language to use when everything above is not set. This is
a system-wide setting.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBselect\-default\-ispell\fR\|(8), \fBselect\-default\-iwrap\fR\|(1)
.SH "AUTHORS"
.IX Header "AUTHORS"
Rafael Laboissiere