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.

       replace  means  the  regular  expression  match  will  be  replaced  by the value, all the
       preceeding regular expressions will be  evaluated  against  the  original  text,  all  the
       following regular expressions will be evaluated against the replaced text

       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>

                                                                                         GRCAT(1)