bionic (1) grcat.1.gz

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, concat, 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)