Skip to content

Commit

Permalink
Documentation: clarify effects of -- <path> arguments
Browse files Browse the repository at this point in the history
'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>
  • Loading branch information
Thomas Rast authored and Junio C Hamano committed Aug 30, 2011
1 parent cd2b8ae commit b15b5b1
Showing 1 changed file with 7 additions and 4 deletions.
11 changes: 7 additions & 4 deletions Documentation/git-log.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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[]

Expand Down

0 comments on commit b15b5b1

Please sign in to comment.