NAME

       cg - Recursively grep for a pattern and store it.

SYNOPSIS

       cg [ -l ] | [ [ -i ] pattern [ files ] ]

DESCRIPTION

       cg  does  a  search  though  text  files  (usually source code) recursively for a pattern,
       storing matches and displaying the output in a human-readable fashion.  It is intended  to
       give  some of the functionally of AT&T's cscope(1) tool, with the advantages of simplicity
       and not being language-specific.  The script will colorize output if configured as such.

       It is typically run with a Perl regular expression to search for.  The search can be  made
       case  insensitive  by  using the -i option.  A list of files may also be specified with an
       additional argument after the pattern.  Put the files pattern in  quotes  to  make  it  be
       matched  by  Perl  rather  than  by  the shell.  Running the script with no arguments will
       recall the results of the previous search.  After the search, entries found can be  edited
       using the vg(1) script.  The -l option shows the last log made.

SOME EXAMPLES

       cg - alone recalls the previous search results.

       cg  -i  pattern - search the default list of files for all files matching the pattern (and
       case-insensitively).

       cg pattern '*.c' - search recursively for pattern in all *.c  files.   This  automatically
       converts '*' to '.*' and '.' to '\.' for you and does a Perl pattern match on all files in
       the tree.

       cg pattern *.c - search through  the  shell-expanded  list  of  *.c  files,  so  not  done
       recursively (in other words, only the files your shell pass to the script as arguments).

       cg -l - show the last log made.

COMMAND-LINE OPTIONS

       -i   Do a case-insensitive search.

       -l   Show the last log made.

       -p   Toggle  the  default  pager  option.   cg has a bulit-in pager function, which can be
            enabled or disabled by default (in .cgvgrc).  If the default is enabled, this  option
            disables the pager; if the default is disabled, this option enables it.

       -P   Force the built-in pager to be disabled.

FILES

       ${HOME}/.cglast
              Log file of the last search.

       ${HOME}/.cgvgrc
              Per-user configuration file (if the defaults are not desirable).

       ${HOME}/.cgvg/*
              Log files in $HOSTNAME.shell_pid form with the log of the last search.

SEE ALSO

       vg(1), perl(1), find(1), grep(1), cscope(1)

AUTHOR

       cg was written by Joshua Uziel <uzi@uzix.org>.

                                           13 Mar 2002                                      CG(1)