.\" colorit.1 -- 
.\" Created: Tue, 28 Oct 2003 22:19:36 +0200
.\"  by Aleksey Cheusov <vle@gmx.net>

.TH COLORIT 1 "28 Oct 2003" "" ""
.SH "NAME"
colorit \- a script for markuping the text input
.SH "SYNOPSIS"
.nf
.BI colorit " [OPTIONS] [files...]"
.fi
.SH "DESCRIPTION"
.B colorit
is a script for markuping text input and sending a result to
stdout.
Markuping rules are described in a configuration file
which is filtered by preprocessor (the default is
.I m4
).
The define HOME equal to your home directory is set for the preprocessor
using \-D option supported by both
.I m4
and
.I cpp.
This script can be used for colorizing the text by
ANSI escape sequences, or making a simple text conversions
and may be used for colorizing output of
.I dict
or other programs. In particular, log files,
.I dict,
.I cc,
.I make,
or
.I diff
output can easily be colorized and viewed.
.SH "OPTIONS"
.TP
.BR \-V " or " \-\-version
Shows version information.
.TP
.BR \-h " or " \-\-help
Shows help information.
.TP
.BI \-c " file\fR or "  \-\-config " file"
Specify configuration file.  The default is
.I ~/.coloritrc
or
.I /etc/dictd/colorit.conf
.TP
.BI \-\-pp " preprocessor"
Specify a preprocessor (- for none).
.SH "FILES"
.TP
.I ~/.coloritrc
User's
.B colorit
configuration file
.TP
.I /etc/dictd/colorit.conf
System
.B colorit
configuration file
.SH "CONFIG FILE"
Empty lines or lines beginning with sharp sign (`#')
are ignored. All other lines have this structure:
.I command arg1 arg2 ... argN.
All commands are processed one-by-one for each input line.
.br
.I args
strings can be surrounded by double-quote
characters.
.br
Currently, only
.I mark
command is available
having the following arguments:
.I regexp pre_string post_string
.br
The
.I pre_string
and
.I post_string
are inserted at the beginning and the end of substring matched
by regular expression
.I regexp
.SH "BUGS"
The only supported escape sequence in the strings surrounded by double quotes
is \\033.
.SH "SEE ALSO"
.BR less (1),
.BR m4 (1),
.BR cpp (1),
.BR dict (1)