Google Git
Sign in
chromium / external / gitster / git-htmldocs / b968dbbd6a939fc1282a7837026e131ed921e122 / . / git-gui.html
blob: 5e768b1b4a9dbe30444f8816124203951da74ae7 [file] [log] [blame]
Junio C Hamano58784fc2007-06-23 08:48:57[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" />
6<meta name="generator" content="AsciiDoc 7.0.2" />
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>git-gui(1)</title>
260</head>
261<body>
262<div id="header">
263<h1>
264git-gui(1) Manual Page
265</h1>
266<h2>NAME</h2>
267<div class="sectionbody">
268<p>git-gui -
269 A portable graphical interface to Git
270</p>
271</div>
272</div>
273<h2>SYNOPSIS</h2>
274<div class="sectionbody">
275<p><em>git gui</em> [&lt;command&gt;] [arguments]</p>
276</div>
277<h2>DESCRIPTION</h2>
278<div class="sectionbody">
279<p>A Tcl/Tk based graphical user interface to Git. git-gui focuses
280on allowing users to make changes to their repository by making
281new commits, amending existing ones, creating branches, performing
282local merges, and fetching/pushing to remote repositories.</p>
283<p>Unlike <a href="gitk.html">gitk(1)</a>, git-gui focuses on commit generation
284and single file annotation, and does not show project history.
285It does however supply menu actions to start a gitk session from
286within git-gui.</p>
287<p>git-gui is known to work on all popular UNIX systems, Mac OS X,
288and Windows (under both Cygwin and MSYS). To the extent possible
289OS specific user interface guidelines are followed, making git-gui
290a fairly native interface for users.</p>
291</div>
292<h2>COMMANDS</h2>
293<div class="sectionbody">
294<dl>
295<dt>
296blame
297</dt>
298<dd>
299<p>
300 Start a blame viewer on the specified file on the given
301 version (or working directory if not specified).
302</p>
303</dd>
304<dt>
305browser
306</dt>
307<dd>
308<p>
309 Start a tree browser showing all files in the specified
310 commit (or <em>HEAD</em> by default). Files selected through the
311 browser are opened in the blame viewer.
312</p>
313</dd>
314<dt>
315citool
316</dt>
317<dd>
318<p>
319 Start git-gui and arrange to make exactly one commit before
320 exiting and returning to the shell. The interface is limited
321 to only commit actions, slightly reducing the application's
322 startup time and simplifying the menubar.
323</p>
324</dd>
325<dt>
326version
327</dt>
328<dd>
329<p>
330 Display the currently running version of git-gui.
331</p>
332</dd>
333</dl>
334</div>
335<h2>Examples</h2>
336<div class="sectionbody">
337<dl>
338<dt>
339git gui blame Makefile
340</dt>
341<dd>
342<p>
343 Show the contents of the file <em>Makefile</em> in the current
344 working directory, and provide annotations for both the
345 original author of each line, and who moved the line to its
346 current location. The uncommitted file is annotated, and
347 uncommitted changes (if any) are explicitly attributed to
348 <em>Not Yet Committed</em>.
349</p>
350</dd>
351<dt>
352git gui blame v0.99.8 Makefile
353</dt>
354<dd>
355<p>
356 Show the contents of <em>Makefile</em> in revision <em>v0.99.8</em>
357 and provide annotations for each line. Unlike the above
358 example the file is read from the object database and not
359 the working directory.
360</p>
361</dd>
362<dt>
363git gui citool
364</dt>
365<dd>
366<p>
367 Make one commit and return to the shell when it is complete.
368</p>
369</dd>
370<dt>
371git citool
372</dt>
373<dd>
374<p>
375 Same as <em>git gui citool</em> (above).
376</p>
377</dd>
378<dt>
379git gui browser maint
380</dt>
381<dd>
382<p>
383 Show a browser for the tree of the <em>maint</em> branch. Files
384 selected in the browser can be viewed with the internal
385 blame viewer.
386</p>
387</dd>
388</dl>
389</div>
390<h2>See Also</h2>
391<div class="sectionbody">
392<dl>
393<dt>
394<em>gitk(1)</em>
395</dt>
396<dd>
397<p>
398 The git repository browser. Shows branches, commit history
399 and file differences. gitk is the utility started by
400 git-gui's Repository Visualize actions.
401</p>
402</dd>
403</dl>
404</div>
405<h2>Other</h2>
406<div class="sectionbody">
407<p>git-gui is actually maintained as an independent project, but stable
408versions are distributed as part of the Git suite for the convience
409of end users.</p>
410<p>A git-gui development repository can be obtained from:</p>
411<div class="literalblock">
412<div class="content">
413<pre><tt>git clone git://repo.or.cz/git-gui.git</tt></pre>
414</div></div>
415<p>or</p>
416<div class="literalblock">
417<div class="content">
418<pre><tt>git clone http://repo.or.cz/r/git-gui.git</tt></pre>
419</div></div>
420<p>or browsed online at <a href="http://repo.or.cz/w/git-gui.git/">http://repo.or.cz/w/git-gui.git/</a>.</p>
421</div>
422<h2>Author</h2>
423<div class="sectionbody">
424<p>Written by Shawn O. Pearce &lt;spearce@spearce.org&gt;.</p>
425</div>
426<h2>Documentation</h2>
427<div class="sectionbody">
428<p>Documentation by Shawn O. Pearce &lt;spearce@spearce.org&gt;.</p>
429</div>
430<h2>GIT</h2>
431<div class="sectionbody">
432<p>Part of the <a href="git.html">git(7)</a> suite</p>
433</div>
434<div id="footer">
435<div id="footer-text">
Junio C Hamanobb6e0782007-07-19 02:14:50[diff] [blame]436Last updated 19-Jul-2007 02:09:42 UTC
Junio C Hamano58784fc2007-06-23 08:48:57[diff] [blame]437</div>
438</div>
439</body>
440</html>