/b-gtk/fix-viz

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/b-gtk/fix-viz

« back to all changes in this revision

Viewing changes to README

  • Committer: Jelmer Vernooij
  • Date: 2006-05-19 16:56:46 UTC
  • mfrom: (0.1.25 gannotate)
  • Revision ID: jelmer@samba.org-20060519165646-0d867938fdbc9097
Merge in Dan Loda's gannotate plugin and put it in annotate/

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
14
14
need the following runtime dependencies:
15
15
 
16
16
  * Python 2.4
17
 
  * Bazaar with the same major version as bzr-gtk
 
17
  * bzr 0.8 or later
18
18
  * PyGTK 2.8 or later
19
19
 
20
20
In order to see graphs in the visualisation tool, you will also need:
21
21
 
22
22
  * PyCairo 1.0 or later
23
23
 
24
 
In order to see syntax highlighted diffs:
25
 
 
26
 
  * gtksourceview python bindings (on Debian and Ubuntu systems, these
27
 
    are in the python-gnome2-desktop package)
28
 
 
29
 
In order to use the nautilus integration, you will need:
30
 
 
31
 
 * python-nautilus
32
 
 
33
 
For Olive on Windows:
34
 
 
35
 
 * pyWin32 (tested with build 209)
36
24
 
37
25
Installation
38
26
------------
44
32
your bzr working tree, or adding the location of bzr-gtk to your
45
33
BZR_PLUGIN_PATH environment variable.
46
34
 
47
 
Note: the plugin directory of bzr-gtk must be called 'gtk'.
48
 
 
49
 
To use the nautilus integration, either place the nautilus-bzr.py file in
50
 
~/.nautilus/python-extensions or in /usr/lib/nautilus/extensions-1.0/python
51
 
 
52
 
Please note that python-nautilus currently uses the .so file of Python 
53
 
so you will need to have python-dev installed or you need to manually create a 
54
 
libpythonVER.so symlink in /usr/lib (where VER is your version of python, e.g.
55
 
2.4 or 2.5).
56
 
 
57
35
Usage - Visualisation
58
36
---------------------
59
37
 
91
69
day will be highlighted blue, but changes in the past hour will be red and
92
70
lines 2 hours old may be orange. Highlighting can be turned off with --plain
93
71
if overwhelming.
94
 
 
95
 
Usage - diff window
96
 
-------------------
97
 
 
98
 
If you have the gtksourceview python bindings installed, the diff window
99
 
will have syntax highlighting. If the python GConf bindings are installed, 
100
 
the colors will be read from gedit's syntax highlighting configuration
101
 
for the "Diff" language.
102
 
 
103
 
Afterwards, colors from the ~/.colordiffrc file will be read, and will
104
 
override gedit's. Since that file may be written for a dark background
105
 
environment, the file ~/.colordiffrc.bzr-gtk can be used to override
106
 
some values.
107
 
 
108
 
Because gtksourceview is more configurable that colordiff, in addition
109
 
to the 'oldtext', 'newtext', and 'diffstuff' keys, the following keys
110
 
are also accepted: 'location', 'file', 'specialcase'.
111
 
 
112
 
Colors can be specified with names (valid names are those in the
113
 
/usr/share/X11/rgb.txt file), or with a #RRGGBB notation.
114
 
 
115
 
Install on Windows
116
 
------------------
117
 
 
118
 
You can download the dependencies from the following locations:
119
 
 
120
 
 - Python: http://www.python.org/download/releases/2.4.3/
121
 
 - GTK: http://gladewin32.sourceforge.net/
122
 
 - PyGTK: http://www.mapr.ucl.ac.be/~gustin/win32_ports (pygtk, pygobject and pycairo)
123
 
 - Bazaar: http://bazaar-vcs.org/WindowsDownloads (Python-based should be okay)
124
 
 - pyWin32: http://sourceforge.net/project/showfiles.php?group_id=78018
125
 
 
126
 
As an Administrator, you can install Olive with the standard command:
127
 
 
128
 
 > c:\Python24\python.exe setup.py install
129
 
 
130
 
You can run Olive with this command:
131
 
 
132
 
 > c:\Python24\python.exe c:\Python\Scripts\olive-gtk
133
 
 
134