index 3373c2636a879848fb789fc76c1ea031a3af95f0..34cf4e5811d1a6f46fcbd333a2ff48c200eadff8 100644 (file)
SYNOPSIS
--------
SYNOPSIS
--------
-'git log' <option>...
+'git log' [<options>] [<since>..<until>] [[\--] <path>...]
DESCRIPTION
-----------
Shows the commit logs.
DESCRIPTION
-----------
Shows the commit logs.
-The command takes options applicable to the `git-rev-list`
+The command takes options applicable to the 'git-rev-list'
command to control what is shown and how, and options applicable to
command to control what is shown and how, and options applicable to
-the `git-diff-*` commands to control how the changes
+the 'git-diff-*' commands to control how the changes
each commit introduces are shown.
each commit introduces are shown.
--decorate::
Print out the ref names of any commits that are shown.
--decorate::
Print out the ref names of any commits that are shown.
+--source::
+ Print out the ref name given on the command line by which each
+ commit was reached.
+
--full-diff::
--full-diff::
- Without this flag, "git log -p <paths>..." shows commits that
+ Without this flag, "git log -p <path>..." shows commits that
touch the specified paths, and diffs about the same specified
paths. With this, the full diff is shown for commits that touch
touch the specified paths, and diffs about the same specified
paths. With this, the full diff is shown for commits that touch
- the specified paths; this means that "<paths>..." limits only
+ the specified paths; this means that "<path>..." limits only
commits, and doesn't limit diff for those commits.
--follow::
commits, and doesn't limit diff for those commits.
--follow::
Note that only message is considered, if also a diff is shown
its size is not included.
Note that only message is considered, if also a diff is shown
its size is not included.
-<paths>...::
- Show only commits that affect the specified paths.
+[\--] <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.
include::rev-list-options.txt[]
include::rev-list-options.txt[]