1GIT-COLA(1)                       Git Manual                       GIT-COLA(1)
2
3
4

NAME

6       git-cola - A highly caffeinated git GUI
7

SYNOPSIS

9       git cola [options]
10

DESCRIPTION

12       git-cola is a powerful git GUI written in Python. It has many unique
13       features that make git’s advanced features simple and accessible.
14
15       See below for a full list of options and usage information.
16

OPTIONS

18       --classic
19           Launch the standalone cola classic tool.
20
21       -g, --git-path
22           Specifies the path to the git binary.
23
24       --prompt
25           Prompt for a git repository instead of auto-detecting it in the
26           current directory.
27
28       -r, --repo=<path>
29           Run git-cola on the git repository in <path>. Defaults to the
30           current directory.
31
32       -s, --style=<style>
33           Launch git-cola with a different stylesheet.
34
35       -v, --version
36           Print the git-cola version and exit.
37

GUI STYLES

39       git-cola ships with an alternate "dark" stylesheet. Specify
40       --style=dark or provide an external stylesheet with --style=PATH.
41

CONFIG VARIABLES

43       cola.savewindowsettings
44           Whether git-cola should remember its window settings.
45
46       cola.fontdiff
47           Specifies the font to use for git-cola's diff display.
48
49       cola.classicdockable
50           Whether to create a dock widget with the Cola Classic tool.
51           Defaults to false to speedup startup time.
52
53       gui.diffcontext
54           The number of diff context lines used and displayed by git-cola
55
56       gui.editor
57           The default text editor is controlled by gui.editor. The config
58           variable overrides the EDITOR environment variable.
59
60       gui.historybrowser
61           Specifies the history browser to use when visualizing history.
62
63       diff.tool
64           The default diff tool to use.
65
66       merge.tool
67           The default merge tool to use.
68
69       user.email
70           Your email address to be recorded in any newly created commits. Can
71           be overridden by the GIT_AUTHOR_EMAIL, GIT_COMMITTER_EMAIL, and
72           EMAIL environment variables. See linkgit:git-commit-tree[1].
73
74       user.name
75           Your full name to be recorded in any newly created commits. Can be
76           overridden by the GIT_AUTHOR_NAME and GIT_COMMITTER_NAME
77           environment variables. See linkgit:git-commit-tree[1].
78       See linkgit:git-config[1] for more details.
79

ENVIRONMENT VARIABLES

81       EDITOR
82           Specifies the default editor to use. This is ignored when the git
83           config variable gui.editor is defined.
84
85       GIT_PYTHON_TRACE
86           When defined, prints git commands and status to the terminal. Print
87           more information when set to the value full.
88
89       GIT_COLA_TRACE
90           When defined, git-cola outputs the git commands it executes into
91           the Command Output log viewer.
92

SOURCE

94       A git-cola development repository can be obtained via git:
95
96
97           git clone git://github.com/davvid/git-cola.git
98

GUI THEMES

100       git-cola ships with an alternative stylesheet called dark. You can use
101       this stylesheet by running git cola --style=dark.
102
103       You can also skin git-cola by providing your own Qt stylesheet. E.g.
104       git cola --style=/path/to/style.qss.
105
106       Built-in styles can be found in /usr/share/git-cola/styles.
107

LINKS

109       git-cola homepage
110           http://cola.tuxfamily.org/
111
112       git-cola sources on github
113           http://github.com/davvid/git-cola
114

SEE ALSO

116       linkgit:git-difftool[1]
117           Compare changes using common merge tools.
118
119       linkgit:gitk[1]
120           The git repository browser. Shows branches, commit history and file
121           differences. gitk is the utility started by git-cola's Repository
122           Visualize actions.
123

GIT

125       git-cola is independently developed from the linkgit:git[7] suite, but
126       you can use it just like any other git command, e.g. git cola.
127

AUTHOR

129       Written by David Aguilar <davvid@gmail.com[1]>.
130

NOTES

132        1. davvid@gmail.com
133           mailto:davvid@gmail.com
134
135
136
137Git                               08/21/2011                       GIT-COLA(1)