]>
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 |