NAME
SYNOPSIS
DESCRIPTION
CAVEATS
WIDGET USAGE
Constructor
- new(...)
Generic methods
- display()
- archiveFile(...)
History handling methods
- openHistory()
Handling the real file
Handling the VCS part
- merge(...)
AUTHOR
SEE ALSO

NAME

Puppet::VcsTools::File - Tk GUI for VCS file management

SYNOPSIS

 use Tk ;
 use Puppet::VcsTools::File;
 use Puppet::VcsTools::HistEdit;
 use VcsTools::LogParser ;
 use VcsTools::DataSpec::HpTnd qw($description readHook);
 use Fcntl ;
 use MLDBM qw(DB_File);

 my %dbhash;
 tie %dbhash,  'MLDBM',    $file , O_CREAT|O_RDWR, 0640 or die $! ;

 my $ds = new VcsTools::LogParser
  (
   description => $description,
   readHook => \&readHook
  ) ;

 my $mw = MainWindow-> new ;
 $mw->withdraw ;

 my $he = $mw->LogEditor( 'format' => $ds) ;

 my $fileO = new Puppet::VcsTools::File 
  (
   dbHash => \%dbhash,
   keyRoot => 'root',
   vcsClass => 'VcsTools::HmsAgent',
   vcsArgs => 
   {
    hmsHost => 'hptnofs',
    hmsBase => 'test_integ'
    },
   name => $tfile,
   workDir => $ENV{'PWD'},
   dataScanner => $ds,
   logEditor => $he,
   'topTk' => $mw
  );

 $fileO -> display( master => 1);

 MainLoop ;

DESCRIPTION

This class provides a GUI to the VcsTools::File class.

The widget provides all the functionnalities to edit, archive, lock, unlock, change the mode of a file.

The widget also provide an 'open history' menu to call the Puppet::VcsTools::History widget which will let you work on the history of a file. Moreover, this widget will let you edit the log a each version of a file, if you want to modify it.

CAVEATS

The file must contain the $Revision: 1.3 $ VCS keyword.

WIDGET USAGE

The File widget contains a sub-window featuring:

A revision label to indicate the revision of the current file.
A 'writable' check button, which indicated the status of the file and is able to change its mode.
A 'locked'check button, which indicated the lock status of the file and is able to change its lock.

By default, all these menus and buttons are disabled until the user performs a File->check through the menu.

The File menu contains several commands :

open history: Will open the history menu.
check: to get the revision, mode, and lock status of the current file.
archive: to archive the file (Enabled only if the file is writable).
create archive: to create an archive of the file (Enabled only if the file is writable and the archive does not exist).
edit: to edit the file (Enabled only if the file is writable or if the file does not yet exist).

The File object will add some functionnalities to the History object while opening it :

A 'merge' global menu: To perform a merge on 2 selected revision.
A 'show diff' global menu: To show a diff between 2 selected revision.
Button 2 is bound to arrows to show the diff between the 2 revisions next to the arrow.
A 'show diff' command is also added to the arrow popup menu.
Button 2 is bound to nodes to show the content of this revision.
An 'edit log' entry is added to the popup menu of the nodes and arrows.