=======================================================
CONTRIBUTOR:    Engineering Staff, Atria Software, Inc.
=======================================================

**********************************************************
************** THIS IS UNSUPPORTED SOFTWARE **************
**********************************************************

**********************************************************
*  Atria makes no representation that the descriptions   *
*   and software code contained in this document will    *
*   not infringe on existing or future patent rights,    *
*     copyrights, trademarks, trade secrets or other     *
*        proprietary rights of third parties. The        *
*     descriptions contained herein do not imply the     *
*  granting of licenses to make, use, sell, license or   *
*  otherwise transfer Atria products described herein.   *
*  Atria disclaims responsibility for errors which may   *
*  appear in this document, and it reserves the right,   *
*   in its sole discretion and without notice, to make   *
*  substitutions and modifications in the products and   *
*         practices described in this document.          *
**********************************************************

----------------------
T0002: REMOVE VERSIONS
----------------------

OVERVIEW
--------

This example provides a script to remove versions from an element.
Given an element pathname, it removes all versions of the element that
have no labels and no sub-branches.  It can be modified to preserve or
discard versions based on other meta-data, using rmver command options
(-xbranch -xlabel -xattr -xhlink).

This script is useful for deleting derived object versions that are no
longer needed.  If you check in derived objects regularly, in a nightly
build, for example, you will have to delete old versions to recover
disk space.  An easy way to do this is to label versions you want to
keep (for important released versions), and run a cron script nightly
which uses rmver_all to delete all unlabeled versions.

You can also use this script to delete intermediate versions of text
file elements.  Note that deleting text file versions typically does
not recover much space because the delta manager can store a series of
small changes almost as efficiently as one large change.


SCRIPTS
-------

rmver_all element-pname
        Delete all versions without labels or sub-branches in element-pname.