6 git-grep - Print lines matching a pattern
13 [-a | --text] [-I] [-i | --ignore-case] [-w | --word-regexp]
14 [-v | --invert-match] [-h|-H] [--full-name]
15 [-E | --extended-regexp] [-G | --basic-regexp]
16 [-F | --fixed-strings] [-n]
17 [-l | --files-with-matches] [-L | --files-without-match]
18 [-c | --count] [--all-match]
19 [-A <post-context>] [-B <pre-context>] [-C <context>]
20 [-f <file>] [-e] <pattern>
21 [--and|--or|--not|(|)|-e <pattern>...] [<tree>...]
26 Look for specified patterns in the working tree files, blobs
27 registered in the index file, or given tree objects.
33 Instead of searching in the working tree files, check
34 the blobs registered in the index file.
38 Process binary files as if they were text.
42 Ignore case differences between the patterns and the
46 Don't match the pattern in binary files.
50 Match the pattern only at word boundary (either begin at the
51 beginning of a line, or preceded by a non-word character; end at
52 the end of a line or followed by a non-word character).
56 Select non-matching lines.
60 By default, the command shows the filename for each
61 match. `-h` option is used to suppress this output.
62 `-H` is there for completeness and does not do anything
63 except it overrides `-h` given earlier on the command
67 When run from a subdirectory, the command usually
68 outputs paths relative to the current directory. This
69 option forces paths to be output relative to the project
76 Use POSIX extended/basic regexp for patterns. Default
77 is to use basic regexp.
81 Use fixed strings for patterns (don't interpret pattern
85 Prefix the line number to matching lines.
88 --files-with-matches::
91 --files-without-match::
92 Instead of showing every matched line, show only the
93 names of files that contain (or do not contain) matches.
94 For better compatibility with git-diff, --name-only is a
95 synonym for --files-with-matches.
99 Instead of showing every matched line, show the number of
103 Show `context` trailing (`A` -- after), or leading (`B`
104 -- before), or both (`C` -- context) lines, and place a
105 line containing `--` between contiguous groups of
109 A shortcut for specifying -C<num>.
112 Read patterns from <file>, one per line.
115 The next parameter is the pattern. This option has to be
116 used for patterns starting with - and should be used in
117 scripts passing user input to grep. Multiple patterns are
124 Specify how multiple patterns are combined using Boolean
125 expressions. `--or` is the default operator. `--and` has
126 higher precedence than `--or`. `-e` has to be used for all
130 When giving multiple pattern expressions combined with `--or`,
131 this flag is specified to limit the match to files that
132 have lines to match all of them.
135 Search blobs in the trees for specified patterns.
138 Signals the end of options; the rest of the parameters
145 git grep -e \'#define\' --and \( -e MAX_PATH -e PATH_MAX \)::
146 Looks for a line that has `#define` and either `MAX_PATH` or
149 git grep --all-match -e NODE -e Unexpected::
150 Looks for a line that has `NODE` or `Unexpected` in
151 files that have lines that match both.
155 Originally written by Linus Torvalds <torvalds@osdl.org>, later
156 revamped by Junio C Hamano.
161 Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
165 Part of the linkgit:git[1] suite