/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: 2008-06-29 18:12:29 UTC
  • mto: This revision was merged to the branch mainline in revision 519.
  • Revision ID: jelmer@samba.org-20080629181229-1l2m4cf7vvbyh8qg
Simplify progress bar code, use embedded progress bar inside viz window.

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
 
  * bzr 0.11 or later
 
17
  * Bazaar with the same major version as bzr-gtk
18
18
  * PyGTK 2.8 or later
19
19
 
20
20
In order to see graphs in the visualisation tool, you will also need:
23
23
 
24
24
In order to see syntax highlighted diffs:
25
25
 
26
 
  * gtksourceview python bindings
 
26
  * gtksourceview python bindings (on Debian and Ubuntu systems, these
 
27
    are in the python-gnome2-desktop package)
27
28
 
28
29
In order to use the nautilus integration, you will need:
29
30
 
30
31
 * python-nautilus
31
32
 
 
33
For Olive on Windows:
 
34
 
 
35
 * pyWin32 (tested with build 209)
 
36
 
32
37
Installation
33
38
------------
34
39
 
39
44
your bzr working tree, or adding the location of bzr-gtk to your
40
45
BZR_PLUGIN_PATH environment variable.
41
46
 
 
47
Note: the plugin directory of bzr-gtk must be called 'gtk'.
 
48
 
42
49
To use the nautilus integration, either place the nautilus-bzr.py file in
43
50
~/.nautilus/python-extensions or in /usr/lib/nautilus/extensions-1.0/python
44
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
 
45
57
Usage - Visualisation
46
58
---------------------
47
59
 
79
91
day will be highlighted blue, but changes in the past hour will be red and
80
92
lines 2 hours old may be orange. Highlighting can be turned off with --plain
81
93
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