grc(1) [debian man page]

GRC(1)							      General Commands Manual							    GRC(1)

NAME

       grc - frontend for generic colouriser grcat(1)

SYNOPSIS

       grc [options] command [args]

DESCRIPTION

       grc  will  execute  command  command  with optional parameters [args] piping its stdout or stderr into grcat, with apropriate configuration
       file.

       Configuration file for grc is determined by /etc/grc.conf file.

       Format of /etc/grc.conf: each entry consists of 2 lines, between entries there can be any number of empty lines or lines beginning  with  #
       (comments)

       First line is regular expression, second line the name of configuration file for grcat.

       Configuration file after the first regular expression matching command [args] will be passed to grcat as its configuration file

OPTIONS

       --help Show summary of options.

       --version
	      Display version.

       -e --stderr
	      Redirect error output. Unless -s is selected as well, this cancels redirection of standard output via grcat

       -s --stdout
	      Redirect standard output. Used to redirect standard output together with --stderr option.

       --colour=x
	      x is one of on off auto

	      --colour=on will colourise (default)

	      --colour=off will just execute command without colourising.

	      --colour=auto will test if standard output is a tty, and colourise only when it is.

SEE ALSO

       grcat(1)

AUTHOR

       Written by Radovan Garabik <garabik @ kassiopeia.juls.savba.sk>

																	    GRC(1)

GRCAT(1)						      General Commands Manual							  GRCAT(1)

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  reg-
       exp.

       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 Garabik <garabik @ kassiopeia.juls.savba.sk>

																	  GRCAT(1)