NAME

ClearCase::SyncTree - Import a tree of files to a tree of ClearCase elements

SYNOPSIS

# Create a 'synctree' object.
my $sync = ClearCase::SyncTree->new;
# Tell it where the files are coming from ...
$sync->srcbase($sbase);
# Tell it where they're going to ...
$sync->dstbase($dbase);
# Supply the list of files to work on (relative or absolute paths).
$sync->srclist(keys %files);
# Compare src and dest lists and figure out what to do.
$sync->analyze;
# Create new elements in the target area.
$sync->add;
# Update existing files which differ between src and dest.
$sync->modify;
# Remove any files from dest that aren't in src.
$sync->subtract;
# Check in the changes.
$sync->checkin;

See the enclosed synctree script for full example usage.

DESCRIPTION

No detailed documentation yet, sorry. Next version.

AUTHOR

Based on code originally written by Paul D. Smith <pausmith@nortelnetworks.com>. Paul's version was based on the Bourne shell script 'citree' delivered as sample code with ClearCase.

Rewritten for Unix/Win32 portability by David Boyce <dsb@world.std.com> in 8/1999, then reorganized into a module in 1/2000.

COPYRIGHT

Copyright 1997,1998 Paul D. Smith and Bay Networks, Inc.

Copyright 1999,2000 David Boyce (dsb@world.std.com).

This script is distributed under the terms of the GNU General Public License. You can get a copy via ftp://ftp.gnu.org/pub/gnu/ or its many mirrors. This script comes with NO WARRANTY whatsoever, not even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

STATUS

This is currently ALPHA code and, as such, I reserve the right to change the API incompatibly. At some point I'll bump the version suitably and remove this warning, which will constitute an (almost) ironclad promise to leave the API alone.

SEE ALSO

perl(1), ClearCase::Argv(3), Getopt::Long(3), IPC::ChildSafe(3)