]>
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 | -------- | |
cc1621e2 | 11 | 'git-log' <option>... |
3f971fc4 JH |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
e51c3b50 JH |
15 | Shows the commit logs. |
16 | ||
aa6bf0eb | 17 | The command takes options applicable to the gitlink:git-rev-list[1] |
e51c3b50 | 18 | command to control what is shown and how, and options applicable to |
66e788bc | 19 | the gitlink:git-diff-tree[1] commands to control how the changes |
e51c3b50 JH |
20 | each commit introduces are shown. |
21 | ||
aa6bf0eb | 22 | This manual page describes only the most frequently used options. |
3f971fc4 | 23 | |
3f971fc4 JH |
24 | |
25 | OPTIONS | |
26 | ------- | |
5d1faf87 CR |
27 | |
28 | include::pretty-formats.txt[] | |
3f971fc4 | 29 | |
adb7ba6b | 30 | -<n>:: |
3f971fc4 JH |
31 | Limits the number of commits to show. |
32 | ||
33 | <since>..<until>:: | |
99e09cce JH |
34 | Show only commits between the named two commits. When |
35 | either <since> or <until> is omitted, it defaults to | |
36 | `HEAD`, i.e. the tip of the current branch. | |
41a5564e SP |
37 | For a more complete list of ways to spell <since> |
38 | and <until>, see "SPECIFYING REVISIONS" section in | |
39 | gitlink:git-rev-parse[1]. | |
3f971fc4 | 40 | |
e51c3b50 JH |
41 | -p:: |
42 | Show the change the commit introduces in a patch form. | |
43 | ||
44 | <paths>...:: | |
45 | Show only commits that affect the specified paths. | |
46 | ||
3f971fc4 | 47 | |
bd663611 LT |
48 | Examples |
49 | -------- | |
50 | git log --no-merges:: | |
51 | ||
52 | Show the whole commit history, but skip any merges | |
53 | ||
54 | git log v2.6.12.. include/scsi drivers/scsi:: | |
55 | ||
56 | Show all commits since version 'v2.6.12' that changed any file | |
57 | in the include/scsi or drivers/scsi subdirectories | |
58 | ||
e994004f | 59 | git log --since="2 weeks ago" \-- gitk:: |
bd663611 LT |
60 | |
61 | Show the changes during the last two weeks to the file 'gitk'. | |
62 | The "--" is necessary to avoid confusion with the *branch* named | |
63 | 'gitk' | |
64 | ||
e51c3b50 JH |
65 | git log -r --name-status release..test:: |
66 | ||
67 | Show the commits that are in the "test" branch but not yet | |
68 | in the "release" branch, along with the list of paths | |
69 | each commit modifies. | |
bd663611 | 70 | |
5dc7bcc2 JH |
71 | Discussion |
72 | ---------- | |
73 | ||
74 | include::i18n.txt[] | |
75 | ||
76 | ||
3f971fc4 JH |
77 | Author |
78 | ------ | |
79 | Written by Linus Torvalds <torvalds@osdl.org> | |
80 | ||
81 | Documentation | |
82 | -------------- | |
83 | Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. | |
84 | ||
85 | GIT | |
86 | --- | |
a7154e91 | 87 | Part of the gitlink:git[7] suite |
3f971fc4 | 88 |