1 <?xml version="1.0" encoding="UTF-8"?>
\r
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
\r
4 <article lang="en" id="gitk(1)">
\r
6 <title>gitk(1)</title>
\r
8 <primary>gitk(1)</primary>
\r
11 <simplesect id="_name">
\r
13 <simpara>gitk - The git repository browser</simpara>
\r
15 <simplesect id="_synopsis">
\r
16 <title>SYNOPSIS</title>
\r
18 <literallayout><emphasis>gitk</emphasis> [<option>…] [<revs>] [--] [<path>…]</literallayout>
\r
21 <simplesect id="_description">
\r
22 <title>DESCRIPTION</title>
\r
23 <simpara>Displays changes in a repository or a selected set of commits. This includes
\r
24 visualizing the commit graph, showing information related to each commit, and
\r
25 the files in the trees of each revision.</simpara>
\r
26 <simpara>Historically, gitk was the first repository browser. It's written in tcl/tk
\r
27 and started off in a separate repository but was later merged into the main
\r
28 git repository.</simpara>
\r
30 <simplesect id="_options">
\r
31 <title>OPTIONS</title>
\r
32 <simpara>To control which revisions to show, the command takes options applicable to
\r
33 the <emphasis>git rev-list</emphasis> command (see <xref linkend="git-rev-list(1)" />).
\r
34 This manual page describes only the most
\r
35 frequently used options.</simpara>
\r
42 --max-count=<number>
\r
46 Limits the number of commits to show.
\r
52 --since=<date>
\r
56 Show commits more recent than a specific date.
\r
62 --until=<date>
\r
66 Show commits older than a specific date.
\r
86 After an attempt to merge stops with conflicts, show the commits on
\r
87 the history between two branches (i.e. the HEAD and the MERGE_HEAD)
\r
88 that modify the conflicted files and do not exist on all the heads
\r
95 --argscmd=<command>
\r
99 Command to be run each time gitk has to determine the list of
\r
100 <revs> to show. The command is expected to print on its standard
\r
101 output a list of additional revs to be shown, one per line.
\r
102 Use this instead of explicitly specifying <revs> if the set of
\r
103 commits to show may vary between refreshes.
\r
109 --select-commit=<ref>
\r
113 Automatically select the specified commit after loading the graph.
\r
114 Default behavior is equivalent to specifying <emphasis>--select-commit=HEAD</emphasis>.
\r
124 Limit the revisions to show. This can be either a single revision
\r
125 meaning show from the given revision and back, or it can be a range in
\r
126 the form "<emphasis><from></emphasis>..<emphasis><to></emphasis>" to show all revisions between <emphasis><from></emphasis> and
\r
127 back to <emphasis><to></emphasis>. Note, more advanced revision selection can be applied.
\r
128 For a more complete list of ways to spell object names, see
\r
129 <xref linkend="gitrevisions(7)" />.
\r
135 <path>…
\r
139 Limit commits to the ones touching files in the given paths. Note, to
\r
140 avoid ambiguity with respect to revision names use "--" to separate the paths
\r
141 from any preceding options.
\r
147 <simplesect id="_examples">
\r
148 <title>Examples</title>
\r
152 gitk v2.6.12.. include/scsi drivers/scsi
\r
156 Show the changes since version <emphasis>v2.6.12</emphasis> that changed any
\r
157 file in the include/scsi or drivers/scsi subdirectories
\r
163 gitk --since="2 weeks ago" -- gitk
\r
167 Show the changes during the last two weeks to the file <emphasis>gitk</emphasis>.
\r
168 The "--" is necessary to avoid confusion with the <emphasis role="strong">branch</emphasis> named
\r
169 <emphasis>gitk</emphasis>
\r
175 gitk --max-count=100 --all -- Makefile
\r
179 Show at most 100 changes made to the file <emphasis>Makefile</emphasis>. Instead of only
\r
180 looking for changes in the current branch look in all branches.
\r
186 <simplesect id="_files">
\r
187 <title>Files</title>
\r
188 <simpara>Gitk creates the .gitk file in your $HOME directory to store preferences
\r
189 such as display options, font, and colors.</simpara>
\r
191 <simplesect id="_see_also">
\r
192 <title>SEE ALSO</title>
\r
196 <emphasis>qgit(1)</emphasis>
\r
200 A repository browser written in C++ using Qt.
\r
206 <emphasis>gitview(1)</emphasis>
\r
210 A repository browser written in Python using Gtk. It's based on
\r
211 <emphasis>bzrk(1)</emphasis> and distributed in the contrib area of the git repository.
\r
217 <emphasis>tig(1)</emphasis>
\r
221 A minimal repository browser and git tool output highlighter written
\r
222 in C using Ncurses.
\r
228 <simplesect id="_git">
\r
230 <simpara>Part of the <xref linkend="git(1)" /> suite</simpara>
\r