'\" t
.\"     Title: git-cola
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 09/01/2011
.\"    Manual: Git Manual
.\"    Source: Git
.\"  Language: English
.\"
.TH "GIT\-COLA" "1" "09/01/2011" "Git" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
git-cola \- A highly caffeinated git GUI
.SH "SYNOPSIS"
\fIgit cola\fR [options]
.SH "DESCRIPTION"
\fIgit\-cola\fR is a powerful git GUI written in Python\&. It has many unique features that make git\(cqs advanced features simple and accessible\&.

See below for a full list of options and usage information\&.
.SH "OPTIONS"
.PP
\-\-classic
.RS 4
Launch the standalone \fIcola classic\fR tool\&.
.RE
.PP
\-g, \-\-git\-path
.RS 4
Specifies the path to the \fIgit\fR binary\&.
.RE
.PP
\-\-prompt
.RS 4
Prompt for a git repository instead of auto\-detecting it in the current directory\&.
.RE
.PP
\-r, \-\-repo=<path>
.RS 4
Run \fIgit\-cola\fR on the git repository in <path>\&. Defaults to the current directory\&.
.RE
.PP
\-s, \-\-style=<style>
.RS 4
Launch \fIgit\-cola\fR with a different stylesheet\&.
.RE
.PP
\-v, \-\-version
.RS 4
Print the \fIgit\-cola\fR version and exit\&.
.RE
.SH "GUI STYLES"
\fIgit\-cola\fR ships with an alternate "dark" stylesheet\&. Specify \-\-style=dark or provide an external stylesheet with \-\-style=PATH\&.
.SH "CONFIG VARIABLES"
.PP
cola\&.savewindowsettings
.RS 4
Whether \fIgit\-cola\fR should remember its window settings\&.
.RE
.PP
cola\&.fontdiff
.RS 4
Specifies the font to use for \fIgit\-cola\fR\*(Aqs diff display\&.
.RE
.PP
cola\&.classicdockable
.RS 4
Whether to create a dock widget with the \fICola Classic\fR tool\&. Defaults to \fIfalse\fR to speedup startup time\&.
.RE
.PP
gui\&.diffcontext
.RS 4
The number of diff context lines used and displayed by \fIgit\-cola\fR
.RE
.PP
gui\&.editor
.RS 4
The default text editor is controlled by gui\&.editor\&. The config variable overrides the EDITOR environment variable\&.
.RE
.PP
gui\&.historybrowser
.RS 4
Specifies the history browser to use when visualizing history\&.
.RE
.PP
diff\&.tool
.RS 4
The default diff tool to use\&.
.RE
.PP
merge\&.tool
.RS 4
The default merge tool to use\&.
.RE
.PP
user\&.email
.RS 4
Your email address to be recorded in any newly created commits\&. Can be overridden by the \fIGIT_AUTHOR_EMAIL\fR, \fIGIT_COMMITTER_EMAIL\fR, and \fIEMAIL\fR environment variables\&. See linkgit:git\-commit\-tree[1]\&.
.RE
.PP
user\&.name
.RS 4
Your full name to be recorded in any newly created commits\&. Can be overridden by the \fIGIT_AUTHOR_NAME\fR and \fIGIT_COMMITTER_NAME\fR environment variables\&. See linkgit:git\-commit\-tree[1]\&.
.RE
See linkgit:git\-config[1] for more details\&.
.SH "ENVIRONMENT VARIABLES"
.PP
EDITOR
.RS 4
Specifies the default editor to use\&. This is ignored when the git config variable gui\&.editor is defined\&.
.RE
.PP
GIT_PYTHON_TRACE
.RS 4
When defined, prints git commands and status to the terminal\&. Print more information when set to the value \fIfull\fR\&.
.RE
.PP
GIT_COLA_TRACE
.RS 4
When defined, \fIgit\-cola\fR outputs the \fIgit\fR commands it executes into the \fICommand Output\fR log viewer\&.
.RE
.SH "SOURCE"
A \fIgit\-cola\fR development repository can be obtained via git:

.sp
.if n \{\
.RS 4
.\}
.nf
git clone git://github\&.com/davvid/git\-cola\&.git
.fi
.if n \{\
.RE
.\}
.SH "GUI THEMES"
\fIgit\-cola\fR ships with an alternative stylesheet called \fIdark\fR\&. You can use this stylesheet by running git cola \-\-style=dark\&.

You can also skin \fIgit\-cola\fR 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\&.
.SH "LINKS"
.PP
\fIgit\-cola\fR homepage
.RS 4
\m[blue]\fBhttp://cola\&.tuxfamily\&.org/\fR\m[]
.RE
.PP
\fIgit\-cola\fR sources on github
.RS 4
\m[blue]\fBhttp://github\&.com/davvid/git\-cola\fR\m[]
.RE
.SH "SEE ALSO"
.PP
linkgit:git\-difftool[1]
.RS 4
Compare changes using common merge tools\&.
.RE
.PP
linkgit:gitk[1]
.RS 4
The git repository browser\&. Shows branches, commit history and file differences\&. gitk is the utility started by \fIgit\-cola\fR\*(Aqs Repository Visualize actions\&.
.RE
.SH "GIT"
\fIgit\-cola\fR is independently developed from the linkgit:git[7] suite, but you can use it just like any other git command, e\&.g\&. git cola\&.
.SH "AUTHOR"
Written by David Aguilar <\m[blue]\fBdavvid@gmail\&.com\fR\m[]\&\s-2\u[1]\d\s+2>\&.
.SH "NOTES"
.IP " 1." 4
davvid@gmail.com
.RS 4
\%mailto:davvid@gmail.com
.RE