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.cmcrossroads.com/cgi-bin/cmwiki/view/CM/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.cmcrossroads.com/cgi-bin/cmwiki/view/CM/LabelFamily http://www.cmcrossroads.com/cgi-bin/cmwiki/view/CM/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-2012 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.