Elijah Newren <newren@xxxxxxxxx> writes: >> diff --git a/Documentation/config/grep.txt b/Documentation/config/grep.txt >> index 44abe45a7c..76689771aa 100644 >> --- a/Documentation/config/grep.txt >> +++ b/Documentation/config/grep.txt >> @@ -16,8 +16,11 @@ grep.extendedRegexp:: >> ... >> + Number of grep worker threads to use. See `--threads` in >> + linkgit:git-grep[1] for more information. >> ... >> diff --git a/Documentation/git-grep.txt b/Documentation/git-grep.txt >> index ddb6acc025..97e25d7b1b 100644 >> --- a/Documentation/git-grep.txt >> +++ b/Documentation/git-grep.txt >> @@ -41,34 +41,7 @@ characters. An empty string as search expression matches all lines. >> ... >> +include::config/grep.txt[] >> ... >> --threads <num>:: >> - Number of grep worker threads to use. >> - See `grep.threads` in 'CONFIGURATION' for more information. >> + Number of grep worker threads to use. If not provided (or set to >> + 0), Git will use as many worker threads as the number of logical >> + cores available. The default value can also be set with the >> + `grep.threads` configuration (see linkgit:git-config[1]). > > I'm possibly showing my ignorance here, but doesn't the > "include::config/grep.txt[]" you added above mean that the user > doesn't have to see an external manpage but can see the definition > earlier within this same manpage? I think so. Also, the new reference "See `--threads` in git-grep" added to grep.threads to config/grep.txt would become somewhat redundant in the context of "git grep --help" (only "See --threads" is relevant when it appears in this same manual page). Readers who finds the reference in "git config --help" still needs to see that --threads is an option to git-grep, though.
