/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.txt

  • Committer: Jelmer Vernooij
  • Date: 2006-09-13 20:19:31 UTC
  • mfrom: (0.8.79 main)
  • mto: (0.8.83 merge)
  • mto: This revision was merged to the branch mainline in revision 83.
  • Revision ID: jelmer@samba.org-20060913201931-23adba246d4d6529
Merge main branch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
README for Olive
 
2
================
 
3
 
 
4
What is Olive?
 
5
--------------
 
6
 
 
7
Olive is a GTK-based graphical frontend for Bazaar Version Control System
 
8
(http://bazaar-vcs.org/). It aims to be a user-friendly tool for those who are
 
9
not familiar with command line interfaces. Olive is written in Python, so it
 
10
can be run under different platforms (Linux and Windows are known to work).
 
11
 
 
12
Requirements
 
13
------------
 
14
 
 
15
 - Python (>= 2.4)
 
16
 - GTK (>= 2.8)
 
17
 - PyGTK (>= 2.8)
 
18
 - Bazaar (>= 0.8.2)
 
19
 - pyWin32 (only for Windows, tested with build 209)
 
20
 
 
21
Install on Linux
 
22
----------------
 
23
 
 
24
You just need to run the bundled setup script like this:
 
25
 
 
26
 # ./setup.py install
 
27
 
 
28
If you'd like to install to a different folder, you can:
 
29
 
 
30
 $ ./setup.py install --prefix /path/to/the/folder
 
31
 
 
32
Be sure to adjust the PATH values if you install to a custom location!
 
33
 
 
34
A desktop menu entry is shipped with the application, you'll find Olive in the
 
35
Programming category.
 
36
 
 
37
Install on Windows
 
38
------------------
 
39
 
 
40
You can download the dependencies from the following locations:
 
41
 
 
42
 - Python: http://www.python.org/download/releases/2.4.3/
 
43
 - GTK: http://gladewin32.sourceforge.net/
 
44
 - PyGTK: http://www.mapr.ucl.ac.be/~gustin/win32_ports/pygtk.html (pycairo too)
 
45
 - Bazaar: http://bazaar-vcs.org/WindowsDownloads (Python-based should be okay)
 
46
 - pyWin32: http://sourceforge.net/project/showfiles.php?group_id=78018
 
47
 
 
48
As an Administrator, you can install Olive with the standard command:
 
49
 
 
50
 > c:\Python24\python.exe setup.py install
 
51
 
 
52
You can run Olive with this command:
 
53
 
 
54
 > c:\Python24\python.exe c:\Python\Scripts\olive-gtk
 
55
 
 
56
Reporting bugs
 
57
--------------
 
58
 
 
59
The official bug tracker of Olive can be found in the Launchpad system. The list
 
60
of the opened bugs are here:
 
61
 
 
62
 https://launchpad.net/products/olive/+bugs
 
63
 
 
64
If you found a bug in Olive, please report it here:
 
65
 
 
66
 https://launchpad.net/products/olive/+filebug
 
67
 
 
68
Please run olive-gtk from the command line, so you can copy-paste the traceback
 
69
of the exceptions.