.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" 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-MYSPELL 1" .TH INSTALLDEB-MYSPELL 1 "2023-9-07" "1.29.7" " " .\" 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\-myspell \- debhelper\-like helper for Debian packages containing myspell/hunspell dictionaries or Openoffice.org thesauri/hyphenation files. .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& installdeb\-myspell [\-\-srcdir=dir] [options] [debhelper options] .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBinstalldeb-myspell\fR is a debhelper like program to help installing myspell/hunspell dicts as well as Openoffice.org thesauri or hyphenation files, after contents of an \&\fIinfo-myspell\fR file whose format is that for old Openoffice.org 2. This program may also create and install dictionaries in Chromium hunspell binary dic format (\fI.bdic\fR) if \fB\-\-bdic\fR option is set. All this needs the \fB\-\-srcdir\fR option enabled. .PP Note that unless \fB\-\-srcdir\fR option this program will do nothing. .PP For more details, see \fI/usr/share/doc/dictionaries\-common/dsdt\-policy.txt\fR. .PP The actions executed by \fBinstalldeb-myspell\fR are the following (only some of them are done if not in o2 compatibility mode): .IP "Maintainer Scripts" 4 .IX Item "Maintainer Scripts" \&\fBinstalldeb-myspell\fR installs the necessary scraps of code in the \fIpostinst\fR and \fIpostrm\fR scripts. No snippets are currently installed. .IP "Language info file" 4 .IX Item "Language info file" \&\fBinstalldeb-myspell\fR will look for a file named \fIdebian/info\-myspell\fR or \fIdebian/package.info\-myspell\fR. That file contains myspell/hunspell dictionary, \s-1OOO\s0 thesauri or hyphenation information with lines like .Sp \&\s-1TYPE LANG COUNTRY NAME\s0 .Sp A typical \fIinfo-myspell\fR file for a myspell/hunspell dictionary will contain something like .Sp .Vb 4 \& # Spanish variants \& DICT es ES es_ES \& DICT es AR es_ES \& ... .Ve .Sp while will, for a typical hyphenation file, be something like .Sp .Vb 2 \& # Danish hyphenation \& HYPH da DK hyph_da_DK .Ve .Sp or for a sample thesaurus, .Sp .Vb 1 \& THES en US th_en_US .Ve .Sp all with no leading whitespace. Commented lines are allowed. .IP "Dictionary, thesaurus and hyphenation files installation" 4 .IX Item "Dictionary, thesaurus and hyphenation files installation" If the \fB\-\-srcdir=dir\fR option is set \fBinstalldeb-myspell\fR will look for the \fI.aff/.dic\fR files in the directory specified by dir and install them in the default target directory (\fI[tmpdir]/usr/share/hunspell\fR). Base name will be extracted from the \fIinfo-myspell\fR 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. .Sp Same (but the renaming) for hyphenation and thesaurus files, to be installed in \&\fI[tmpdir]/usr/share/hyphen\fR and \fI[tmpdir]/usr/share/mythes\fR. .Sp If \fB\-\-bdic\fR option is set, dicts in Chromium hunspell binary dictionary format will also be created and installed. This requires /usr/lib/qt5/bin/qwebengine_convert_dict (from qt6\-webengine\-dev\-tools package) be available. .Sp If \fB\-\-bdic\-only\fR option is set, only dicts in Chromium hunspell binary dictionary format (\fI.bdic\fR) will be handled and dic, hyphen and thesaurus disabled (even if they have entries in \&\fIinfo-myspell\fR file). Equivalent to \fB\-\-bdic \-\-no\-dic \-\-no\-hyphen \-\-no\-thesaurus\fR. .Sp \&\fB\-\-no\-{dic,hyphen,thesaurus}\fR options are provided to disable handling of those files even if they have entries in \&\fIinfo-myspell\fR file. Mostly useful for testing. .Sp If \fB\-\-dc\-keep\fR is set, temporary files will be preserved once intallation is complete. Currently this only affects .bdic file. .Sp \&\fB\-\-bdic\fR, \fB\-\-bdic\-only\fR and \fB\-\-no\-{dic,hyphen,thesaurus}\fR options require at least dictionaries-common-dev 1.29.0. \&\fB\-\-dc\-clean\fR requires at least dictionaries-common-dev 1.29.3. .IP "Dictionaries alternative symlinks creation" 4 .IX Item "Dictionaries alternative symlinks creation" \&\fBinstalldeb-myspell\fR will, according to info extracted from the \fIinfo-myspell\fR, automatically set \fBlang_COUNTRY\fR symlinks to the dict files installed by \&\fBinstalldeb-myspell\fR. This will only be done when the \fB\-\-srcdir\fR option is used. .Sp If \fB\-\-srcdir\fR option is used and the \fIinfo-myspell\fR file contains something like .Sp .Vb 4 \& # Spanish variants \& DICT es ES es \& DICT es AR es \& ... .Ve .Sp \&\fBinstalldeb-myspell\fR will automatically set \fBes_ES\fR and \fBes_AR\fR symlinks. .Sp If \fI.bdic\fR is enabled, associated symlinks will be set in the same way. .IP "Mozilla spellchecker compatibility" 4 .IX Item "Mozilla spellchecker compatibility" For myspell/hunspell dictionaries, Mozilla had a \fBlang{,\-COUNTRY}\fR to names translation table using hyphens as separators (and for some languages not using country part at all) instead of lowbars. .Sp Shortly, that will no longer be the case. Mozilla will also accept \&\fBlang_COUNTRY\fR 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. .IP "Debconf files" 4 .IX Item "Debconf files" As opposed to \fBinstalldeb-ispell\fR and \fBinstalldeb-wordlist\fR, \fBinstalldeb-myspell\fR does nothing related to debconf files, not needed for myspell/hunspell dicts and \&\s-1OOO\s0 thesauri and hyphenation files. If you need to add debconf stuff with debhelper proceed in the usual way and call \fBdh_installdebconf\fR\|(1) as for any other package. .SH "OPTIONS" .IX Header "OPTIONS" \&\-\-dico\-debug Show some \fBinstalldeb-myspell\fR specific debugging info. Does not enable debhelper debug, you need to enable it separately. .PP \&\-\-srcdir=dir Will look for \fI.aff/.dic\fR files in the specified directory for myspell/hunspell dict packages, for \fI.dic\fR files in Openoffice.org hyphenation packages and for \fI.dat/.idx\fR 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. .PP \&\-\-dico\-{no\-}alt\-links {Process/Do not process} alternative symlinks according to info found in the myspell info file. .PP \&\-\-bdic Enable bdic handling. .PP \&\-\-bdic\-only Deal only with .bdic. Enable .bdic handling and disable {dic,hyphen,thesaurus} install. .PP \&\-\-no\-{dic,hyphen,thesaurus} Disable {dic,hyphen,thesaurus} handling. .PP The usual \fBdebhelper\fR\|(7) options are accepted. .SH "NOTES" .IX Header "NOTES" This program is not part of debhelper, although depends on and is intended to work together with it. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBdebhelper\fR\|(7) .PP 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. .SH "AUTHORS" .IX Header "AUTHORS" Rafael Laboissiere , Agustin Martin