mirror of https://github.com/garabik/grc.git
77 lines
1.4 KiB
Groff
77 lines
1.4 KiB
Groff
.TH GRC 1
|
|
.SH NAME
|
|
grc \- frontend for generic colouriser
|
|
.BR grcat "(1)
|
|
.SH SYNOPSIS
|
|
.B grc
|
|
.I [options] "command [args]"
|
|
.SH DESCRIPTION
|
|
.BR grc
|
|
will execute command
|
|
.I "command"
|
|
with optional parameters
|
|
.I "[args]"
|
|
piping its stdout or stderr into
|
|
.BR grcat ",
|
|
with appropriate configuration file.
|
|
|
|
Configuration file for
|
|
.BR 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
|
|
.BR grcat ".
|
|
|
|
Configuration file after the first regular expression matching
|
|
.I "command [args]"
|
|
will be passed to
|
|
.BR grcat
|
|
as its configuration file
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-\-help
|
|
Show summary of options.
|
|
.TP
|
|
.B \-\-version
|
|
Display version.
|
|
.TP
|
|
.B \-e \-\-stderr
|
|
Redirect error output. Unless
|
|
.B -s
|
|
is selected as well, this cancels redirection of standard output via
|
|
.BR grcat
|
|
.TP
|
|
.B \-s \-\-stdout
|
|
Redirect standard output. Used to redirect standard output
|
|
together with
|
|
.B \-\-stderr
|
|
option.
|
|
.TP
|
|
.B \-\-colour=x
|
|
x is one of
|
|
.I on
|
|
.I off
|
|
.I auto
|
|
|
|
.B \-\-colour=on
|
|
will colourise (default)
|
|
|
|
.B \-\-colour=off
|
|
will just execute
|
|
.I command
|
|
without colourising.
|
|
|
|
.B \-\-colour=auto
|
|
will test if standard output is a tty, and colourise only when it is.
|
|
|
|
.SH SEE ALSO
|
|
.BR grcat "(1)
|
|
.SH AUTHOR
|
|
Written by Radovan Garab\('ik <garabik @ kassiopeia.juls.savba.sk>
|