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-formats.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 61Examples 62-------- 63git log --no-merges:: 64 65 Show the whole commit history, but skip any merges 66 67git 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 72git log --since="2 weeks ago" \-- gitk:: 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 78git 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. 83 84Discussion 85---------- 86 87include::i18n.txt[] 88 89 90Author 91------ 92Written by Linus Torvalds <torvalds@osdl.org> 93 94Documentation 95-------------- 96Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. 97 98GIT 99--- 100Part of the gitlink:git[7] suite 101