/ uis / git / x / uis / git / git.git / blame
| 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. | |
| 52 | See also gitlink:git-reflog[1]. | |
| 53 | ||
| 56822cc9 | 54 | --decorate:: |
| ef3cb65c | 55 | Print out the ref names of any commits that are shown. |
| 56822cc9 | 56 | |
| e51c3b50 JH |
57 | <paths>...:: |
| 58 | Show only commits that affect the specified paths. | |
| 59 | ||
| 3f971fc4 | 60 | |
| 331b51d2 JN |
61 | include::pretty-formats.txt[] |
| 62 | ||
| 63 | ||
| bd663611 LT |
64 | Examples |
| 65 | -------- | |
| 66 | git log --no-merges:: | |
| 67 | ||
| 68 | Show the whole commit history, but skip any merges | |
| 69 | ||
| 70 | git log v2.6.12.. include/scsi drivers/scsi:: | |
| 71 | ||
| 72 | Show all commits since version 'v2.6.12' that changed any file | |
| 73 | in the include/scsi or drivers/scsi subdirectories | |
| 74 | ||
| e994004f | 75 | git log --since="2 weeks ago" \-- gitk:: |
| bd663611 LT |
76 | |
| 77 | Show the changes during the last two weeks to the file 'gitk'. | |
| 78 | The "--" is necessary to avoid confusion with the *branch* named | |
| 79 | 'gitk' | |
| 80 | ||
| e51c3b50 JH |
81 | git log -r --name-status release..test:: |
| 82 | ||
| 83 | Show the commits that are in the "test" branch but not yet | |
| 84 | in the "release" branch, along with the list of paths | |
| 85 | each commit modifies. | |
| bd663611 | 86 | |
| 5dc7bcc2 JH |
87 | Discussion |
| 88 | ---------- | |
| 89 | ||
| 90 | include::i18n.txt[] | |
| 91 | ||
| 92 | ||
| 3f971fc4 JH |
93 | Author |
| 94 | ------ | |
| 95 | Written by Linus Torvalds <torvalds@osdl.org> | |
| 96 | ||
| 97 | Documentation | |
| 98 | -------------- | |
| 99 | Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. | |
| 100 | ||
| 101 | GIT | |
| 102 | --- | |
| a7154e91 | 103 | Part of the gitlink:git[7] suite |