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