NAME
Puppet::VcsTools::Version - Tk GUI to manage a VcsTools::Version object
SYNOPSIS
No synopsis given. This object is better used with the Puppet::VcsTools::History module.
DESCRIPTION
This class represents one version of a VCS file. It holds all the information relevant to this version including the log of this version, the parent revision, child revision and so on.
Its main function is to deal with the History object and its TreeGraph object to draw the history revision tree. The Version object will perform all necessary calls to the drawing methods of TreeGraph to get the correct drawing.
The information structure stored in each Version object are described in the dataFormat HASH reference passed to the constructor (See VcsTools::DataSpec::Rcs or VcsTools::DataSpec::HpTnd for more details).
This Object heavily uses Puppet::Show, Puppet::Body and Puppet::Storage.
WIDGET USAGE
Well, By itself, the Version widget cannot do much.
Future version may be better depending on user inputs.
The only function available is to edit the history through the "File->edit log" menu if the 'edit' parameter was specified to the constructor.
Constructor
new(...)
Parameters are those of "new()" in Puppet::VcsTools::Version plus:
editor : LogEditor ref. If specified, the history of this version can be edited by calling the Show() method of the LogEditor. See "Show()" in Puppet::VcsTools::LogEdit. (optional)
Methods
All "Methods" in VcsTools::Version plus these ones:
display(...)
Will launch a widget for this object. All parameters are passed to "display(...)" in Puppet::Show
closeDisplay()
Delegated to the "closeDisplay" in Puppet::Body method.
editLog()
Will run the log editor for this version.
archiveLog()
Will delegate the call to the history manager. Used to update the VCS base from the log stored in the Version object. Used generally after an editLog.
drawTree(tree_graph)
Will start drawing a tree (from the revision of this Version object) calling History object's graph.
Internal Methods
Not for faint hearted people.
drawSubTree(tree_graph, x, y, width_reference)
Called recursively to draw all nodes, internal method.
x,y are the coordinates of the root of the sub-tree. The width will be changed to the actual width (in pixels) of the sub-tree. Note that the width of the sub-tree depends on the number of branches.
AUTHOR
Dominique Dumont, Dominique_Dumont@grenoble.hp.com
Copyright (c) 1998-1999 Dominique Dumont. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
perl(1), Tk(3), Puppet::Show(3), VcsTools::Version(3), VcsTools::History(3)