Skip to content

Commit b15b5b1

Browse files
trastgitster
authored andcommitted
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 <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent cd2b8ae commit b15b5b1

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

Documentation/git-log.txt

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -69,10 +69,13 @@ produced by --stat etc.
6969
its size is not included.
7070

7171
[\--] <path>...::
72-
Show only commits that affect any of the specified paths. To
73-
prevent confusion with options and branch names, paths may need
74-
to be prefixed with "\-- " to separate them from options or
75-
refnames.
72+
Show only commits that are enough to explain how the files
73+
that match the specified paths came to be. See "History
74+
Simplification" below for details and other simplification
75+
modes.
76+
+
77+
To prevent confusion with options and branch names, paths may need to
78+
be prefixed with "\-- " to separate them from options or refnames.
7679

7780
include::rev-list-options.txt[]
7881

0 commit comments

Comments
 (0)