NAME¶
grcat - read from standard input, colourise it and write to standard output
SYNOPSIS¶
grcat configuration
DESCRIPTION¶
configuration is a name of a configuration file. Directories ~/.grc/,
/usr/local/share/grc/, /usr/share/grc/ are searched for the file (in this
order).
If the file is not found, it is assumed to be an absolute path of a
configuration file located elsewhere.
Configuration file consists of entries, one per regexp, entries are separated
with lines with first character non-alphanumeric (except #). Lines beginning
with # or empty lines are ignored.
Each entry consists of several lines. Each line has form:
keyword=value
where keyword is one of:
regexp,
colours,
command,
skip,
count. Only
regexp is mandatory, but it does not
have much sense by itself unless you specify at least a
colour or
command keyword as well.
regexp is the regular expression to match
colours is the list of colours, separated by commas (you can specify only
one colour), each colour per one regexp group specified in regexp.
command is command to be executed when regexp matches. Its output will be
mixed with normal stdout, use redirectors ( >/dev/null) if you want to
supress it.
skip can be either
yes, or
no, if yes, the matched line
will be skipped and not displayed in output. Default is no.
count is one of words:
once,
more, or
stop.
once means that if the regexp is matched, its first occurrence is
coloured and the program will continue with other regexp's.
more means that if there are multiple matches of the regexp in one line,
all of them will be coloured.
stop means that the regexp will be coloured and program will move to the
next line (i.e. ignoring other regexp's)
Regular expressions are evaluated from top to bottom, this allows nested and
overlapped expressions. (e.g. you colour everything inside parentheses with
one colour, and if a following expression matches the text inside parentheses,
it will be also coloured)
OPTIONS¶
None so far.
SEE ALSO¶
grc(1)
AUTHOR¶
Written by Radovan Garabík <garabik @
kassiopeia.juls.savba.sk>