Google Git
Sign in
chromium / external / gitster / git-htmldocs / a74efce3509588e2d8fc7853b82bcdce35eacba6 / . / gitk.html
blob: e3d0e3285863248286ffa71a1abe63f5b276a3a8 [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
Junio C Hamano1bb569e2006-05-05 23:14:25[diff] [blame]6<meta name="generator" content="AsciiDoc 7.0.2" />
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]7<style type="text/css">
8/* Debug borders */
9p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
10/*
11 border: 1px solid red;
12*/
13}
14
15body {
16 margin: 1em 5% 1em 5%;
17}
18
19a { color: blue; }
20a:visited { color: fuchsia; }
21
22em {
23 font-style: italic;
24}
25
26strong {
27 font-weight: bold;
28}
29
30tt {
31 color: navy;
32}
33
34h1, h2, h3, h4, h5, h6 {
35 color: #527bbd;
36 font-family: sans-serif;
37 margin-top: 1.2em;
38 margin-bottom: 0.5em;
39 line-height: 1.3;
40}
41
42h1 {
43 border-bottom: 2px solid silver;
44}
45h2 {
46 border-bottom: 2px solid silver;
47 padding-top: 0.5em;
48}
49
50div.sectionbody {
51 font-family: serif;
52 margin-left: 0;
53}
54
55hr {
56 border: 1px solid silver;
57}
58
59p {
60 margin-top: 0.5em;
61 margin-bottom: 0.5em;
62}
63
64pre {
65 padding: 0;
66 margin: 0;
67}
68
69span#author {
70 color: #527bbd;
71 font-family: sans-serif;
72 font-weight: bold;
73 font-size: 1.2em;
74}
75span#email {
76}
77span#revision {
78 font-family: sans-serif;
79}
80
81div#footer {
82 font-family: sans-serif;
83 font-size: small;
84 border-top: 2px solid silver;
85 padding-top: 0.5em;
86 margin-top: 4.0em;
87}
88div#footer-text {
89 float: left;
90 padding-bottom: 0.5em;
91}
92div#footer-badges {
93 float: right;
94 padding-bottom: 0.5em;
95}
96
97div#preamble,
98div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
99div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
100div.admonitionblock {
101 margin-right: 10%;
102 margin-top: 1.5em;
103 margin-bottom: 1.5em;
104}
105div.admonitionblock {
106 margin-top: 2.5em;
107 margin-bottom: 2.5em;
108}
109
110div.content { /* Block element content. */
111 padding: 0;
112}
113
114/* Block element titles. */
115div.title, caption.title {
116 font-family: sans-serif;
117 font-weight: bold;
118 text-align: left;
119 margin-top: 1.0em;
120 margin-bottom: 0.5em;
121}
122div.title + * {
123 margin-top: 0;
124}
125
126td div.title:first-child {
127 margin-top: 0.0em;
128}
129div.content div.title:first-child {
130 margin-top: 0.0em;
131}
132div.content + div.title {
133 margin-top: 0.0em;
134}
135
136div.sidebarblock > div.content {
137 background: #ffffee;
138 border: 1px solid silver;
139 padding: 0.5em;
140}
141
142div.listingblock > div.content {
143 border: 1px solid silver;
144 background: #f4f4f4;
145 padding: 0.5em;
146}
147
148div.quoteblock > div.content {
149 padding-left: 2.0em;
150}
151div.quoteblock .attribution {
152 text-align: right;
153}
154
155div.admonitionblock .icon {
156 vertical-align: top;
157 font-size: 1.1em;
158 font-weight: bold;
159 text-decoration: underline;
160 color: #527bbd;
161 padding-right: 0.5em;
162}
163div.admonitionblock td.content {
164 padding-left: 0.5em;
165 border-left: 2px solid silver;
166}
167
168div.exampleblock > div.content {
169 border-left: 2px solid silver;
170 padding: 0.5em;
171}
172
173div.verseblock div.content {
174 white-space: pre;
175}
176
177div.imageblock div.content { padding-left: 0; }
178div.imageblock img { border: 1px solid silver; }
179span.image img { border-style: none; }
180
181dl {
182 margin-top: 0.8em;
183 margin-bottom: 0.8em;
184}
185dt {
186 margin-top: 0.5em;
187 margin-bottom: 0;
188 font-style: italic;
189}
190dd > *:first-child {
191 margin-top: 0;
192}
193
194ul, ol {
195 list-style-position: outside;
196}
197ol.olist2 {
198 list-style-type: lower-alpha;
199}
200
201div.tableblock > table {
202 border-color: #527bbd;
203 border-width: 3px;
204}
205thead {
206 font-family: sans-serif;
207 font-weight: bold;
208}
209tfoot {
210 font-weight: bold;
211}
212
213div.hlist {
214 margin-top: 0.8em;
215 margin-bottom: 0.8em;
216}
217td.hlist1 {
218 vertical-align: top;
219 font-style: italic;
220 padding-right: 0.8em;
221}
222td.hlist2 {
223 vertical-align: top;
224}
225
226@media print {
227 div#footer-badges { display: none; }
228}
229include::./stylesheets/xhtml11-manpage.css[]
230/* Workarounds for IE6's broken and incomplete CSS2. */
231
232div.sidebar-content {
233 background: #ffffee;
234 border: 1px solid silver;
235 padding: 0.5em;
236}
237div.sidebar-title, div.image-title {
238 font-family: sans-serif;
239 font-weight: bold;
240 margin-top: 0.0em;
241 margin-bottom: 0.5em;
242}
243
244div.listingblock div.content {
245 border: 1px solid silver;
246 background: #f4f4f4;
247 padding: 0.5em;
248}
249
250div.quoteblock-content {
251 padding-left: 2.0em;
252}
253
254div.exampleblock-content {
255 border-left: 2px solid silver;
256 padding-left: 0.5em;
257}
258</style>
259<title>gitk(1)</title>
260</head>
261<body>
262<div id="header">
263<h1>
264gitk(1) Manual Page
265</h1>
266<h2>NAME</h2>
267<div class="sectionbody">
268<p>gitk -
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]269 The git repository browser
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]270</p>
271</div>
272</div>
273<h2>SYNOPSIS</h2>
274<div class="sectionbody">
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]275<p><em>gitk</em> [&lt;option&gt;&#8230;] [&lt;revs&gt;] [--] [&lt;path&gt;&#8230;]</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]276</div>
277<h2>DESCRIPTION</h2>
278<div class="sectionbody">
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]279<p>Displays changes in a repository or a selected set of commits. This includes
280visualizing the commit graph, showing information related to each commit, and
281the files in the trees of each revision.</p>
282<p>Historically, gitk was the first repository browser. It's written in tcl/tk
283and started off in a separate repository but was later merged into the main
284git repository.</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]285</div>
286<h2>OPTIONS</h2>
287<div class="sectionbody">
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]288<p>To control which revisions to shown, the command takes options applicable to
289the <a href="git-rev-list.html">git-rev-list(1)</a> command. This manual page describes only the most
290frequently used options.</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]291<dl>
292<dt>
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]293-n &lt;number&gt;, --max-count=&lt;number&gt;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]294</dt>
295<dd>
296<p>
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]297 Limits the number of commits to show.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]298</p>
299</dd>
300<dt>
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]301--since=&lt;date&gt;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]302</dt>
303<dd>
304<p>
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]305 Show commits more recent than a specific date.
306</p>
307</dd>
308<dt>
309--until=&lt;date&gt;
310</dt>
311<dd>
312<p>
313 Show commits older than a specific date.
314</p>
315</dd>
316<dt>
Junio C Hamanod5784132006-09-20 21:29:27[diff] [blame]317--all
318</dt>
319<dd>
320<p>
321 Show all branches.
322</p>
323</dd>
324<dt>
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]325&lt;revs&gt;
326</dt>
327<dd>
328<p>
329 Limit the revisions to show. This can be either a single revision
330 meaning show from the given revision and back, or it can be a range in
331 the form "<em>&lt;from&gt;</em>..<em>&lt;to&gt;</em>" to show all revisions between <em>&lt;from&gt;</em> and
332 back to <em>&lt;to&gt;</em>. Note, more advanced revision selection can be applied.
Junio C Hamano2d47c622007-01-18 06:24:10[diff] [blame]333 For a more complete list of ways to spell object names, see
334 "SPECIFYING REVISIONS" section in <a href="git-rev-parse.html">git-rev-parse(1)</a>.
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]335</p>
336</dd>
337<dt>
338&lt;path&gt;
339</dt>
340<dd>
341<p>
342 Limit commits to the ones touching files in the given paths. Note, to
343 avoid ambiguity wrt. revision names use "--" to separate the paths
Junio C Hamanoee1e4282007-02-04 08:32:04[diff] [blame]344 from any preceding options.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]345</p>
346</dd>
347</dl>
348</div>
349<h2>Examples</h2>
350<div class="sectionbody">
351<dl>
352<dt>
353gitk v2.6.12.. include/scsi drivers/scsi
354</dt>
355<dd>
356<p>
357 Show as the changes since version <em>v2.6.12</em> that changed any
358 file in the include/scsi or drivers/scsi subdirectories
359</p>
360</dd>
361<dt>
Junio C Hamano1bb569e2006-05-05 23:14:25[diff] [blame]362gitk --since="2 weeks ago" -- gitk
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]363</dt>
364<dd>
365<p>
366 Show the changes during the last two weeks to the file <em>gitk</em>.
367 The "--" is necessary to avoid confusion with the <strong>branch</strong> named
368 <em>gitk</em>
369</p>
370</dd>
Junio C Hamanod5784132006-09-20 21:29:27[diff] [blame]371<dt>
Junio C Hamano764a6672007-10-23 01:23:31[diff] [blame]372gitk --max-count=100 --all -- Makefile
Junio C Hamanod5784132006-09-20 21:29:27[diff] [blame]373</dt>
374<dd>
375<p>
376 Show at most 100 changes made to the file <em>Makefile</em>. Instead of only
377 looking for changes in the current branch look in all branches.
378</p>
379</dd>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]380</dl>
381</div>
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]382<h2>See Also</h2>
383<div class="sectionbody">
384<dl>
385<dt>
386<em>qgit(1)</em>
387</dt>
388<dd>
389<p>
390 A repository browser written in C++ using Qt.
391</p>
392</dd>
393<dt>
394<em>gitview(1)</em>
395</dt>
396<dd>
397<p>
398 A repository browser written in Python using Gtk. It's based on
399 <em>bzrk(1)</em> and distributed in the contrib area of the git repository.
400</p>
401</dd>
402<dt>
403<em>tig(1)</em>
404</dt>
405<dd>
406<p>
407 A minimal repository browser and git tool output highlighter written
408 in C using Ncurses.
409</p>
410</dd>
411</dl>
412</div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]413<h2>Author</h2>
414<div class="sectionbody">
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]415<p>Written by Paul Mackerras &lt;paulus@samba.org&gt;.</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]416</div>
417<h2>Documentation</h2>
418<div class="sectionbody">
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]419<p>Documentation by Junio C Hamano, Jonas Fonseca, and the git-list
420&lt;git@vger.kernel.org&gt;.</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]421</div>
422<h2>GIT</h2>
423<div class="sectionbody">
424<p>Part of the <a href="git.html">git(7)</a> suite</p>
425</div>
426<div id="footer">
427<div id="footer-text">
Junio C Hamano35738e82008-01-07 07:55:46[diff] [blame]428Last updated 07-Jan-2008 07:50:59 UTC
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]429</div>
430</div>
431</body>
432</html>