mirror of
https://github.com/git/git.git
synced 2026-01-24 15:57:20 +09:00
9aeda2827b
By default git-last-modified(1) doesn't recurse into subtrees. So when
the pathspec contained a path in a subtree, the command would only print
the commit information about the parent tree of the path, like:
$ git last-modified -- path/file
aaa0aab1bbb2bcc3ccc4ddd5dde6eee7eff8fff9 path
Change the default behavior to give commit information about the exact
path instead:
$ git last-modified -- path/file
aaa0aab1bbb2bcc3ccc4ddd5dde6eee7eff8fff9 path/file
To achieve this, the default max-depth is changed to 0 and recursive is
always enabled.
The handling of option '-r' is modified to disable a max-depth,
resulting in the behavior of this option to remain unchanged.
No existing tests were modified, because there didn't exist any tests
covering the example above. But more tests are added to cover this now.
Signed-off-by: Toon Claes <toon@iotcl.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
82 lines
2.0 KiB
Plaintext
82 lines
2.0 KiB
Plaintext
git-last-modified(1)
|
|
====================
|
|
|
|
NAME
|
|
----
|
|
git-last-modified - EXPERIMENTAL: Show when files were last modified
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[synopsis]
|
|
git last-modified [--recursive] [--show-trees] [--max-depth=<depth>] [-z]
|
|
[<revision-range>] [[--] <path>...]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
Shows which commit last modified each of the relevant files and subdirectories.
|
|
A commit renaming a path, or changing it's mode is also taken into account.
|
|
|
|
THIS COMMAND IS EXPERIMENTAL. THE BEHAVIOR MAY CHANGE.
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
`-r`::
|
|
`--recursive`::
|
|
Instead of showing tree entries, step into subtrees and show all entries
|
|
inside them recursively.
|
|
This is identical as setting `--max-depth=-1`.
|
|
|
|
`-t`::
|
|
`--show-trees`::
|
|
Show tree entries even when recursing into them. It has no effect
|
|
without `--recursive`.
|
|
|
|
`--max-depth=<depth>`::
|
|
For each pathspec given on the command line, descend at most `<depth>`
|
|
levels of directories. A negative value means no limit.
|
|
The default depth is 0.
|
|
Cannot be combined with wildcards in the pathspec.
|
|
|
|
`-z`::
|
|
Terminate each line with a _NUL_ character rather than a newline.
|
|
|
|
`<revision-range>`::
|
|
Only traverse commits in the specified revision range. When no
|
|
`<revision-range>` is specified, it defaults to `HEAD` (i.e. the whole
|
|
history leading to the current commit). For a complete list of ways to
|
|
spell `<revision-range>`, see the 'Specifying Ranges' section of
|
|
linkgit:gitrevisions[7].
|
|
|
|
`[--] <path>...`::
|
|
For each _<path>_ given, the commit which last modified it is returned.
|
|
Without an optional path parameter, all files and subdirectories
|
|
in path traversal the are included in the output.
|
|
|
|
OUTPUT
|
|
------
|
|
|
|
The output is in the format:
|
|
|
|
------------
|
|
<oid> TAB <path> LF
|
|
------------
|
|
|
|
If a path contains any special characters, the path is C-style quoted. To
|
|
avoid quoting, pass option `-z` to terminate each line with a NUL.
|
|
|
|
------------
|
|
<oid> TAB <path> NUL
|
|
------------
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkgit:git-blame[1],
|
|
linkgit:git-log[1].
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|