diff options
| author |  Thomas Rast <trast@student.ethz.ch> | 2011-08-30 11:21:07 +0200 |
|---|---|---|
| committer |  Junio C Hamano <gitster@pobox.com> | 2011-08-30 10:05:21 -0700 |
| commit | b15b5b10a75e202f3f90e000925545243267cbee (patch) | |
| tree | 0b018020c1dd468585240ca098362a4b67326b7f | |
| parent | whitespace: have SP on both sides of an assignment "=" (diff) | |
| download | tgif-b15b5b10a75e202f3f90e000925545243267cbee.tar.xz | |
Documentation: clarify effects of -- <path> arguments
'git log -- <path>' does not "show commits that affect the specified
paths" in a literal sense unless --full-history is given (for example,
a file that only existed on a side branch will turn up no commits at
all!).
Reword it to specify the actual intent of the filtering, and point to
the "History Simplification" section.
Signed-off-by: Thomas Rast <trast@student.ethz.ch>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
| -rw-r--r-- | Documentation/git-log.txt | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt index 59f8be0be3..771a3565bd 100644 --- a/Documentation/git-log.txt +++ b/Documentation/git-log.txt @@ -69,10 +69,13 @@ produced by --stat etc. its size is not included. [\--] <path>...:: - Show only commits that affect any of the specified paths. To - prevent confusion with options and branch names, paths may need - to be prefixed with "\-- " to separate them from options or - refnames. + Show only commits that are enough to explain how the files + that match the specified paths came to be. See "History + Simplification" below for details and other simplification + modes. ++ +To prevent confusion with options and branch names, paths may need to +be prefixed with "\-- " to separate them from options or refnames. include::rev-list-options.txt[] |