Add examples for git-log documentation and others.
[git/git.git] / Documentation / git-log.txt
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 -----------
15 Shows the commit logs. This command internally invokes
16 'git-rev-list', and the command line options are passed to that
17 command.
18
19 This manual page describes only the most frequently used options.
20
21 OPTIONS
22 -------
23 --pretty=<format>:
24 Controls the way the commit log is formatted.
25
26 --max-count=<n>::
27 Limits the number of commits to show.
28
29 <since>..<until>::
30 Show only commits between the named two commits.
31
32
33 Examples
34 --------
35 git log --no-merges::
36
37 Show the whole commit history, but skip any merges
38
39 git log v2.6.12.. include/scsi drivers/scsi::
40
41 Show all commits since version 'v2.6.12' that changed any file
42 in the include/scsi or drivers/scsi subdirectories
43
44 git log --since="2 weeks ago" -- gitk::
45
46 Show the changes during the last two weeks to the file 'gitk'.
47 The "--" is necessary to avoid confusion with the *branch* named
48 'gitk'
49
50
51 Author
52 ------
53 Written by Linus Torvalds <torvalds@osdl.org>
54
55 Documentation
56 --------------
57 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
58
59 GIT
60 ---
61 Part of the gitlink:git[7] suite
62