1git-log(1) 2========== 3 4NAME 5---- 6git-log - Show commit logs 7 8 9SYNOPSIS 10-------- 11'git-log' <option>... 12 13DESCRIPTION 14----------- 15Shows the commit logs. 16 17The command takes options applicable to the gitlink:git-rev-list[1] 18command to control what is shown and how, and options applicable to 19the gitlink:git-diff-tree[1] commands to control how the changes 20each commit introduces are shown. 21 22This manual page describes only the most frequently used options. 23 24 25OPTIONS 26------- 27 28include::pretty-options.txt[] 29 30-<n>:: 31 Limits the number of commits to show. 32 33<since>..<until>:: 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. 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]. 40 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 46-p:: 47 Show the change the commit introduces in a patch form. 48 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 54--decorate:: 55 Print out the ref names of any commits that are shown. 56 57<paths>...:: 58 Show only commits that affect the specified paths. 59 60 61include::pretty-formats.txt[] 62 63 64Examples 65-------- 66git log --no-merges:: 67 68 Show the whole commit history, but skip any merges 69 70git 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 75git log --since="2 weeks ago" \-- gitk:: 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 81git 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. 86 87Discussion 88---------- 89 90include::i18n.txt[] 91 92 93Author 94------ 95Written by Linus Torvalds <torvalds@osdl.org> 96 97Documentation 98-------------- 99Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. 100 101GIT 102--- 103Part of the gitlink:git[7] suite 104