mirror of
https://github.com/git/git.git
synced 2024-11-05 16:52:59 +01:00
f028cdae66
Currently, whenever we need documentation for revisions and ranges, we link to the git-rev-parse man page, i.e. a plumbing man page, which has this along with the documentation of all rev-parse modes. Link to the new gitrevisions man page instead in all cases except - when the actual git-rev-parse command is referred to or - in very technical context (git-send-pack). Signed-off-by: Michael J Gruber <git@drmicha.warpmail.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
127 lines
3.4 KiB
Text
127 lines
3.4 KiB
Text
gitk(1)
|
|
=======
|
|
|
|
NAME
|
|
----
|
|
gitk - The git repository browser
|
|
|
|
SYNOPSIS
|
|
--------
|
|
'gitk' [<option>...] [<revs>] [--] [<path>...]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Displays changes in a repository or a selected set of commits. This includes
|
|
visualizing the commit graph, showing information related to each commit, and
|
|
the files in the trees of each revision.
|
|
|
|
Historically, gitk was the first repository browser. It's written in tcl/tk
|
|
and started off in a separate repository but was later merged into the main
|
|
git repository.
|
|
|
|
OPTIONS
|
|
-------
|
|
To control which revisions to show, the command takes options applicable to
|
|
the 'git rev-list' command (see linkgit:git-rev-list[1]).
|
|
This manual page describes only the most
|
|
frequently used options.
|
|
|
|
-n <number>::
|
|
--max-count=<number>::
|
|
|
|
Limits the number of commits to show.
|
|
|
|
--since=<date>::
|
|
|
|
Show commits more recent than a specific date.
|
|
|
|
--until=<date>::
|
|
|
|
Show commits older than a specific date.
|
|
|
|
--all::
|
|
|
|
Show all branches.
|
|
|
|
--merge::
|
|
|
|
After an attempt to merge stops with conflicts, show the commits on
|
|
the history between two branches (i.e. the HEAD and the MERGE_HEAD)
|
|
that modify the conflicted files and do not exist on all the heads
|
|
being merged.
|
|
|
|
--argscmd=<command>::
|
|
Command to be run each time gitk has to determine the list of
|
|
<revs> to show. The command is expected to print on its standard
|
|
output a list of additional revs to be shown, one per line.
|
|
Use this instead of explicitly specifying <revs> if the set of
|
|
commits to show may vary between refreshes.
|
|
|
|
--select-commit=<ref>::
|
|
|
|
Automatically select the specified commit after loading the graph.
|
|
Default behavior is equivalent to specifying '--select-commit=HEAD'.
|
|
|
|
<revs>::
|
|
|
|
Limit the revisions to show. This can be either a single revision
|
|
meaning show from the given revision and back, or it can be a range in
|
|
the form "'<from>'..'<to>'" to show all revisions between '<from>' and
|
|
back to '<to>'. Note, more advanced revision selection can be applied.
|
|
For a more complete list of ways to spell object names, see
|
|
linkgit:gitrevisions[1].
|
|
|
|
<path>...::
|
|
|
|
Limit commits to the ones touching files in the given paths. Note, to
|
|
avoid ambiguity with respect to revision names use "--" to separate the paths
|
|
from any preceding options.
|
|
|
|
Examples
|
|
--------
|
|
gitk v2.6.12.. include/scsi drivers/scsi::
|
|
|
|
Show the changes since version 'v2.6.12' that changed any
|
|
file in the include/scsi or drivers/scsi subdirectories
|
|
|
|
gitk --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'
|
|
|
|
gitk --max-count=100 --all \-- Makefile::
|
|
|
|
Show at most 100 changes made to the file 'Makefile'. Instead of only
|
|
looking for changes in the current branch look in all branches.
|
|
|
|
Files
|
|
-----
|
|
Gitk creates the .gitk file in your $HOME directory to store preferences
|
|
such as display options, font, and colors.
|
|
|
|
SEE ALSO
|
|
--------
|
|
'qgit(1)'::
|
|
A repository browser written in C++ using Qt.
|
|
|
|
'gitview(1)'::
|
|
A repository browser written in Python using Gtk. It's based on
|
|
'bzrk(1)' and distributed in the contrib area of the git repository.
|
|
|
|
'tig(1)'::
|
|
A minimal repository browser and git tool output highlighter written
|
|
in C using Ncurses.
|
|
|
|
Author
|
|
------
|
|
Written by Paul Mackerras <paulus@samba.org>.
|
|
|
|
Documentation
|
|
--------------
|
|
Documentation by Junio C Hamano, Jonas Fonseca, and the git-list
|
|
<git@vger.kernel.org>.
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|