summaryrefslogtreecommitdiff
path: root/Documentation/git-last-modified.adoc
blob: d7d16fc4f73e6621ff816e658c8fddf230f680dd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
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>] [[--] <pathspec>...]

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`::
	Recursively traverse into all subtrees. By default, the command only
	shows tree entries matching the `<pathspec>`. With this option, it
	descends into subtrees and displays all entries within them.
	Equivalent to `--max-depth=-1`.

`-t`::
`--show-trees`::
	Show tree entries even when recursing into them.

`--max-depth=<depth>`::
	For each pathspec given on the command line, traverse at most `<depth>`
	levels into subtrees. A negative value means no limit.
	The default is 0, which shows all paths matching the pathspec
	without descending into subtrees.

`-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].

`[--] <pathspec>...`::
	Show the commit that last modified each path matching _<pathspec>_.
	If no _<pathspec>_ is given, all files and subdirectories are included.
	See linkgit:gitglossary[7] for details on pathspec syntax.

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