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