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 Date::Format Date::Parse File::Slurp 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. These modules are non standard and used by at least one function. Note that the optional configuration files in the 'extra' directory have more dependencies. Consult the Configuration.pod there 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 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. A type family functionality is offered to support in-place publication, directly from the development branches, in order to make the application of labels cheaper than it currently is. Another 'view attribute' is supported, although seldom needed: '##:IncrementalLabels: LBTYPE@/vob/tag'. The initial 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 the 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.