git-citool(1)

DESCRIPTION

A Tcl/Tk based graphical interface to review modified files, stage +them into the index, enter a commit message and record the new +commit onto the current branch. This interface is an alternative +to the less interactive git-commit(1) program.

git-citool is actually a standard alias for git gui citool. +See git-gui(1) for more details.

GIT

Part of the git(7) suite

. + +Documentation +-------------- +Documentation by Shawn O. Pearce . + +GIT +--- +Part of the gitlink:git[7] suite diff --git a/git-gui.html b/git-gui.html new file mode 100644 index 000000000..616039741 --- /dev/null +++ b/git-gui.html @@ -0,0 +1,440 @@ + + + + + + +git-gui(1) + + + +

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 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. +
+

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

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 git(7) suite

+ + + diff --git a/git-gui.txt b/git-gui.txt new file mode 100644 index 000000000..bd613b2fc --- /dev/null +++ b/git-gui.txt @@ -0,0 +1,115 @@ +git-gui(1) +========== + +NAME +---- +git-gui - A portable graphical interface to Git + +SYNOPSIS +-------- +'git gui' [] [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 . + +Documentation +-------------- +Documentation by Shawn O. Pearce . + +GIT +--- +Part of the gitlink:git[7] suite diff --git a/git.html b/git.html index d11bbad4b..39195d30c 100644 --- a/git.html +++ b/git.html @@ -439,6 +439,14 @@ ancillary user utilities.

+git-citool(1) +

+ Graphical alternative to git-commit. +

git-clean(1)

@@ -511,6 +519,14 @@ ancillary user utilities.

+git-gui(1) +

+ A portable graphical interface to Git. +

git-init(1)

@@ -2325,7 +2341,7 @@ contributors on the git-list <git@vger.kernel.org>.