git-cola(1)
NAME
git-cola - a highly caffeinated git gui
SYNOPSIS
git cola [options]
DESCRIPTION
git-cola is a git gui optimized for working with the git index. See
below for a full list of options and usage information.
OPTIONS
- --repo=<path>
- Run git-cola on the git repository in <path>.
- --style=<style>
- Launch git-cola with a different stylesheet.
GUI STYLES
git-cola ships with an alternate "dark" stylesheet. Specify
--style=dark or provide an external stylesheet with --style=PATH.
CONFIG VARIABLES
- cola.savewindowsettings
- Whether git-cola should remember its window settings.
- cola.geometry
- Specifies information about git-cola's window size and position.
- cola.fontui
- Specifies the font to use for the main git-cola interface.
- cola.fontdiff
- Specifies the font to use for git-cola's diff display.
- gui.diffcontext
- The number of diff context lines used and displayed by git-cola
- gui.editor
- The default text editor is controlled by gui.editor. The config
variable overrides the EDITOR environment variable. - gui.historybrowser
- Specifies the history browser to use when visualizing history.
- diff.tool
- The default diff tool to use. The config variable overrides the
GIT_DIFF_TOOL environment variable. - merge.tool
- The default merge tool to use. The config variable overrides the
GIT_MERGE_TOOL environment variable. - user.email
- Your email address to be recorded in any newly created commits. Can be overridden by the GIT_AUTHOR_EMAIL, GIT_COMMITTER_EMAIL, and EMAIL environment variables. See linkgit:git-commit-tree[1].
- user.name
- Your full name to be recorded in any newly created commits. Can be overridden by the GIT_AUTHOR_NAME and GIT_COMMITTER_NAME environment variables. See linkgit:git-commit-tree[1].
- See linkgit:git-config[1] for more details.
ENVIRONMENT VARIABLES
- EDITOR
- Specifies the default editor to use. This is ignored when the git
config variable gui.editor is defined. - GIT_DIFF_TOOL
- Specifies the default diff tool to use. This is ignored when the
git config variable diff.tool is defined. - GIT_MERGE_TOOL
- Specifies the default merge tool to use. This is ignored when the
git config variable merge.tool is defined.
SOURCE
- A git-cola development repository can be obtained via git:
- git clone git://github.com/davvid/git-cola.git
STYLESHEETS
git-cola ships with an alternative stylesheet called dark. You can use
this stylesheet by running git cola --style=dark.
You can also skin git-cola by providing your own Qt stylesheet. E.g.
git cola --style=/path/to/style.qss.
Built-in styles can be found in /usr/share/git-cola/styles.
LINKS
- git-cola homepage
- http://cola.tuxfamily.org/
- git-cola sources on github
- http://github.com/davvid/git-cola/tree/master
SEE ALSO
- linkgit:git-difftool[1]
- Compare changes using common merge tools. (New in git-1.6.3).
- linkgit:gitk[1]
- The git repository browser. Shows branches, commit history and file differences. gitk is the utility started by git-cola's Repository Visualize actions.
GIT
git-cola is independently developed from the linkgit:git[7] suite, but
you can use it just like any other git command, e.g. git cola.
AUTHOR
Written by David Aguilar <davvid@gmail.com[1]>.
NOTES
- 1. davvid@gmail.com
- mailto:davvid@gmail.com