1
bzrk - visualisation plugin for bzr
2
===================================
1
bzr-gtk - GTK+ Frontends to various Bazaar commands
2
===================================================
4
This is a plugin for bzr that allows you to see the history of a branch
5
and relationships between the revisions visually.
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
11
bzrk is written in Python, so doesn't need compiling, however you will
13
bzr-gtk is written in Python, so doesn't need compiling, however you will
12
14
need the following runtime dependencies:
16
18
* PyGTK 2.8 or later
20
In order to see graphs in the visualisation tool, you will also need:
17
22
* PyCairo 1.0 or later
23
The easiest way to install bzrk is to either copy or symlink the
28
The easiest way to install bzr-gtk is to either copy or symlink the
24
29
directory into your ~/.bazaar/plugins directory.
26
31
Other ways include doing the same in the bzrlib/plugins directory of
27
your bzr working tree, or adding the location of bzrk to your
32
your bzr working tree, or adding the location of bzr-gtk to your
28
33
BZR_PLUGIN_PATH environment variable.
34
38
Simply run "bzr visualise" (or "bzr viz") while in a bzr working tree or
35
39
branch, a window will appear with the history of the branch and a graph
44
48
including the ids of the parent revisions. Clicking on the go icon next
45
49
to a parent moves the list to that revision; clicking on the view icon
46
50
opens a window to display the difference between the two revisions.
55
Simply run "bzr gannotate FILENAME" while in a bzr working tree or branch.
57
The commit log message is shown in the lower window pane for the selected
58
line. The line number column is searchable; jump to a specific line by typing
59
the line number while the annotation pane is in focus. Control-f will also
62
By default, lines are highlighted according to age. This functionality is a
63
crib of emacs' VC-annotate highlighting, and thus works similarly: blue is
64
oldest and red is youngest, and an assortment of other colors in-between:
66
blue --> green --> yellow --> orange --> red
68
Time spans are scaled; for instance by selecting "1 Day", lines older than a
69
day will be highlighted blue, but changes in the past hour will be red and
70
lines 2 hours old may be orange. Highlighting can be turned off with --plain
added
removed
README
