mirror of
https://github.com/git/git
synced 2024-09-13 21:34:42 +00:00
5b2bcc7b2d
We forgot to make sure that there is no more than one pattern parameter. Also when looking for files in a directory called '--others', it passed that path limiter without preceding the end-of-options marker '--' to underlying git-ls-files, which misunderstood it as one of its options instead. $ git grep --others -e Meta/Make Meta $ git grep -o -e Meta/Make Meta $ git grep -o Meta/Make Meta look for a string "Meta/Make" from untracked files in Meta/ directory. $ git grep Meta/Make --others looks for the same string from tracked files in ./--others directory. On the other hand, $ git grep -e Meta/Make --others does not have a freestanding pattern, so everybody is parameter and there is no path specifier. It looks for the string in all the untracked files without any path limiter. [jc: updated with usability enhancements and documentation cleanups from Sean.] Signed-off-by: Junio C Hamano <junkio@cox.net>
57 lines
1.1 KiB
Plaintext
57 lines
1.1 KiB
Plaintext
git-grep(1)
|
|
===========
|
|
|
|
NAME
|
|
----
|
|
git-grep - print lines matching a pattern
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
'git-grep' [<option>...] [-e] <pattern> [--] [<path>...]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Searches list of files `git-ls-files` produces for lines
|
|
containing a match to the given pattern.
|
|
|
|
|
|
OPTIONS
|
|
-------
|
|
`--`::
|
|
Signals the end of options; the rest of the parameters
|
|
are <path> limiters.
|
|
|
|
<option>...::
|
|
Either an option to pass to `grep` or `git-ls-files`.
|
|
|
|
The following are the specific `git-ls-files` options
|
|
that may be given: `-o`, `--cached`, `--deleted`, `--others`,
|
|
`--killed`, `--ignored`, `--modified`, `--exclude=*`,
|
|
`--exclude-from=*`, and `--exclude-per-directory=*`.
|
|
|
|
All other options will be passed to `grep`.
|
|
|
|
<pattern>::
|
|
The pattern to look for. The first non option is taken
|
|
as the pattern; if your pattern begins with a dash, use
|
|
`-e <pattern>`.
|
|
|
|
<path>...::
|
|
Optional paths to limit the set of files to be searched;
|
|
passed to `git-ls-files`.
|
|
|
|
|
|
Author
|
|
------
|
|
Written by Linus Torvalds <torvalds@osdl.org>
|
|
|
|
Documentation
|
|
--------------
|
|
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
|
|
|
|
GIT
|
|
---
|
|
Part of the gitlink:git[7] suite
|
|
|