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