1 <?xml version="1.0" encoding="UTF-8"?>
\r
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/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
17 <simpara><emphasis>gitk</emphasis> [<option>…] [<revs>] [--] [<path>…]</simpara>
\r
19 <simplesect id="_description">
\r
20 <title>DESCRIPTION</title>
\r
21 <simpara>Displays changes in a repository or a selected set of commits. This includes
\r
22 visualizing the commit graph, showing information related to each commit, and
\r
23 the files in the trees of each revision.</simpara>
\r
24 <simpara>Historically, gitk was the first repository browser. It’s written in tcl/tk
\r
25 and started off in a separate repository but was later merged into the main
\r
26 git repository.</simpara>
\r
28 <simplesect id="_options">
\r
29 <title>OPTIONS</title>
\r
30 <simpara>To control which revisions to show, the command takes options applicable to
\r
31 the <emphasis>git-rev-list</emphasis> command (see <xref linkend="git-rev-list(1)"/>).
\r
32 This manual page describes only the most
\r
33 frequently used options.</simpara>
\r
40 --max-count=<number>
\r
44 Limits the number of commits to show.
\r
50 --since=<date>
\r
54 Show commits more recent than a specific date.
\r
60 --until=<date>
\r
64 Show commits older than a specific date.
\r
84 After an attempt to merge stops with conflicts, show the commits on
\r
85 the history between two branches (i.e. the HEAD and the MERGE_HEAD)
\r
86 that modify the conflicted files.
\r
92 --argscmd=<command>
\r
96 Command to be run each time gitk has to determine the list of
\r
97 <revs> to show. The command is expected to print on its standard
\r
98 output a list of additional revs to be shown, one per line.
\r
99 Use this instead of explicitly specifying <revs> if the set of
\r
100 commits to show may vary between refreshes.
\r
106 --select-commit=<ref>
\r
110 Automatically select the specified commit after loading the graph.
\r
111 Default behavior is equivalent to specifying <emphasis>--select-commit=HEAD</emphasis>.
\r
121 Limit the revisions to show. This can be either a single revision
\r
122 meaning show from the given revision and back, or it can be a range in
\r
123 the form "<emphasis><from></emphasis>..<emphasis><to></emphasis>" to show all revisions between <emphasis><from></emphasis> and
\r
124 back to <emphasis><to></emphasis>. Note, more advanced revision selection can be applied.
\r
125 For a more complete list of ways to spell object names, see
\r
126 "SPECIFYING REVISIONS" section in <xref linkend="git-rev-parse(1)"/>.
\r
132 <path>…
\r
136 Limit commits to the ones touching files in the given paths. Note, to
\r
137 avoid ambiguity wrt. revision names use "--" to separate the paths
\r
138 from any preceding options.
\r
144 <simplesect id="_examples">
\r
145 <title>Examples</title>
\r
149 gitk v2.6.12.. include/scsi drivers/scsi
\r
153 Show the changes since version <emphasis>v2.6.12</emphasis> that changed any
\r
154 file in the include/scsi or drivers/scsi subdirectories
\r
160 gitk --since="2 weeks ago" -- gitk
\r
164 Show the changes during the last two weeks to the file <emphasis>gitk</emphasis>.
\r
165 The "--" is necessary to avoid confusion with the <emphasis role="strong">branch</emphasis> named
\r
166 <emphasis>gitk</emphasis>
\r
172 gitk --max-count=100 --all -- Makefile
\r
176 Show at most 100 changes made to the file <emphasis>Makefile</emphasis>. Instead of only
\r
177 looking for changes in the current branch look in all branches.
\r
183 <simplesect id="_files">
\r
184 <title>Files</title>
\r
185 <simpara>Gitk creates the .gitk file in your $HOME directory to store preferences
\r
186 such as display options, font, and colors.</simpara>
\r
188 <simplesect id="_see_also">
\r
189 <title>SEE ALSO</title>
\r
193 <emphasis>qgit(1)</emphasis>
\r
197 A repository browser written in C++ using Qt.
\r
203 <emphasis>gitview(1)</emphasis>
\r
207 A repository browser written in Python using Gtk. It’s based on
\r
208 <emphasis>bzrk(1)</emphasis> and distributed in the contrib area of the git repository.
\r
214 <emphasis>tig(1)</emphasis>
\r
218 A minimal repository browser and git tool output highlighter written
\r
219 in C using Ncurses.
\r
225 <simplesect id="_author">
\r
226 <title>Author</title>
\r
227 <simpara>Written by Paul Mackerras <<ulink url="mailto:paulus@samba.org">paulus@samba.org</ulink>>.</simpara>
\r
229 <simplesect id="_documentation">
\r
230 <title>Documentation</title>
\r
231 <simpara>Documentation by Junio C Hamano, Jonas Fonseca, and the git-list
\r
232 <<ulink url="mailto:git@vger.kernel.org">git@vger.kernel.org</ulink>>.</simpara>
\r
234 <simplesect id="_git">
\r
236 <simpara>Part of the <xref linkend="git(1)"/> suite</simpara>
\r