]>
Commit | Line | Data |
---|---|---|
215a7ad1 JH |
1 | git-log(1) |
2 | ========== | |
3f971fc4 JH |
3 | |
4 | NAME | |
5 | ---- | |
215a7ad1 | 6 | git-log - Show commit logs |
3f971fc4 JH |
7 | |
8 | ||
9 | SYNOPSIS | |
10 | -------- | |
7791a1d9 | 11 | [verse] |
b1524ee0 | 12 | 'git log' [<options>] [<since>..<until>] [[\--] <path>...] |
3f971fc4 JH |
13 | |
14 | DESCRIPTION | |
15 | ----------- | |
e51c3b50 JH |
16 | Shows the commit logs. |
17 | ||
0b444cdb | 18 | The command takes options applicable to the 'git rev-list' |
e51c3b50 | 19 | command to control what is shown and how, and options applicable to |
0b444cdb | 20 | the 'git diff-*' commands to control how the changes |
e51c3b50 JH |
21 | each commit introduces are shown. |
22 | ||
3f971fc4 JH |
23 | |
24 | OPTIONS | |
25 | ------- | |
5d1faf87 | 26 | |
3f971fc4 | 27 | <since>..<until>:: |
99e09cce JH |
28 | Show only commits between the named two commits. When |
29 | either <since> or <until> is omitted, it defaults to | |
30 | `HEAD`, i.e. the tip of the current branch. | |
41a5564e | 31 | For a more complete list of ways to spell <since> |
9d83e382 | 32 | and <until>, see linkgit:gitrevisions[7]. |
3f971fc4 | 33 | |
4ded6916 EB |
34 | --follow:: |
35 | Continue listing the history of a file beyond renames | |
36 | (works only for a single file). | |
37 | ||
8a3d203b JH |
38 | --no-decorate:: |
39 | --decorate[=short|full|no]:: | |
33e7018c LH |
40 | Print out the ref names of any commits that are shown. If 'short' is |
41 | specified, the ref name prefixes 'refs/heads/', 'refs/tags/' and | |
42 | 'refs/remotes/' will not be printed. If 'full' is specified, the | |
43 | full ref name (including prefix) will be printed. The default option | |
44 | is 'short'. | |
56822cc9 | 45 | |
30c4d7a7 NS |
46 | --source:: |
47 | Print out the ref name given on the command line by which each | |
48 | commit was reached. | |
49 | ||
ea57bc0d AP |
50 | --use-mailmap:: |
51 | Use mailmap file to map author and committer names and email | |
52 | to canonical real names and email addresses. See | |
53 | linkgit:git-shortlog[1]. | |
54 | ||
2e88c266 | 55 | --full-diff:: |
f448e24e | 56 | Without this flag, "git log -p <path>..." shows commits that |
2e88c266 JN |
57 | touch the specified paths, and diffs about the same specified |
58 | paths. With this, the full diff is shown for commits that touch | |
f448e24e | 59 | the specified paths; this means that "<path>..." limits only |
2e88c266 | 60 | commits, and doesn't limit diff for those commits. |
b1c7946d MG |
61 | + |
62 | Note that this affects all diff-based output types, e.g. those | |
63 | produced by --stat etc. | |
2e88c266 | 64 | |
9fa3465d MC |
65 | --log-size:: |
66 | Before the log message print out its size in bytes. Intended | |
2de9b711 | 67 | mainly for porcelain tools consumption. If Git is unable to |
9fa3465d MC |
68 | produce a valid value size is set to zero. |
69 | Note that only message is considered, if also a diff is shown | |
70 | its size is not included. | |
71 | ||
b1524ee0 | 72 | [\--] <path>...:: |
b15b5b10 TR |
73 | Show only commits that are enough to explain how the files |
74 | that match the specified paths came to be. See "History | |
75 | Simplification" below for details and other simplification | |
76 | modes. | |
77 | + | |
78 | To prevent confusion with options and branch names, paths may need to | |
79 | be prefixed with "\-- " to separate them from options or refnames. | |
e51c3b50 | 80 | |
f98fd436 MG |
81 | include::rev-list-options.txt[] |
82 | ||
83 | include::pretty-formats.txt[] | |
84 | ||
4ded6916 | 85 | Common diff options |
f98fd436 | 86 | ------------------- |
4ded6916 EB |
87 | |
88 | :git-log: 1 | |
89 | include::diff-options.txt[] | |
331b51d2 | 90 | |
272bd3cf | 91 | include::diff-generate-patch.txt[] |
331b51d2 | 92 | |
bd663611 LT |
93 | Examples |
94 | -------- | |
5d2fc913 | 95 | `git log --no-merges`:: |
bd663611 LT |
96 | |
97 | Show the whole commit history, but skip any merges | |
98 | ||
5d2fc913 | 99 | `git log v2.6.12.. include/scsi drivers/scsi`:: |
bd663611 LT |
100 | |
101 | Show all commits since version 'v2.6.12' that changed any file | |
102 | in the include/scsi or drivers/scsi subdirectories | |
103 | ||
6cf378f0 | 104 | `git log --since="2 weeks ago" -- gitk`:: |
bd663611 LT |
105 | |
106 | Show the changes during the last two weeks to the file 'gitk'. | |
107 | The "--" is necessary to avoid confusion with the *branch* named | |
108 | 'gitk' | |
109 | ||
5d2fc913 | 110 | `git log --name-status release..test`:: |
e51c3b50 JH |
111 | |
112 | Show the commits that are in the "test" branch but not yet | |
113 | in the "release" branch, along with the list of paths | |
114 | each commit modifies. | |
bd663611 | 115 | |
5d2fc913 | 116 | `git log --follow builtin-rev-list.c`:: |
4f50f6a9 SW |
117 | |
118 | Shows the commits that changed builtin-rev-list.c, including | |
119 | those commits that occurred before the file was given its | |
120 | present name. | |
121 | ||
5d2fc913 | 122 | `git log --branches --not --remotes=origin`:: |
d08bae7e IL |
123 | |
124 | Shows all commits that are in any of local branches but not in | |
0e615b25 | 125 | any of remote-tracking branches for 'origin' (what you have that |
d08bae7e IL |
126 | origin doesn't). |
127 | ||
5d2fc913 | 128 | `git log master --not --remotes=*/master`:: |
d08bae7e IL |
129 | |
130 | Shows all commits that are in local master but not in any remote | |
131 | repository master branches. | |
132 | ||
5d2fc913 | 133 | `git log -p -m --first-parent`:: |
88d9d45d PB |
134 | |
135 | Shows the history including change diffs, but only from the | |
136 | "main branch" perspective, skipping commits that come from merged | |
137 | branches, and showing full diffs of changes introduced by the merges. | |
138 | This makes sense only when following a strict policy of merging all | |
139 | topic branches when staying on a single integration branch. | |
140 | ||
70c2a258 NTND |
141 | `git log -3`:: |
142 | Limits the number of commits to show to 3. | |
88d9d45d | 143 | |
5dc7bcc2 JH |
144 | Discussion |
145 | ---------- | |
146 | ||
147 | include::i18n.txt[] | |
148 | ||
59893a88 JN |
149 | Configuration |
150 | ------------- | |
151 | ||
152 | See linkgit:git-config[1] for core variables and linkgit:git-diff[1] | |
153 | for settings related to diff generation. | |
154 | ||
155 | format.pretty:: | |
156 | Default for the `--format` option. (See "PRETTY FORMATS" above.) | |
157 | Defaults to "medium". | |
158 | ||
159 | i18n.logOutputEncoding:: | |
160 | Encoding to use when displaying logs. (See "Discussion", above.) | |
161 | Defaults to the value of `i18n.commitEncoding` if set, UTF-8 | |
162 | otherwise. | |
163 | ||
164 | log.date:: | |
165 | Default format for human-readable dates. (Compare the | |
166 | `--date` option.) Defaults to "default", which means to write | |
167 | dates like `Sat May 8 19:35:34 2010 -0500`. | |
168 | ||
169 | log.showroot:: | |
170 | If `false`, 'git log' and related commands will not treat the | |
171 | initial commit as a big creation event. Any root commits in | |
172 | `git log -p` output would be shown without a diff attached. | |
173 | The default is `true`. | |
174 | ||
d5422b0c | 175 | mailmap.*:: |
59893a88 JN |
176 | See linkgit:git-shortlog[1]. |
177 | ||
178 | notes.displayRef:: | |
179 | Which refs, in addition to the default set by `core.notesRef` | |
180 | or 'GIT_NOTES_REF', to read notes from when showing commit | |
181 | messages with the 'log' family of commands. See | |
182 | linkgit:git-notes[1]. | |
183 | + | |
184 | May be an unabbreviated ref name or a glob and may be specified | |
185 | multiple times. A warning will be issued for refs that do not exist, | |
186 | but a glob that does not match any refs is silently ignored. | |
187 | + | |
ab18b2c0 | 188 | This setting can be disabled by the `--no-notes` option, |
59893a88 | 189 | overridden by the 'GIT_NOTES_DISPLAY_REF' environment variable, |
ab18b2c0 | 190 | and overridden by the `--notes=<ref>` option. |
5dc7bcc2 | 191 | |
3f971fc4 JH |
192 | GIT |
193 | --- | |
9e1f0a85 | 194 | Part of the linkgit:git[1] suite |