]>
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 | 27 | |
331b51d2 | 28 | include::pretty-options.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 | |
89d58923 JH |
41 | --first-parent:: |
42 | Follow only the first parent commit upon seeing a merge | |
43 | commit. This option gives a better overview of the | |
44 | evolution of a particular branch. | |
45 | ||
e51c3b50 JH |
46 | -p:: |
47 | Show the change the commit introduces in a patch form. | |
48 | ||
5f2e1df5 AR |
49 | -g, \--walk-reflogs:: |
50 | Show commits as they were recorded in the reflog. The log contains | |
51 | a record about how the tip of a reference was changed. | |
d56651c0 | 52 | Cannot be combined with --reverse. |
5f2e1df5 AR |
53 | See also gitlink:git-reflog[1]. |
54 | ||
56822cc9 | 55 | --decorate:: |
ef3cb65c | 56 | Print out the ref names of any commits that are shown. |
56822cc9 | 57 | |
2e88c266 JN |
58 | --full-diff:: |
59 | Without this flag, "git log -p <paths>..." shows commits that | |
60 | touch the specified paths, and diffs about the same specified | |
61 | paths. With this, the full diff is shown for commits that touch | |
62 | the specified paths; this means that "<paths>..." limits only | |
63 | commits, and doesn't limit diff for those commits. | |
64 | ||
4f50f6a9 SW |
65 | --follow:: |
66 | Continue listing the history of a file beyond renames. | |
67 | ||
9fa3465d MC |
68 | --log-size:: |
69 | Before the log message print out its size in bytes. Intended | |
70 | mainly for porcelain tools consumption. If git is unable to | |
71 | produce a valid value size is set to zero. | |
72 | Note that only message is considered, if also a diff is shown | |
73 | its size is not included. | |
74 | ||
e51c3b50 JH |
75 | <paths>...:: |
76 | Show only commits that affect the specified paths. | |
77 | ||
3f971fc4 | 78 | |
331b51d2 JN |
79 | include::pretty-formats.txt[] |
80 | ||
81 | ||
bd663611 LT |
82 | Examples |
83 | -------- | |
84 | git log --no-merges:: | |
85 | ||
86 | Show the whole commit history, but skip any merges | |
87 | ||
88 | git log v2.6.12.. include/scsi drivers/scsi:: | |
89 | ||
90 | Show all commits since version 'v2.6.12' that changed any file | |
91 | in the include/scsi or drivers/scsi subdirectories | |
92 | ||
e994004f | 93 | git log --since="2 weeks ago" \-- gitk:: |
bd663611 LT |
94 | |
95 | Show the changes during the last two weeks to the file 'gitk'. | |
96 | The "--" is necessary to avoid confusion with the *branch* named | |
97 | 'gitk' | |
98 | ||
e51c3b50 JH |
99 | git log -r --name-status release..test:: |
100 | ||
101 | Show the commits that are in the "test" branch but not yet | |
102 | in the "release" branch, along with the list of paths | |
103 | each commit modifies. | |
bd663611 | 104 | |
4f50f6a9 SW |
105 | git log --follow builtin-rev-list.c:: |
106 | ||
107 | Shows the commits that changed builtin-rev-list.c, including | |
108 | those commits that occurred before the file was given its | |
109 | present name. | |
110 | ||
5dc7bcc2 JH |
111 | Discussion |
112 | ---------- | |
113 | ||
114 | include::i18n.txt[] | |
115 | ||
116 | ||
3f971fc4 JH |
117 | Author |
118 | ------ | |
119 | Written by Linus Torvalds <torvalds@osdl.org> | |
120 | ||
121 | Documentation | |
122 | -------------- | |
123 | Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. | |
124 | ||
125 | GIT | |
126 | --- | |
a7154e91 | 127 | Part of the gitlink:git[7] suite |