You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
115 lines
3.0 KiB
115 lines
3.0 KiB
git-gui(1) |
|
========== |
|
|
|
NAME |
|
---- |
|
git-gui - A portable graphical interface to Git |
|
|
|
SYNOPSIS |
|
-------- |
|
'git gui' [<command>] [arguments] |
|
|
|
DESCRIPTION |
|
----------- |
|
A Tcl/Tk based graphical user interface to Git. git-gui focuses |
|
on allowing users to make changes to their repository by making |
|
new commits, amending existing ones, creating branches, performing |
|
local merges, and fetching/pushing to remote repositories. |
|
|
|
Unlike gitlink:gitk[1], git-gui focuses on commit generation |
|
and single file annotation, and does not show project history. |
|
It does however supply menu actions to start a gitk session from |
|
within git-gui. |
|
|
|
git-gui is known to work on all popular UNIX systems, Mac OS X, |
|
and Windows (under both Cygwin and MSYS). To the extent possible |
|
OS specific user interface guidelines are followed, making git-gui |
|
a fairly native interface for users. |
|
|
|
COMMANDS |
|
-------- |
|
blame:: |
|
Start a blame viewer on the specified file on the given |
|
version (or working directory if not specified). |
|
|
|
browser:: |
|
Start a tree browser showing all files in the specified |
|
commit (or 'HEAD' by default). Files selected through the |
|
browser are opened in the blame viewer. |
|
|
|
citool:: |
|
Start git-gui and arrange to make exactly one commit before |
|
exiting and returning to the shell. The interface is limited |
|
to only commit actions, slightly reducing the application's |
|
startup time and simplifying the menubar. |
|
|
|
version:: |
|
Display the currently running version of git-gui. |
|
|
|
|
|
Examples |
|
-------- |
|
git gui blame Makefile:: |
|
|
|
Show the contents of the file 'Makefile' in the current |
|
working directory, and provide annotations for both the |
|
original author of each line, and who moved the line to its |
|
current location. The uncommitted file is annotated, and |
|
uncommitted changes (if any) are explicitly attributed to |
|
'Not Yet Committed'. |
|
|
|
git gui blame v0.99.8 Makefile:: |
|
|
|
Show the contents of 'Makefile' in revision 'v0.99.8' |
|
and provide annotations for each line. Unlike the above |
|
example the file is read from the object database and not |
|
the working directory. |
|
|
|
git gui citool:: |
|
|
|
Make one commit and return to the shell when it is complete. |
|
|
|
git citool:: |
|
|
|
Same as 'git gui citool' (above). |
|
|
|
git gui browser maint:: |
|
|
|
Show a browser for the tree of the 'maint' branch. Files |
|
selected in the browser can be viewed with the internal |
|
blame viewer. |
|
|
|
See Also |
|
-------- |
|
'gitk(1)':: |
|
The git repository browser. Shows branches, commit history |
|
and file differences. gitk is the utility started by |
|
git-gui's Repository Visualize actions. |
|
|
|
Other |
|
----- |
|
git-gui is actually maintained as an independent project, but stable |
|
versions are distributed as part of the Git suite for the convience |
|
of end users. |
|
|
|
A git-gui development repository can be obtained from: |
|
|
|
git clone git://repo.or.cz/git-gui.git |
|
|
|
or |
|
|
|
git clone http://repo.or.cz/r/git-gui.git |
|
|
|
or browsed online at http://repo.or.cz/w/git-gui.git/[]. |
|
|
|
Author |
|
------ |
|
Written by Shawn O. Pearce <spearce@spearce.org>. |
|
|
|
Documentation |
|
-------------- |
|
Documentation by Shawn O. Pearce <spearce@spearce.org>. |
|
|
|
GIT |
|
--- |
|
Part of the gitlink:git[7] suite
|
|
|