.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" 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
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\"
.\" 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 "ACHECK.1 1"
.TH ACHECK.1 1 "2017-01-03" "perl v5.24.1" "User Contributed Perl Documentation"
.\" 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"
acheck \- Check common localization mistakes
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
acheck [\s-1OPTIONS\s0] [\s-1INPUT_FILE\s0]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This program parses a file checking for syntax rules and optionally asking
Aspell for checking word spelling. It makes fix suggestions and outputs a
corrected file accordingly adding review comments if requested.
.PP
It tries to find the file type according to the extension or the first lines
and loads rules accordingly.
.PP
It displays lines when they are parse.
.PP
When an error is found, a menu is displayed. Just press Enter if you don't want
to change anything. If a choice suits you, enter the corresponding number. If
you want to fix it but no choice is correct, enter a space, then you will be
asked for a string to replace the highlighted text. The script will replace the
highlighted text with your choice and parse it again for new errors.
.PP
Here are all the available commands:
.IP "\fIEnter\fR, ignore." 4
.IX Item "Enter, ignore."
Ignore.
.IP "\fICtrl+L\fR, redraw." 4
.IX Item "Ctrl+L, redraw."
Rewrite the last line, suggestions and hints.
.IP "\fISpace\fR, edit." 4
.IX Item "Space, edit."
Edit the highlighted text.
.IP "\fIE\fR, edit line." 4
.IX Item "E, edit line."
Edit the whole line.
.IP "\fIH\fR, add hint." 4
.IX Item "H, add hint."
Add the displayed hint as review comment. Use this if you want the translator
to see the corresponding warning or error but you have no correction.
.IP "\fIN\fR, next line." 4
.IX Item "N, next line."
Skip the rest of this line.
.IP "\fIX\fR, exit and discard all changes." 4
.IX Item "X, exit and discard all changes."
Quit without saving modifications, the script ask you for confirmation, you
have to enter `\fByes\fR' to exit otherwise parsing starts again at the current
mistake.
.IP "\fIa\fR, add in dictionary." 4
.IX Item "a, add in dictionary."
Add the highlighted word to you personal dictionary, capitalized as it is.
.IP "\fIl\fR, add lowercase in dictionary." 4
.IX Item "l, add lowercase in dictionary."
Lowercase the highlighted word to add it to your personal dictionary.
.IP "\fIi\fR, ignore word." 4
.IX Item "i, ignore word."
Ignore the highlighted word, same as \fIEnter\fR.
.IP "\fII\fR, ignore all." 4
.IX Item "I, ignore all."
Ignore the highlighted word and add it to your session dictionary.
.SH "OPTIONS"
.IX Header "OPTIONS"
Verbosity level:
.IP "\fI\-q\fR, \fI\-\-quiet\fR" 4
.IX Item "-q, --quiet"
quiet mode.
.IP "\fI\-v\fR" 4
.IX Item "-v"
verbose, start at level \fI\f(CI$Debug\fI + 1\fR, add more for more verbosity (see below).
.IP "\fI\-\-verbose n\fR" 4
.IX Item "--verbose n"
set verbosity level to \fIn\fR (see below).
.PP
Files:
.IP "\fI\-i\fR, \fI\-\-input\fR" 4
.IX Item "-i, --input"
input filename, can be '\fI\-\fR' to read data from standard input.
.IP "\fI\-o\fR, \fI\-\-output\fR" 4
.IX Item "-o, --output"
output filename, can be '\fI\-\fR' to write data to standard output. If no output
filename is provided, input file is backed up with `\fIbak_ext\fR' extension and
input filename is used.
.PP
Spell check:
.IP "\fI\-s\fR, \fI\-\-spell\fR" 4
.IX Item "-s, --spell"
check spelling with Aspell.
.IP "\fI\-d language\fR, \fI\-\-dict language\fR" 4
.IX Item "-d language, --dict language"
use \fIlanguage\fR dictionary for Aspell.
.IP "\fI\-n\fR, \fI\-\-nospell\fR" 4
.IX Item "-n, --nospell"
don't check spelling.
.PP
Mode:
.IP "\fI\-r\fR, \fI\-\-review\fR" 4
.IX Item "-r, --review"
review mode, add comments on lines beginning with \fI\f(CI$Comment\fI\fR after parsed
line.
.IP "\fI\-t\fR, \fI\-\-trans\fR" 4
.IX Item "-t, --trans"
translator mode, don't add comments, just fix errors.
.PP
others:
.IP "\fI\-\-rules ruleset\fR" 4
.IX Item "--rules ruleset"
use \fIruleset\fR rules set.
.IP "\fI\-\-type filetype\fR" 4
.IX Item "--type filetype"
use \fIfiletype\fR whatever the file type is.
.IP "\fI\-\-dump\fR" 4
.IX Item "--dump"
Dump the rules to check and exit, use this for debugging purposes.
.IP "\fI\-V\fR, \fI\-\-version\fR" 4
.IX Item "-V, --version"
print version and exit.
.IP "\fI\-h\fR, \fI\-\-help\fR" 4
.IX Item "-h, --help"
print a short usage message and exit.
.SS "Verbosity Level"
.IX Subsection "Verbosity Level"
.IP "\fI0\fR quiet, normal" 4
.IX Item "0 quiet, normal"
only warnings and errors
.IP "\fI1\fR debug" 4
.IX Item "1 debug"
names of subroutines
.IP "\fI2\fR debug verbose" 4
.IX Item "2 debug verbose"
names and arguments of subroutines
.IP "\fI3\fR .. \fI5\fR debug very verbose" 4
.IX Item "3 .. 5 debug very verbose"
output parsing and checking details
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIacheck\fR\|(5), \fIacheck\-rules\fR\|(5)
.SH "AUTHOR"
.IX Header "AUTHOR"
Nicolas Bertolissio <bertol@debian.org>