bzr branch
http://gegoxaren.bato24.eu/bzr/b-gtk/fix-viz
|
49
by Jelmer Vernooij
Merge in Dan Loda's gannotate plugin and put it in annotate/ |
1 |
bzr-gtk - GTK+ Frontends to various Bazaar commands
|
2 |
===================================================
|
|
|
1
by Scott James Remnant
Commit the first version of bzrk. |
3 |
|
|
49
by Jelmer Vernooij
Merge in Dan Loda's gannotate plugin and put it in annotate/ |
4 |
This is a plugin for bzr that contains various GTK+ frontends to |
5 |
Bazaar commands. It currently contains a tool to see the history |
|
6 |
and relationships between the revisions visually and one to |
|
7 |
view annotated files. |
|
|
1
by Scott James Remnant
Commit the first version of bzrk. |
8 |
|
9 |
||
10 |
Dependencies
|
|
11 |
------------
|
|
12 |
||
|
49
by Jelmer Vernooij
Merge in Dan Loda's gannotate plugin and put it in annotate/ |
13 |
bzr-gtk is written in Python, so doesn't need compiling, however you will |
|
1
by Scott James Remnant
Commit the first version of bzrk. |
14 |
need the following runtime dependencies: |
15 |
||
16 |
* Python 2.4
|
|
|
40
by David Allouche
remove --robust, pyflakes fixes, update README |
17 |
* bzr 0.8 or later
|
|
1
by Scott James Remnant
Commit the first version of bzrk. |
18 |
* PyGTK 2.8 or later
|
|
49
by Jelmer Vernooij
Merge in Dan Loda's gannotate plugin and put it in annotate/ |
19 |
|
20 |
In order to see graphs in the visualisation tool, you will also need: |
|
21 |
||
|
1
by Scott James Remnant
Commit the first version of bzrk. |
22 |
* PyCairo 1.0 or later
|
23 |
||
|
50
by Jelmer Vernooij
Add note about gtksourceview |
24 |
In order to see syntax highlighted diffs: |
25 |
||
26 |
* gtksourceview python bindings
|
|
|
1
by Scott James Remnant
Commit the first version of bzrk. |
27 |
|
28 |
Installation
|
|
29 |
------------
|
|
30 |
||
|
49
by Jelmer Vernooij
Merge in Dan Loda's gannotate plugin and put it in annotate/ |
31 |
The easiest way to install bzr-gtk is to either copy or symlink the |
|
1
by Scott James Remnant
Commit the first version of bzrk. |
32 |
directory into your ~/.bazaar/plugins directory. |
33 |
||
34 |
Other ways include doing the same in the bzrlib/plugins directory of |
|
|
49
by Jelmer Vernooij
Merge in Dan Loda's gannotate plugin and put it in annotate/ |
35 |
your bzr working tree, or adding the location of bzr-gtk to your |
|
1
by Scott James Remnant
Commit the first version of bzrk. |
36 |
BZR_PLUGIN_PATH environment variable. |
37 |
||
|
49
by Jelmer Vernooij
Merge in Dan Loda's gannotate plugin and put it in annotate/ |
38 |
Usage - Visualisation
|
39 |
---------------------
|
|
|
1
by Scott James Remnant
Commit the first version of bzrk. |
40 |
|
|
40
by David Allouche
remove --robust, pyflakes fixes, update README |
41 |
Simply run "bzr visualise" (or "bzr viz") while in a bzr working tree or |
42 |
branch, a window will appear with the history of the branch and a graph |
|
|
1
by Scott James Remnant
Commit the first version of bzrk. |
43 |
connecting the individual revisions. |
44 |
||
|
12
by Scott James Remnant
Update the docs |
45 |
You can move through the revision history by clicking or with the arrow |
46 |
keys. You can also use the Back (shortcut '[') and Forward (shortcut ']') |
|
47 |
buttons which move to the previous and next revision from that selected |
|
48 |
(which may not be immediately adjacent in the list). |
|
49 |
||
50 |
Details for the selected revision are shown in the pane at the bottom, |
|
51 |
including the ids of the parent revisions. Clicking on the go icon next |
|
52 |
to a parent moves the list to that revision; clicking on the view icon |
|
53 |
opens a window to display the difference between the two revisions. |
|
|
49
by Jelmer Vernooij
Merge in Dan Loda's gannotate plugin and put it in annotate/ |
54 |
|
55 |
Usage - annotate
|
|
56 |
----------------
|
|
57 |
||
58 |
Simply run "bzr gannotate FILENAME" while in a bzr working tree or branch. |
|
59 |
||
60 |
The commit log message is shown in the lower window pane for the selected |
|
61 |
line. The line number column is searchable; jump to a specific line by typing |
|
62 |
the line number while the annotation pane is in focus. Control-f will also |
|
63 |
initiate a search. |
|
64 |
||
65 |
By default, lines are highlighted according to age. This functionality is a |
|
66 |
crib of emacs' VC-annotate highlighting, and thus works similarly: blue is |
|
67 |
oldest and red is youngest, and an assortment of other colors in-between: |
|
68 |
||
69 |
blue --> green --> yellow --> orange --> red |
|
70 |
||
71 |
Time spans are scaled; for instance by selecting "1 Day", lines older than a |
|
72 |
day will be highlighted blue, but changes in the past hour will be red and |
|
73 |
lines 2 hours old may be orange. Highlighting can be turned off with --plain |
|
74 |
if overwhelming. |