Differences

This shows you the differences between two versions of the page.

--- git_grep [2018/05/23 18:17] – [Overview] rpjday
+++ git_grep [2018/05/27 13:30] (current) – [Popular options] rpjday
@@ Line 3: / Line 3: @@
 How to use ''git grep'' to search only tracked files, or tracked and new files, etc.
-Config options:
+===== SYNOPSIS =====
+<code>
+$ git grep
+  [-a | --text] [-I] [--textconv] [-i | --ignore-case] [-w | --word-regexp]
+  [-v | --invert-match] [-h|-H] [--full-name]
+  [-E | --extended-regexp] [-G | --basic-regexp]
+  [-P | --perl-regexp]
+  [-F | --fixed-strings] [-n | --line-number]
+  [-l | --files-with-matches] [-L | --files-without-match]
+  [(-O | --open-files-in-pager) [<pager>]]
+  [-z | --null]
+  [-c | --count] [--all-match] [-q | --quiet]
+  [--max-depth <depth>]
+  [--color[=<when>] | --no-color]
+  [--break] [--heading] [-p | --show-function]
+  [-A <post-context>] [-B <pre-context>] [-C <context>]
+  [-W | --function-context]
+  [--threads <num>]
+  [-f <file>] [-e] <pattern>
+  [--and|--or|--not|(|)|-e <pattern>...]
+  [--recurse-submodules] [--parent-basename <basename>]
+  [ [--[no-]exclude-standard] [--cached | --no-index | --untracked] | <tree>...]
+  [--] [<pathspec>...]
+</code>
+NOTE: If you don't specify a ''<pathspec>'' to search, it (apparently) defaults to the current working directory -- this is not obvious from the man page.
+===== Config options =====
   * ''grep.lineNumber''
@@ Line 13: / Line 41: @@
 ===== Popular options =====
+In addition to many standard ''grep'' options:
 <code>
@@ Line 18: / Line 48: @@
     Instead of searching tracked files in the working tree, search
     blobs registered in the index file.
---no-index
-    Search files in the current directory that is not managed by Git.
 --untracked
@@ Line 29: / Line 56: @@
     Also search in ignored files by not honoring the .gitignore
     mechanism. Only useful with --untracked.
+</code>
---exclude-standard
+===== Examples =====
-    Do not pay attention to ignored files specified via the
-    .gitignore mechanism. Only useful when searching files in the
+Search a subdirectory:
-    current directory with --no-index.
+<code>
+$ git grep -il torvalds -- scripts/
+scripts/checkstack.pl
+scripts/get_maintainer.pl
+scripts/package/mkdebian
+$
 </code>