git-grep: clarification on parameters.
authorJunio C Hamano <junkio@cox.net>
Fri, 20 Jan 2006 23:00:12 +0000 (15:00 -0800)
committerJunio C Hamano <junkio@cox.net>
Sun, 22 Jan 2006 03:34:11 +0000 (19:34 -0800)
commit5b2bcc7b2d546c636f79490655b3347acc91d17f
treee804c0964d6fe495f903eff1cd0acf3bebbf4e91
parent0bdd79af62e8621359af08f0afca0ce977348ac7
git-grep: clarification on parameters.

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>
Documentation/git-grep.txt
git-grep.sh