| 1 | git-last-modified(1) |
| 2 | ==================== |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | git-last-modified - EXPERIMENTAL: Show when files were last modified |
| 7 | |
| 8 | |
| 9 | SYNOPSIS |
| 10 | -------- |
| 11 | [synopsis] |
| 12 | git last-modified [--recursive] [--show-trees] [--max-depth=<depth>] [-z] |
| 13 | [<revision-range>] [[--] <pathspec>...] |
| 14 | |
| 15 | DESCRIPTION |
| 16 | ----------- |
| 17 | |
| 18 | Shows which commit last modified each of the relevant files and subdirectories. |
| 19 | A commit renaming a path, or changing it's mode is also taken into account. |
| 20 | |
| 21 | THIS COMMAND IS EXPERIMENTAL. THE BEHAVIOR MAY CHANGE. |
| 22 | |
| 23 | OPTIONS |
| 24 | ------- |
| 25 | |
| 26 | `-r`:: |
| 27 | `--recursive`:: |
| 28 | Recursively traverse into all subtrees. By default, the command only |
| 29 | shows tree entries matching the `<pathspec>`. With this option, it |
| 30 | descends into subtrees and displays all entries within them. |
| 31 | Equivalent to `--max-depth=-1`. |
| 32 | |
| 33 | `-t`:: |
| 34 | `--show-trees`:: |
| 35 | Show tree entries even when recursing into them. |
| 36 | |
| 37 | `--max-depth=<depth>`:: |
| 38 | For each pathspec given on the command line, traverse at most `<depth>` |
| 39 | levels into subtrees. A negative value means no limit. |
| 40 | The default is 0, which shows all paths matching the pathspec |
| 41 | without descending into subtrees. |
| 42 | |
| 43 | `-z`:: |
| 44 | Terminate each line with a _NUL_ character rather than a newline. |
| 45 | |
| 46 | `<revision-range>`:: |
| 47 | Only traverse commits in the specified revision range. When no |
| 48 | `<revision-range>` is specified, it defaults to `HEAD` (i.e. the whole |
| 49 | history leading to the current commit). For a complete list of ways to |
| 50 | spell `<revision-range>`, see the 'Specifying Ranges' section of |
| 51 | linkgit:gitrevisions[7]. |
| 52 | |
| 53 | `[--] <pathspec>...`:: |
| 54 | Show the commit that last modified each path matching _<pathspec>_. |
| 55 | If no _<pathspec>_ is given, all files and subdirectories are included. |
| 56 | See linkgit:gitglossary[7] for details on pathspec syntax. |
| 57 | |
| 58 | OUTPUT |
| 59 | ------ |
| 60 | |
| 61 | The output is in the format: |
| 62 | |
| 63 | ------------ |
| 64 | <oid> TAB <path> LF |
| 65 | ------------ |
| 66 | |
| 67 | If a path contains any special characters, the path is C-style quoted. To |
| 68 | avoid quoting, pass option `-z` to terminate each line with a NUL. |
| 69 | |
| 70 | ------------ |
| 71 | <oid> TAB <path> NUL |
| 72 | ------------ |
| 73 | |
| 74 | SEE ALSO |
| 75 | -------- |
| 76 | linkgit:git-blame[1], |
| 77 | linkgit:git-log[1]. |
| 78 | |
| 79 | GIT |
| 80 | --- |
| 81 | Part of the linkgit:git[1] suite |