| 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 |