[thirdparty/git.git] / Documentation / git-log.txt

git-log(1)
==========

NAME
----
git-log - Show commit logs


SYNOPSIS
--------
'git-log' <option>...

DESCRIPTION
-----------
Shows the commit logs.

The command takes options applicable to the gitlink:git-rev-list[1]
command to control what is shown and how, and options applicable to
the gitlink:git-diff-tree[1] commands to control how the change
each commit introduces are shown.

This manual page describes only the most frequently used options.


OPTIONS
-------

include::pretty-formats.txt[]

--max-count=<n>::
	Limits the number of commits to show.

<since>..<until>::
	Show only commits between the named two commits.

-p::
	Show the change the commit introduces in a patch form.

<paths>...::
	Show only commits that affect the specified paths.


Examples
--------
git log --no-merges::

	Show the whole commit history, but skip any merges

git log v2.6.12.. include/scsi drivers/scsi::

	Show all commits since version 'v2.6.12' that changed any file
	in the include/scsi or drivers/scsi subdirectories

git log --since="2 weeks ago" \-- gitk::

	Show the changes during the last two weeks to the file 'gitk'.
	The "--" is necessary to avoid confusion with the *branch* named
	'gitk'

git log -r --name-status release..test::

	Show the commits that are in the "test" branch but not yet
	in the "release" branch, along with the list of paths
	each commit modifies.

Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT
---
Part of the gitlink:git[7] suite
Commit	Line	Data
	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.
	16
	17	The command takes options applicable to the gitlink:git-rev-list[1]
	18	command to control what is shown and how, and options applicable to
	19	the gitlink:git-diff-tree[1] commands to control how the change
	20	each commit introduces are shown.
	21
	22	This manual page describes only the most frequently used options.
	23
	24
	25	OPTIONS
	26	-------
	27
	28	include::pretty-formats.txt[]
	29
	30	--max-count=<n>::
	31	Limits the number of commits to show.
	32
	33	<since>..<until>::
	34	Show only commits between the named two commits.
	35
	36	-p::
	37	Show the change the commit introduces in a patch form.
	38
	39	<paths>...::
	40	Show only commits that affect the specified paths.
	41
	42
	43	Examples
	44	--------
	45	git log --no-merges::
	46
	47	Show the whole commit history, but skip any merges
	48
	49	git log v2.6.12.. include/scsi drivers/scsi::
	50
	51	Show all commits since version 'v2.6.12' that changed any file
	52	in the include/scsi or drivers/scsi subdirectories
	53
	54	git log --since="2 weeks ago" \-- gitk::
	55
	56	Show the changes during the last two weeks to the file 'gitk'.
	57	The "--" is necessary to avoid confusion with the branch named
	58	'gitk'
	59
	60	git log -r --name-status release..test::
	61
	62	Show the commits that are in the "test" branch but not yet
	63	in the "release" branch, along with the list of paths
	64	each commit modifies.
	65
	66	Author
	67	------
	68	Written by Linus Torvalds <torvalds@osdl.org>
	69
	70	Documentation
	71	--------------
	72	Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
	73
	74	GIT
	75	---
	76	Part of the gitlink:git[7] suite
	77