DESCRIPTIONThis is the configuration file for acheck. If it exists, it must be at the top of your home directory ($HOME). This file is optional unless you don't want to use default values.
Lines beginning with a number sign (`#') 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 (`"'). 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:
# this line is ignored option value option = value # this is a comment option "value ending with space "
You have to escape number signs with a backslash (`\') to use it in a value.
Default values are provided into square brackets, they should be suitable for most installations.
SPELLINGDefine if you want to use ispell for checking spelling and how to use it.
- use Aspell for spelling if set to `yes' [yes]
- Language dictionary to use with Aspell, use default if empty [empty]
- regular expression to define characters allowed to write a word, pattern matches according locale [\w]
- set to `yes' if you want review comments to be added in the output file after parsed line, otherwise just fix error [no]
COLORSSet text colors for clear presentation.
The recognized colors (all of which should be fairly intuitive) are: clear, reset, dark, bold, underline, underscore, blink, reverse, concealed, black, red, green, yellow, blue, magenta, cyan, white, on_black, on_red, on_green, on_yellow, on_blue, on_magenta, on_cyan, and on_white. Case is not significant. Underline and underscore are equivalent, as are clear and reset, so use whichever is the most intuitive to you. The color alone sets the foreground color, and on_color sets the background color.
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.
- color used to highlight errors, this should highlight space characters [bold on_red]
- color used to highlight suggestions, this should highlight space characters [bold on_green]
- color used to display the error line header [bold red]
- color used to display the suggestion line header [bold green]
- color used for comments and hints [cyan]
- extension for backup files [bak]
- comment string for review [>> ]
- verbosity level 
- 0 quiet, normal
- only warnings and errors
- 1 debug
- names of subroutines
- 2 debug verbose
- names and arguments of subroutines
- 3 .. 5 debug very verbose
- output parsing and checking details
AUTHORNicolas Bertolissio <[email protected]>