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">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.2.5" />
7 <style type=
"text/css">
9 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
11 border: 1px solid red;
16 margin: 1em 5% 1em 5%;
21 text-decoration: underline
;
39 h1
, h2
, h3
, h4
, h5
, h6
{
41 font-family: sans-serif
;
48 border-bottom: 2px solid silver
;
66 border: 1px solid silver
;
81 font-family: sans-serif
;
88 font-family: sans-serif
;
92 font-family: sans-serif
;
94 border-top: 2px solid silver
;
100 padding-bottom: 0.5em;
104 padding-bottom: 0.5em;
108 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
109 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
110 div
.admonitionblock
{
113 margin-bottom: 1.5em;
115 div
.admonitionblock
{
117 margin-bottom: 2.5em;
120 div
.content
{ /* Block element content. */
124 /* Block element titles. */
125 div
.title
, caption
.title
{
126 font-family: sans-serif
;
130 margin-bottom: 0.5em;
136 td div
.title:first-child
{
139 div
.content div
.title:first-child
{
142 div
.content
+ div
.title
{
146 div
.sidebarblock
> div
.content
{
148 border: 1px solid silver
;
155 div
.listingblock
> div
.content
{
156 border: 1px solid silver
;
161 div
.quoteblock
> div
.content
{
168 div
.verseblock
+ div
.attribution
{
172 div
.admonitionblock
.icon
{
176 text-decoration: underline
;
178 padding-right: 0.5em;
180 div
.admonitionblock td
.content
{
182 border-left: 2px solid silver
;
185 div
.exampleblock
> div
.content
{
186 border-left: 2px solid silver
;
190 div
.verseblock div
.content
{
194 div
.imageblock div
.content
{ padding-left: 0; }
195 div
.imageblock img
{ border: 1px solid silver
; }
196 span
.image img
{ border-style: none
; }
200 margin-bottom: 0.8em;
212 list-style-position: outside
;
215 list-style-type: lower-alpha
;
218 div
.tableblock
> table
{
219 border: 3px solid
#527bbd;
222 font-family: sans-serif
;
231 margin-bottom: 0.8em;
239 padding-right: 0.8em;
246 div#footer-badges
{ display: none
; }
251 font-family: sans-serif
;
255 margin-bottom: 0.1em;
258 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
274 include1::./stylesheets
/xhtml11-manpage
.css
[]
275 /* Workarounds for IE6's broken and incomplete CSS2. */
277 div
.sidebar-content
{
279 border: 1px solid silver
;
282 div
.sidebar-title
, div
.image-title
{
283 font-family: sans-serif
;
286 margin-bottom: 0.5em;
289 div
.listingblock div
.content
{
290 border: 1px solid silver
;
295 div
.quoteblock-content
{
299 div
.exampleblock-content
{
300 border-left: 2px solid silver
;
304 /* IE6 sets dynamically generated links as visited. */
305 div#toc
a:visited
{ color: blue
; }
307 <title>git-gui(
1)
</title>
312 git-gui(
1) Manual Page
315 <div class=
"sectionbody">
317 A portable graphical interface to Git
322 <div class=
"sectionbody">
323 <div class=
"para"><p><em>git gui
</em> [
<command
>] [arguments]
</p></div>
325 <h2 id=
"_description">DESCRIPTION
</h2>
326 <div class=
"sectionbody">
327 <div class=
"para"><p>A Tcl/Tk based graphical user interface to Git.
<em>git gui
</em> focuses
328 on allowing users to make changes to their repository by making
329 new commits, amending existing ones, creating branches, performing
330 local merges, and fetching/pushing to remote repositories.
</p></div>
331 <div class=
"para"><p>Unlike
<em>gitk
</em>,
<em>git gui
</em> focuses on commit generation
332 and single file annotation and does not show project history.
333 It does however supply menu actions to start a
<em>gitk
</em> session from
334 within
<em>git gui
</em>.
</p></div>
335 <div class=
"para"><p><em>git gui
</em> is known to work on all popular UNIX systems, Mac OS X,
336 and Windows (under both Cygwin and MSYS). To the extent possible
337 OS specific user interface guidelines are followed, making
<em>git gui
</em>
338 a fairly native interface for users.
</p></div>
340 <h2 id=
"_commands">COMMANDS
</h2>
341 <div class=
"sectionbody">
342 <div class=
"vlist"><dl>
348 Start a blame viewer on the specified file on the given
349 version (or working directory if not specified).
357 Start a tree browser showing all files in the specified
358 commit (or
<em>HEAD
</em> by default). Files selected through the
359 browser are opened in the blame viewer.
367 Start
<em>git gui
</em> and arrange to make exactly one commit before
368 exiting and returning to the shell. The interface is limited
369 to only commit actions, slightly reducing the application's
370 startup time and simplifying the menubar.
378 Display the currently running version of
<em>git gui
</em>.
383 <h2 id=
"_examples">Examples
</h2>
384 <div class=
"sectionbody">
385 <div class=
"vlist"><dl>
387 git gui blame Makefile
391 Show the contents of the file
<em>Makefile
</em> in the current
392 working directory, and provide annotations for both the
393 original author of each line, and who moved the line to its
394 current location. The uncommitted file is annotated, and
395 uncommitted changes (if any) are explicitly attributed to
396 <em>Not Yet Committed
</em>.
400 git gui blame v0.99
.8 Makefile
404 Show the contents of
<em>Makefile
</em> in revision
<em>v0.99
.8</em>
405 and provide annotations for each line. Unlike the above
406 example the file is read from the object database and not
407 the working directory.
411 git gui blame --line=
100 Makefile
415 Loads annotations as described above and automatically
416 scrolls the view to center on line
<em>100</em>.
424 Make one commit and return to the shell when it is complete.
425 This command returns a non-zero exit code if the window was
426 closed in any way other than by making a commit.
430 git gui citool --amend
434 Automatically enter the
<em>Amend Last Commit
</em> mode of
439 git gui citool --nocommit
443 Behave as normal citool, but instead of making a commit
444 simply terminate with a zero exit code. It still checks
445 that the index does not contain any unmerged entries, so
446 you can use it as a GUI version of
<a href=
"git-mergetool.html">git-mergetool(
1)
</a>
454 Same as
<tt>git gui citool
</tt> (above).
458 git gui browser maint
462 Show a browser for the tree of the
<em>maint
</em> branch. Files
463 selected in the browser can be viewed with the internal
469 <h2 id=
"_see_also">SEE ALSO
</h2>
470 <div class=
"sectionbody">
471 <div class=
"vlist"><dl>
473 <a href=
"gitk.html">gitk(
1)
</a>
477 The git repository browser. Shows branches, commit history
478 and file differences. gitk is the utility started by
479 <em>git gui
</em>'s Repository Visualize actions.
484 <h2 id=
"_other">Other
</h2>
485 <div class=
"sectionbody">
486 <div class=
"para"><p><em>git gui
</em> is actually maintained as an independent project, but stable
487 versions are distributed as part of the Git suite for the convenience
488 of end users.
</p></div>
489 <div class=
"para"><p>A
<em>git gui
</em> development repository can be obtained from:
</p></div>
490 <div class=
"literalblock">
491 <div class=
"content">
492 <pre><tt>git clone git://repo.or.cz/git-gui.git
</tt></pre>
494 <div class=
"para"><p>or
</p></div>
495 <div class=
"literalblock">
496 <div class=
"content">
497 <pre><tt>git clone http://repo.or.cz/r/git-gui.git
</tt></pre>
499 <div class=
"para"><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></div>
501 <h2 id=
"_author">Author
</h2>
502 <div class=
"sectionbody">
503 <div class=
"para"><p>Written by Shawn O. Pearce
<spearce@spearce.org
>.
</p></div>
505 <h2 id=
"_documentation">Documentation
</h2>
506 <div class=
"sectionbody">
507 <div class=
"para"><p>Documentation by Shawn O. Pearce
<spearce@spearce.org
>.
</p></div>
509 <h2 id=
"_git">GIT
</h2>
510 <div class=
"sectionbody">
511 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
514 <div id=
"footer-text">
515 Last updated
2010-
01-
21 17:
44:
30 UTC