grep
====

:Purpose: Print lines matching PATTERN for specified files and revisions.
:Usage:   brz grep PATTERN [PATH...]

:Options:
  --color=WHEN          Show match in color. WHEN is never, always or auto.
  -p, --diff            Grep for pattern in changeset for each revision.
  -X GLOB, --exclude=GLOB
                        Skip files whose base name matches GLOB.
  -l, --files-with-matches
                        Print only the name of each input file in which
                        PATTERN is found.
  -L, --files-without-match
                        Print only the name of each input file in which
                        PATTERN is not found.
  -F, --fixed-string    Interpret PATTERN is a single fixed string (not
                        regex).
  --from-root           Search for pattern starting from the root of the
                        branch. (implies --recursive)
  -h, --help            Show help message.
  -i, --ignore-case     Ignore case distinctions while matching.
  -I GLOB, --include=GLOB
                        Search only files whose base name matches GLOB.
  --levels=N            Number of levels to display - 0 for all, 1 for
                        collapsed (1 is default).
  -n, --line-number     Show 1-based line number.
  --no-recursive        Don't recurse into subdirectories. (default is
                        --recursive)
  -Z, --null            Write an ASCII NUL (\0) separator between output lines
                        rather than a newline.
  -q, --quiet           Only display errors and warnings.
  -r ARG, --revision=ARG
                        See "help revisionspec" for details.
  --usage               Show usage message and options.
  -v, --verbose         Display more information.

:Description:
  This command searches the specified files and revisions for a given
  pattern.  The pattern is specified as a Python regular expressions[1].
  
  If the file name is not specified, the revisions starting with the
  current directory are searched recursively. If the revision number is
  not specified, the working copy is searched. To search the last committed
  revision, use the '-r -1' or '-r last:1' option.
  
  Unversioned files are not searched unless explicitly specified on the
  command line. Unversioned directores are not searched.
  
  When searching a pattern, the output is shown in the 'filepath:string'
  format. If a revision is explicitly searched, the output is shown as
  'filepath~N:string', where N is the revision number.
  
  --include and --exclude options can be used to search only (or exclude
  from search) files with base name matches the specified Unix style GLOB
  pattern.  The GLOB pattern an use *, ?, and [...] as wildcards, and \
  to quote wildcard or backslash character literally. Note that the glob
  pattern is not a regular expression.
  
  [1] http://docs.python.org/library/re.html#regular-expression-syntax