Google Git
Sign in
chromium / external / gitster / git-htmldocs / 77b7e907943767b6d6c25f94beef13a16b1df6b4 / . / gitk.html
blob: e835d27bb80d4b7b926080a5eac1748f558c70b4 [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 Hamano6b2cee12006-08-26 08:43:31[diff] [blame]269 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.
333</p>
334</dd>
335<dt>
336&lt;path&gt;
337</dt>
338<dd>
339<p>
340 Limit commits to the ones touching files in the given paths. Note, to
341 avoid ambiguity wrt. revision names use "--" to separate the paths
342 from any preceeding options.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]343</p>
344</dd>
345</dl>
346</div>
347<h2>Examples</h2>
348<div class="sectionbody">
349<dl>
350<dt>
351gitk v2.6.12.. include/scsi drivers/scsi
352</dt>
353<dd>
354<p>
355 Show as the changes since version <em>v2.6.12</em> that changed any
356 file in the include/scsi or drivers/scsi subdirectories
357</p>
358</dd>
359<dt>
Junio C Hamano1bb569e2006-05-05 23:14:25[diff] [blame]360gitk --since="2 weeks ago" -- gitk
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]361</dt>
362<dd>
363<p>
364 Show the changes during the last two weeks to the file <em>gitk</em>.
365 The "--" is necessary to avoid confusion with the <strong>branch</strong> named
366 <em>gitk</em>
367</p>
368</dd>
Junio C Hamanod5784132006-09-20 21:29:27[diff] [blame]369<dt>
370gitk --max-count=100 --all &#8212; Makefile
371</dt>
372<dd>
373<p>
374 Show at most 100 changes made to the file <em>Makefile</em>. Instead of only
375 looking for changes in the current branch look in all branches.
376</p>
377</dd>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]378</dl>
379</div>
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]380<h2>See Also</h2>
381<div class="sectionbody">
382<dl>
383<dt>
384<em>qgit(1)</em>
385</dt>
386<dd>
387<p>
388 A repository browser written in C++ using Qt.
389</p>
390</dd>
391<dt>
392<em>gitview(1)</em>
393</dt>
394<dd>
395<p>
396 A repository browser written in Python using Gtk. It's based on
397 <em>bzrk(1)</em> and distributed in the contrib area of the git repository.
398</p>
399</dd>
400<dt>
401<em>tig(1)</em>
402</dt>
403<dd>
404<p>
405 A minimal repository browser and git tool output highlighter written
406 in C using Ncurses.
407</p>
408</dd>
409</dl>
410</div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]411<h2>Author</h2>
412<div class="sectionbody">
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]413<p>Written by Paul Mackerras &lt;paulus@samba.org&gt;.</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]414</div>
415<h2>Documentation</h2>
416<div class="sectionbody">
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]417<p>Documentation by Junio C Hamano, Jonas Fonseca, and the git-list
418&lt;git@vger.kernel.org&gt;.</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]419</div>
420<h2>GIT</h2>
421<div class="sectionbody">
422<p>Part of the <a href="git.html">git(7)</a> suite</p>
423</div>
424<div id="footer">
425<div id="footer-text">
Junio C Hamanod97409f2006-10-03 08:41:56[diff] [blame]426Last updated 03-Oct-2006 08:41:39 UTC
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]427</div>
428</div>
429</body>
430</html>