'\" t .\" Title: gitk .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Date: 08/19/2012 .\" Manual: Git Manual .\" Source: Git 1.7.12 .\" Language: English .\" .TH "GITK" "1" "08/19/2012" "Git 1\&.7\&.12" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" gitk \- The git repository browser .SH "SYNOPSIS" .sp .nf \fIgitk\fR [<option>\&...] [<revs>] [\-\-] [<path>\&...] .fi .sp .SH "DESCRIPTION" .sp 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\&. .sp Historically, gitk was the first repository browser\&. It\(cqs written in tcl/tk and started off in a separate repository but was later merged into the main git repository\&. .SH "OPTIONS" .sp To control which revisions to show, the command takes options applicable to the \fIgit rev\-list\fR command (see \fBgit-rev-list\fR(1))\&. This manual page describes only the most frequently used options\&. .PP \-n <number>, \-\-max\-count=<number> .RS 4 Limits the number of commits to show\&. .RE .PP \-\-since=<date> .RS 4 Show commits more recent than a specific date\&. .RE .PP \-\-until=<date> .RS 4 Show commits older than a specific date\&. .RE .PP \-\-all .RS 4 Show all branches\&. .RE .PP \-\-merge .RS 4 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\&. .RE .PP \-\-argscmd=<command> .RS 4 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\&. .RE .PP \-\-select\-commit=<ref> .RS 4 Automatically select the specified commit after loading the graph\&. Default behavior is equivalent to specifying \fI\-\-select\-commit=HEAD\fR\&. .RE .PP <revs> .RS 4 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 "\fI<from>\fR\&.\&.\fI<to>\fR" to show all revisions between \fI<from>\fR and back to \fI<to>\fR\&. Note, more advanced revision selection can be applied\&. For a more complete list of ways to spell object names, see \fBgitrevisions\fR(7)\&. .RE .PP <path>\&... .RS 4 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\&. .RE .SH "EXAMPLES" .PP gitk v2\&.6\&.12\&.\&. include/scsi drivers/scsi .RS 4 Show the changes since version \fIv2\&.6\&.12\fR that changed any file in the include/scsi or drivers/scsi subdirectories .RE .PP gitk \-\-since="2 weeks ago" \-\- gitk .RS 4 Show the changes during the last two weeks to the file \fIgitk\fR\&. The "\-\-" is necessary to avoid confusion with the \fBbranch\fR named \fIgitk\fR .RE .PP gitk \-\-max\-count=100 \-\-all \-\- Makefile .RS 4 Show at most 100 changes made to the file \fIMakefile\fR\&. Instead of only looking for changes in the current branch look in all branches\&. .RE .SH "FILES" .sp Gitk creates the \&.gitk file in your $HOME directory to store preferences such as display options, font, and colors\&. .SH "SEE ALSO" .PP \fIqgit(1)\fR .RS 4 A repository browser written in C++ using Qt\&. .RE .PP \fIgitview(1)\fR .RS 4 A repository browser written in Python using Gtk\&. It\(cqs based on \fIbzrk(1)\fR and distributed in the contrib area of the git repository\&. .RE .PP \fItig(1)\fR .RS 4 A minimal repository browser and git tool output highlighter written in C using Ncurses\&. .RE .SH "GIT" .sp Part of the \fBgit\fR(1) suite