mirror of
https://github.com/git/git.git
synced 2025-12-23 12:14:22 +01:00
cd0f572477
By default git-last-modified(1) only shows information about paths at the root level. This can be confusing. Clarify the command's behavior in the documentation. Signed-off-by: Toon Claes <toon@iotcl.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
124 lines
3.2 KiB
Plaintext
124 lines
3.2 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.
|
|
See the section "NOTES ABOUT DEPTH" below for more details.
|
|
|
|
`-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.
|
|
Setting a positive value implies `--recursive`.
|
|
Cannot be combined with wildcards in the pathspec.
|
|
See the section "NOTES ABOUT DEPTH" below for more details.
|
|
|
|
`-z`::
|
|
Terminate each line with a _NUL_ 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
|
|
------------
|
|
|
|
NOTES ABOUT DEPTH
|
|
-----------------
|
|
|
|
By default this command only shows information about paths at the root level.
|
|
When a path that lives in a subtree is provided, information about the top-level
|
|
subtree is printed. For example:
|
|
|
|
------------
|
|
$ git last-modified -- sub/file
|
|
|
|
abcd1234abcd1234abcd1234abcd1234abcd1234 sub
|
|
------------
|
|
|
|
To get details about the exact path in a subtree, add option `--recursive`:
|
|
|
|
------------
|
|
$ git last-modified --recursive -- sub/file
|
|
|
|
5678abca5678abca5678abca5678abca5678abca sub/file
|
|
------------
|
|
|
|
This comes with a downside. When the path provided is a tree itself, with
|
|
option `--recursive` all paths in that subtree are printed too:
|
|
|
|
------------
|
|
$ git last-modified --recursive -- sub/subsub
|
|
|
|
1234cdef1234cdef1234cdef1234cdef1234cdef sub/subsub/a
|
|
3456cdef3456cdef3456cdef3456cdef3456cdef sub/subsub/b
|
|
5678abcd5678abcd5678abcd5678abcd5678abcd sub/subsub/c
|
|
------------
|
|
|
|
To stop this command from traversing deeper into trees, add option
|
|
`--max-depth=0`:
|
|
|
|
------------
|
|
$ git last-modified --recursive --max-depth=0 -- sub/subsub
|
|
|
|
3456def3456def3456def3456def3456def3456b sub/subsub
|
|
------------
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkgit:git-blame[1],
|
|
linkgit:git-log[1].
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|