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