.\" 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 "INSTALLDEB-ASPELL 1"
.TH INSTALLDEB-ASPELL 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"
installdeb\-aspell \- debhelper\-like utility for
maintainers of aspell dictionary Debian packages
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& installdeb\-aspell [debhelper options]
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBinstalldeb-aspell\fR 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.
.PP
For more details, see
 /usr/share/doc/dictionaries\-common\-dev/dsdt\-policy.txt.gz
.PP
The actions executed by \fBinstalldeb-aspell\fR are the
following:
.IP "\(bu" 4
Maintainer Scripts
.Sp
\&\fBinstalldeb-aspell\fR installs the necessary
scraps of code in the \fIpostinst\fR and \fIpostrm\fR scripts.
.IP "\(bu" 4
Language info file
.Sp
\&\fBinstalldeb-aspell\fR also checks a file containing
aspell dictionary information, called
\&\fIdebian/info\-aspell\fR or
\&\fIdebian/package.info\-aspell\fR.  If this file is
successfully parsed, it is installed in the
\&\fI/var/lib/dictionaries\-common/aspell\fR directory.
.IP "\(bu" 4
Substvars substitutions
.Sp
This script will populate a \fIsubstvars\fR file, so Depends line in
control file can contain
${aspell:Depends} to
automatically care for dictionaries-common dependencies.
.Sp
This requires \f(CW\*(C`Build\-Depends\*(C'\fR on at least dictionaries-common-dev
1.23.0 and is highly recommended.
.IP "\(bu" 4
Debconf files
.Sp
As opposed to \fBinstalldeb-ispell\fR and \fBinstalldeb-wordlist\fR, neither \fBinstalldeb-aspell\fR
nor \fBinstalldeb-hunspell\fR do anything related to debconf files, since both aspell and
hunspell rely on the environment variable \f(CW\*(C`LANG\*(C'\fR 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
\&\fBdh_installdebconf\fR\|(1) as for any other package.
.IP "\(bu" 4
Extra installdeb-aspell options in Language info file
.Sp
For benefit of aspell dictionaries using \fBaspell-autobuildhash\fR,
\&\fBinstalldeb-aspell\fR script will look for \f(CW\*(Aqauto\-compat\*(Aq\fR and
\&\f(CW\*(Aqauto\-contents\*(Aq\fR fields in \fI\f(CI$lang\fI.info\-aspell\fR, containing base
name(s) of your compat and, if needed, contents file(s).  If
\&\f(CW\*(Aqauto\-compat\*(Aq\fR 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 \f(CW\*(Aqauto\-contents\*(Aq\fR entry is found, contents file at
\&\fIdebian/\fR 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 \f(CW\*(Aqauto\-contents\*(Aq\fR you usually will need only the same base name
enabled in \f(CW\*(Aqauto\-compat\*(Aq\fR.
.Sp
If you are interested in a simple install of a pristine aspell
dictionary with a minimal debian/rules please look at
\&\fBdh_aspell\-simple\fR\|(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.
.Sp
\&\fI/usr/lib/aspell/$dict.rws \-> /var/lib/aspell/$dict.rws\fR
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 \fIdictionaries\-common.checklist\fR).
.SH "OPTIONS"
.IX Header "OPTIONS"
The usual \fBdephelper\fR\|(1) options are accepted.
.SH "NOTES"
.IX Header "NOTES"
This program is not part of debhelper, although it is intended to be used
in aspell dictionary packages using debhelper in its
building.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(1),
dictionaries\-common.checklist,
dsdt\-policy.txt
.PP
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.
.SH "AUTHORS"
.IX Header "AUTHORS"
Rafael Laboissiere, Agustin Martin