ClearCase::Wrapper::MGi

PURPOSE

This is an overlay module for ClearCase::Wrapper. See the POD for that module. It is built following the example of ClearCase::Wrapper::DSB. The extensions contained here are meant to support a consistent branching policy, advocated in:
http://www.cmwiki.com/BranchYesMergeNo It also offers a port of cleartool over cygwin. Beyond this module, changes were also made to ClearCase::SyncTree, which closely relate to the same purpose. The module has to adapt many functions from DSB.

INSTALLATION

To install this module type the following:

perl Makefile.PL
make
make test
make install

VERSIONS

Notice as from ClearCase::Wrapper::DSB--there is no strict correlation between versions of the base module and overlay modules. I.e. you do not necessarily need ClearCase::Wrapper::DSB 1.04 if you have ClearCase::Wrapper 1.04. If an overlay requires a certain feature in the base module this dependency will be noted in the prerequisites within Makefile.PL. In other words, if the install sequence doesn't generate a warning you should be ok.

DEPENDENCIES

ClearCase::Wrapper

Even if ClearCase::Wrapper::DSB is not a dependency, the extension to catcs developed in it is compatible with the extension of config specs presented here, and can be used to display it.

KNOWN BUGS AND MISSING FEATURES

• No tests provided.
• The view attribute is not searched from included config spec fragments.
• Interactive queries from cleartool require specific attention. When missing, they may result in apparent hanging.

Many more functions need to be modified in order to support the 'BranchOff: root' functionality:

• describe -fmt "%Pn": should return a merge contributor, unless a direct parent is found on the same branch
• ls: should mention '-off /{root}' if 'BranchOff: root' is set
• lsgen: should support a -graphical option
• synctree: should be added as an operation, with a -from syntax.
• annotate

I don't intend (for now) to modify findmerge, on the following grounds:

• the only common usage pattern under 'BranchOff: root' is the 'home merge', i.e. merging towards one's changes, already in a branch.
• the purpose of branching off the root of the version tree is to avoid cascading far away; few levels of cascading are innocuous.

An other functionality is needed to support in-place publication, directly from the development branches, in order to make the application of labels cheaper than it currently is.

An other 'view attribute' is supported: '##:IncrementalLabels: LBTYPE@/vob/tag'. Preliminary documentation can be found at: http://www.cmwiki.com/LabelFamily
http://www.cmwiki.com/IncrementalTypesImp See also collaborative maintenance site: http://code.google.com/p/clearcase-cpan/

COPYRIGHT AND LICENCE

Copyright (c) 2007 IONA Technologies PLC until v 0.05. Copyright (c) 2008-2010 Marc Girod (marc.girod@gmail.com) for later changes. All rights reserved. This Perl program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.