The history of a SVN resource can be watched on a graphical representation of all the
revisions of that resource together with the tags in which the resource was included. The
graphical representation is identical to a tree structure and very easy to follow.
The graphical representation of a resource history is invoked with the Revision graph action
available on the right click menu of a SVN resource in the
Working Copy view and the Repository
The Revision Graph of a File Resource
In every node of the revision graph an icon and the background color represent the type of
operation that created the revision represented in that node. Also the commit message
associated with that revision, the repository path and the revision number are contained in
the node. The tooltip displayed when the mouse pointer hovers over a node specifies the URL of
the resource, the SVN user who created the revision of that node, the revision number, the
date of creation, the commit message, the modification type and the affected paths.
The types of nodes used in the graph are:
- Added resource - the icon for a new resource added to the
) and green background;
- Copied resource - the icon for a resource copied to other location,
for example when a SVN tag is created (
) and green background;
- Modified resource - the icon for a modified resource (
) and blue background;
- Deleted resource - the icon for a resource deleted from the
) and red background;
- Replaced resource - the icon for a resource removed and replaced
with another one on the repository (
) and orange background;
- Indirect resource - the icon for a revision from where the resource
was copied or an indirectly modified resource, that is a directory in which a resource was
) and grey background; the Modification type field of the tooltip
specifies how that revision was obtained in the history of the resource.
A directory resource is represented with two types of graphs:
- simplified graph - lists only the changes applied directly to the
- complete graph - lists also the indirect changes of the directory
resource, that is the changes applied to the resources contained in the directory.
The Revision Graph of a Directory (Direct Changes)
The Revision Graph of a Directory (Also Indirect Changes)
The Revision graph dialog toolbar contains the following actions:
- Save as image -
Saves the graphical representation as image. For a large revision graph you have to set more memory in the startup script.
The default memory size is not enough when there are more than 100 revisions that are
included in the graph.
indirect modifications - Switches between simplified and complete graph.
- Zoom In - Zooms in the
- Zoom Out - Zooms out the
graph. When the font reaches its minimum size, the graph nodes will display only the icons,
leading to a very compact representation of the graph.
- Reset scale - Resets
the graphical scale to a default setting.
- Print - Prints the
- Print preview -
Offers a preview of the graph to allow you to check the information to be printed.
Right clicking any of the graph nodes display a contextual menu containing the following
- Open -
Opens the selected revision in the editor panel. Available only for files.
- Open with... - Opens
the selected revision in the editor panel. Available only for files.
- Compare with HEAD -
Compares the selected revision with the HEAD revision and displays the result in the diff
panel. Available only for files.
History - Displays the history of the resource in the History view. Available for both files and
Check Out -
Checks out the selected revision of the
directory. Available only for directories.
When two nodes are selected in the revision graph of a file the right click menu of this
selection contains only the Compare for comparing the two revisions
corresponding to the selected nodes. If the resource for which the revision graph was built is
a folder then the right click menu displayed for a two nodes selection also contains the
Compare action but it computes the differences between the two
selected revisions as a set of directory changes. The result is displayed in the Directory Change Set view in the same way as for
the compare action invoked from the History
view on two revisions of a folder.
Generating the revision graph of a resource with many revisions may be a slow operation.
You should enable caching for revision graph actions so that future actions on the same
repository will not request the same data again from the SVN server which will finish the
operation much faster.