projects / thirdparty / git.git / blame
| Commit | Line | Data |
|---|---|---|
| 37cd4f7e SP |
1 | git-gui(1) |
| 2 | ========== | |
| 3 | ||
| 4 | NAME | |
| 5 | ---- | |
| 6 | git-gui - A portable graphical interface to Git | |
| 7 | ||
| 8 | SYNOPSIS | |
| 9 | -------- | |
| 10 | 'git gui' [<command>] [arguments] | |
| 11 | ||
| 12 | DESCRIPTION | |
| 13 | ----------- | |
| ba020ef5 | 14 | A Tcl/Tk based graphical user interface to Git. 'git-gui' focuses |
| 37cd4f7e SP |
15 | on allowing users to make changes to their repository by making |
| 16 | new commits, amending existing ones, creating branches, performing | |
| 17 | local merges, and fetching/pushing to remote repositories. | |
| 18 | ||
| 42d36bb8 | 19 | Unlike 'gitk', 'git-gui' focuses on commit generation |
| 483bc4f0 | 20 | and single file annotation and does not show project history. |
| 42d36bb8 | 21 | It does however supply menu actions to start a 'gitk' session from |
| ba020ef5 | 22 | within 'git-gui'. |
| 37cd4f7e | 23 | |
| ba020ef5 | 24 | 'git-gui' is known to work on all popular UNIX systems, Mac OS X, |
| 37cd4f7e | 25 | and Windows (under both Cygwin and MSYS). To the extent possible |
| ba020ef5 | 26 | OS specific user interface guidelines are followed, making 'git-gui' |
| 37cd4f7e SP |
27 | a fairly native interface for users. |
| 28 | ||
| 29 | COMMANDS | |
| 30 | -------- | |
| 31 | blame:: | |
| 32 | Start a blame viewer on the specified file on the given | |
| 33 | version (or working directory if not specified). | |
| 34 | ||
| 35 | browser:: | |
| 36 | Start a tree browser showing all files in the specified | |
| 7f9d77f2 | 37 | commit (or 'HEAD' by default). Files selected through the |
| 37cd4f7e SP |
38 | browser are opened in the blame viewer. |
| 39 | ||
| 40 | citool:: | |
| ba020ef5 | 41 | Start 'git-gui' and arrange to make exactly one commit before |
| 37cd4f7e SP |
42 | exiting and returning to the shell. The interface is limited |
| 43 | to only commit actions, slightly reducing the application's | |
| 44 | startup time and simplifying the menubar. | |
| 45 | ||
| 46 | version:: | |
| ba020ef5 | 47 | Display the currently running version of 'git-gui'. |
| 37cd4f7e SP |
48 | |
| 49 | ||
| 50 | Examples | |
| 51 | -------- | |
| 52 | git gui blame Makefile:: | |
| 53 | ||
| 54 | Show the contents of the file 'Makefile' in the current | |
| 55 | working directory, and provide annotations for both the | |
| 56 | original author of each line, and who moved the line to its | |
| 57 | current location. The uncommitted file is annotated, and | |
| 58 | uncommitted changes (if any) are explicitly attributed to | |
| 59 | 'Not Yet Committed'. | |
| 60 | ||
| 61 | git gui blame v0.99.8 Makefile:: | |
| 62 | ||
| 63 | Show the contents of 'Makefile' in revision 'v0.99.8' | |
| 7f9d77f2 | 64 | and provide annotations for each line. Unlike the above |
| 37cd4f7e SP |
65 | example the file is read from the object database and not |
| 66 | the working directory. | |
| 67 | ||
| 68 | git gui citool:: | |
| 69 | ||
| 70 | Make one commit and return to the shell when it is complete. | |
| 71 | ||
| 72 | git citool:: | |
| 73 | ||
| db5d6666 | 74 | Same as `git gui citool` (above). |
| 37cd4f7e SP |
75 | |
| 76 | git gui browser maint:: | |
| 77 | ||
| 78 | Show a browser for the tree of the 'maint' branch. Files | |
| 79 | selected in the browser can be viewed with the internal | |
| 80 | blame viewer. | |
| 81 | ||
| 56ae8df5 | 82 | SEE ALSO |
| 37cd4f7e | 83 | -------- |
| 56ae8df5 | 84 | linkgit:gitk[1]:: |
| 37cd4f7e SP |
85 | The git repository browser. Shows branches, commit history |
| 86 | and file differences. gitk is the utility started by | |
| ba020ef5 | 87 | 'git-gui''s Repository Visualize actions. |
| 37cd4f7e SP |
88 | |
| 89 | Other | |
| 90 | ----- | |
| ba020ef5 | 91 | 'git-gui' is actually maintained as an independent project, but stable |
| 02783075 | 92 | versions are distributed as part of the Git suite for the convenience |
| 37cd4f7e SP |
93 | of end users. |
| 94 | ||
| ba020ef5 | 95 | A 'git-gui' development repository can be obtained from: |
| 37cd4f7e SP |
96 | |
| 97 | git clone git://repo.or.cz/git-gui.git | |
| 98 | ||
| 99 | or | |
| 100 | ||
| 101 | git clone http://repo.or.cz/r/git-gui.git | |
| 102 | ||
| 103 | or browsed online at http://repo.or.cz/w/git-gui.git/[]. | |
| 104 | ||
| 105 | Author | |
| 106 | ------ | |
| 107 | Written by Shawn O. Pearce <spearce@spearce.org>. | |
| 108 | ||
| 109 | Documentation | |
| 110 | -------------- | |
| 111 | Documentation by Shawn O. Pearce <spearce@spearce.org>. | |
| 112 | ||
| 113 | GIT | |
| 114 | --- | |
| 9e1f0a85 | 115 | Part of the linkgit:git[1] suite |