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 | ----------- | |
| 14 | A Tcl/Tk based graphical user interface to Git. git-gui focuses | |
| 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 | ||
| 5162e697 | 19 | Unlike linkgit:gitk[1], git-gui focuses on commit generation |
| 37cd4f7e SP |
20 | and single file annotation, and does not show project history. |
| 21 | It does however supply menu actions to start a gitk session from | |
| 22 | within git-gui. | |
| 23 | ||
| 24 | git-gui is known to work on all popular UNIX systems, Mac OS X, | |
| 25 | and Windows (under both Cygwin and MSYS). To the extent possible | |
| 26 | OS specific user interface guidelines are followed, making git-gui | |
| 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 | |
| 37 | commit (or 'HEAD' by default). Files selected through the | |
| 38 | browser are opened in the blame viewer. | |
| 39 | ||
| 40 | citool:: | |
| 41 | Start git-gui and arrange to make exactly one commit before | |
| 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:: | |
| 47 | Display the currently running version of git-gui. | |
| 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' | |
| 64 | and provide annotations for each line. Unlike the above | |
| 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 | ||
| 74 | Same as 'git gui citool' (above). | |
| 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 | |
| 87 | git-gui's Repository Visualize actions. | |
| 88 | ||
| 89 | Other | |
| 90 | ----- | |
| 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 | ||
| 95 | A git-gui development repository can be obtained from: | |
| 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 | --- | |
| 5162e697 | 115 | Part of the linkgit:git[7] suite |