.\" 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.5 5" .TH ACHECK.5 5 "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 \- Acheck configuration file .SH "DESCRIPTION" .IX Header "DESCRIPTION" This is the configuration file for acheck. If it exists, it must be at the top of your home directory (\fI\f(CI$HOME\fI\fR). This file is optional unless you don't want to use default values. .PP Lines beginning with a number sign (`\fB#\fR') and empty lines will be ignored. Spaces at the beginning and the end of a line will also be ignored as well as tabulators. If you need spaces at the end or the beginning of a value you can use apostrophes (`\fB"\fR'). An option line starts with it's name followed by a value. An equal sign is optional. A comment starts with the number sign, there can be any number of spaces and/or tab stops in front of the #. Some possible examples: .PP .Vb 4 \& # this line is ignored \& option value \& option = value # this is a comment \& option "value ending with space " .Ve .PP You have to escape number signs with a backslash (`\fB\e\fR') to use it in a value. .PP Default values are provided into square brackets, they should be suitable for most installations. .SH "SPELLING" .IX Header "SPELLING" Define if you want to use ispell for checking spelling and how to use it. .IP "\fIcheck_spelling\fR" 4 .IX Item "check_spelling" use Aspell for spelling if set to `\fByes\fR' [yes] .IP "\fIdictionary\fR" 4 .IX Item "dictionary" Language dictionary to use with Aspell, use default if empty [empty] .IP "\fIword_letters\fR" 4 .IX Item "word_letters" regular expression to define characters allowed to write a word, pattern matches according locale [\ew] .IP "\fI\f(CI$review_mode\fI\fR" 4 .IX Item "$review_mode" set to `\fByes\fR' if you want review comments to be added in the output file after parsed line, otherwise just fix error [no] .SH "COLORS" .IX Header "COLORS" Set text colors for clear presentation. .PP The recognized colors (all of which should be fairly intuitive) are: \fBclear\fR, \&\fBreset\fR, \fBdark\fR, \fBbold\fR, \fBunderline\fR, \fBunderscore\fR, \fBblink\fR, \fBreverse\fR, \&\fBconcealed\fR, \fBblack\fR, \fBred\fR, \fBgreen\fR, \fByellow\fR, \fBblue\fR, \fBmagenta\fR, \&\fBcyan\fR, \fBwhite\fR, \fBon_black\fR, \fBon_red\fR, \fBon_green\fR, \fBon_yellow\fR, \&\fBon_blue\fR, \fBon_magenta\fR, \fBon_cyan\fR, and \fBon_white\fR. Case is not significant. Underline and underscore are equivalent, as are clear and reset, so use whichever is the most intuitive to you. The \fIcolor\fR alone sets the foreground color, and \fIon_color\fR sets the background color. .PP Note that not all colors are supported by all terminal types, and some terminals may not support any of these sequences. Dark, blink, and concealed in particular are frequently not implemented. .IP "\fIerror_color\fR" 4 .IX Item "error_color" color used to highlight errors, this should highlight space characters [bold on_red] .IP "\fIfix_color\fR" 4 .IX Item "fix_color" color used to highlight suggestions, this should highlight space characters [bold on_green] .IP "\fIerror_head_color\fR" 4 .IX Item "error_head_color" color used to display the error line header [bold red] .IP "\fIerror_color\fR" 4 .IX Item "error_color" color used to display the suggestion line header [bold green] .IP "\fIcomment_color\fR" 4 .IX Item "comment_color" color used for comments and hints [cyan] .SH "OTHERS" .IX Header "OTHERS" .IP "\fIbak_ext\fR" 4 .IX Item "bak_ext" extension for backup files [bak] .IP "\fIcomment\fR" 4 .IX Item "comment" comment string for review [>> ] .IP "\fIdebug\fR" 4 .IX Item "debug" verbosity level [0] .PP Verbosity Levels: .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\|(1), \fIacheck\-rules\fR\|(5) .SH "AUTHOR" .IX Header "AUTHOR" Nicolas Bertolissio