1
bzr-gtk - GTK+ Frontends to various Bazaar commands
2
===================================================
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
13
bzr-gtk is written in Python, so doesn't need compiling, however you will
14
need the following runtime dependencies:
20
In order to see graphs in the visualisation tool, you will also need:
22
* PyCairo 1.0 or later
28
The easiest way to install bzr-gtk is to either copy or symlink the
29
directory into your ~/.bazaar/plugins directory.
31
Other ways include doing the same in the bzrlib/plugins directory of
32
your bzr working tree, or adding the location of bzr-gtk to your
33
BZR_PLUGIN_PATH environment variable.
38
Simply run "bzr visualise" (or "bzr viz") while in a bzr working tree or
39
branch, a window will appear with the history of the branch and a graph
40
connecting the individual revisions.
42
You can move through the revision history by clicking or with the arrow
43
keys. You can also use the Back (shortcut '[') and Forward (shortcut ']')
44
buttons which move to the previous and next revision from that selected
45
(which may not be immediately adjacent in the list).
47
Details for the selected revision are shown in the pane at the bottom,
48
including the ids of the parent revisions. Clicking on the go icon next
49
to a parent moves the list to that revision; clicking on the view icon
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
