grep: enable recurse-submodules to work on <tree> objects
[gitweb.git] / Documentation / git-grep.txt
index 17aa1ba702590d61090d793bcda78e1a86e5c4b8..71f32f35089241bc452cfdccdc6b3e9a30f95366 100644 (file)
@@ -26,7 +26,7 @@ SYNOPSIS
           [--threads <num>]
           [-f <file>] [-e] <pattern>
           [--and|--or|--not|(|)|-e <pattern>...]
-          [--recurse-submodules]
+          [--recurse-submodules] [--parent-basename <basename>]
           [ [--[no-]exclude-standard] [--cached | --no-index | --untracked] | <tree>...]
           [--] [<pathspec>...]
 
@@ -91,7 +91,16 @@ OPTIONS
 
 --recurse-submodules::
        Recursively search in each submodule that has been initialized and
-       checked out in the repository.
+       checked out in the repository.  When used in combination with the
+       <tree> option the prefix of all submodule output will be the name of
+       the parent project's <tree> object.
+
+--parent-basename <basename>::
+       For internal use only.  In order to produce uniform output with the
+       --recurse-submodules option, this option can be used to provide the
+       basename of a parent's <tree> object to a submodule so the submodule
+       can prefix its output with the parent's name rather than the SHA1 of
+       the submodule.
 
 -a::
 --text::