Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 1 | git-log(1) |
| 2 | ========== |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | git-log - Show commit logs |
| 7 | |
| 8 | |
| 9 | SYNOPSIS |
| 10 | -------- |
| 11 | 'git-log' <option>... |
| 12 | |
| 13 | DESCRIPTION |
| 14 | ----------- |
Junio C Hamano | ba7c8d8 | 2006-04-15 06:17:42 | [diff] [blame^] | 15 | Shows the commit logs. |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 16 | |
Junio C Hamano | ba7c8d8 | 2006-04-15 06:17:42 | [diff] [blame^] | 17 | The command takes options applicable to the gitlink::git-rev-list[1] |
| 18 | command to control what is shown and how, and options applicable to |
| 19 | the gitlink::git-diff-tree[1] commands to control how the change |
| 20 | each commit introduces are shown. |
| 21 | |
| 22 | This manual page describes only the most frequently used |
| 23 | options. |
| 24 | |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 25 | |
| 26 | OPTIONS |
| 27 | ------- |
| 28 | --pretty=<format>:: |
| 29 | Controls the way the commit log is formatted. |
| 30 | |
| 31 | --max-count=<n>:: |
| 32 | Limits the number of commits to show. |
| 33 | |
| 34 | <since>..<until>:: |
| 35 | Show only commits between the named two commits. |
| 36 | |
Junio C Hamano | ba7c8d8 | 2006-04-15 06:17:42 | [diff] [blame^] | 37 | -p:: |
| 38 | Show the change the commit introduces in a patch form. |
| 39 | |
| 40 | <paths>...:: |
| 41 | Show only commits that affect the specified paths. |
| 42 | |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 43 | |
| 44 | Examples |
| 45 | -------- |
| 46 | git log --no-merges:: |
| 47 | |
| 48 | Show the whole commit history, but skip any merges |
| 49 | |
| 50 | git log v2.6.12.. include/scsi drivers/scsi:: |
| 51 | |
| 52 | Show all commits since version 'v2.6.12' that changed any file |
| 53 | in the include/scsi or drivers/scsi subdirectories |
| 54 | |
| 55 | git log --since="2 weeks ago" -- gitk:: |
| 56 | |
| 57 | Show the changes during the last two weeks to the file 'gitk'. |
| 58 | The "--" is necessary to avoid confusion with the *branch* named |
| 59 | 'gitk' |
| 60 | |
Junio C Hamano | ba7c8d8 | 2006-04-15 06:17:42 | [diff] [blame^] | 61 | git log -r --name-status release..test:: |
| 62 | |
| 63 | Show the commits that are in the "test" branch but not yet |
| 64 | in the "release" branch, along with the list of paths |
| 65 | each commit modifies. |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 66 | |
| 67 | Author |
| 68 | ------ |
| 69 | Written by Linus Torvalds <torvalds@osdl.org> |
| 70 | |
| 71 | Documentation |
| 72 | -------------- |
| 73 | Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. |
| 74 | |
| 75 | GIT |
| 76 | --- |
| 77 | Part of the gitlink:git[7] suite |
| 78 | |