Subject: ANNOUNCE: Perl libraries and scripts for ClearCase
From: [email-masked] (Brad Appleton)
Date: 5 Sep 1995 21:26:03 GMT
Newsgroups: comp.lang.perl.announce,comp.lang.perl.misc

The latest and greatest versions of ClearPerl and ClearView are now
available for anonymous ftp from the URL ftp://ftp.atria.com/contrib/.
ClearPerl is the T0023 package and ClearView is under T0025.  ClearPerl
available for anonymous ftp from ftp://ftp.atria.com/contrib.  and
ClearView are suites of Perl4 libraries and utilities for use with
Atria Software's ClearCase software configuration management and
version control product. If you are interested in helping me convert
them to object-oriented Perl5 code, please send email to me at
[email-masked]

The newest version of ClearPerl is 1.05. It includes the following
changes since the last release:

 * Reorganized the Makefile a bit and put a more detailed description
   of the contents in the README file.
 * Allowed empty format keyword assignments for cdiff.
 * Made sure that the prologue still gets printed when -noheaders is given
 * Added '-noprologue' option to cdiff
 * Fixed cdiff to use 'cleartool diff' instead of 'cleardiff' so that it
   can correctly use the '-pred' option.

The newest version of ClearView is 1.02 (1.01 was not made publicly
available). The most significant addition is the ability to associate
multiple sets of notes with a view (not just one - as in the previous
release).  ClearView 1.02 includes the following changes since the last
release:

 * Added '-all' option to 'rmnotes' and 'rmvwattr'
 * Added '-quiet' option to catnotes, lsnotes, rmnotes, lsvwattr, and rmvwattr
 * Allow '.' and '-' in view-attribute names (but not as first character)
 * Added mandatory $notesTag argument to ClearViewNotes'CreateTmpNotes()
 * Added the ability to manipulate multiple sets of notes (not just one)
   The user can specify a particular set of notes by identifying the notes
   with a notes-tag.
 * Added ClearViewNotes'IsGoodTag()
 * Added 'lsnotes' subcommand.
 * Added and documented exit-status for 'lsvwattr' subcommand.
 * Allowed the use of the tag '.' for a view's default set of notes.
 * Added the ability to rename a set of notes (except for '.')
 * Fixed setnotes so that -append and -prepend work even if the notes dont
   already exist.
 * Added 'rnnotes' subcommand

For those of you who are unfamiliar with ClearPerl and ClearView, here are
the descriptions from their README files ...

-------------------------------------------------------------------------------
 CLEARPERL
 =========
 This is "ClearPerl": a set of perl libraries and utilities for use with
 Atria Software's ClearCase and related products. ClearPerl is available
 as package T0023 from ftp://ftp.atria.com/contrib. At present, ClearPerl
 consists of the following scripts and libraries:
 
 clearcase.pl -- Perl library for clearcase with several dozen functions for
                 handling common Perl/ClearCase programming tasks.
 
 clearquery.pl -- ClearCase Query Library for Perl.
 
 clearlib -- Browse the contents of clearcase.pl or clearquery.pl to find
             out what's available and/or how to use it.
 
 cdiff -- Do a cleardiff but include surrounding lines of context.
 
 ct-import -- Import the given branch or label into the user's view (a
              viable alternative to using 'cleartool findmerge' that can
              edit your cspec if needed)
 
 list_events -- Sends a group of event messages to the appropriate users,
                or to standard output.
 
 needs_merge -- See if an element needs to be merged from one or more
                versions to another (like the old 'needs_merge' query
                but lots better)
 
 xpname -- Expand a version selector into a version extended pathname.

-------------------------------------------------------------------------------
 CLEARVIEW
 =========
 This is "ClearView": a set of perl libraries and utilities to associate
 attributes, and/or one or more sets of notes with a ClearCase view
 (ClearCase is a configuration management and version control system
 from Atria Software).  ClearView is available as package T0025 from
 ftp://ftp.atria.com/contrib.
 
 A perl library ('ClearView.pl') is provided along with a single command
 ('clearview') which has several subcommands to allow the user to create
 and manipulate various attributes and/or notes that may be associated
 with a view. The current list of subcommands is:
 
    Commands for manipulating a view's notes:
       mknotes  -- create notes (only if they dont already exist)
       setnotes -- set notes (even if they dont exist yet)
       ednotes  -- edit notes (even if they dont exist yet)
       catnotes -- display notes
       lsnotes  -- list the name-tags of one or more notes
       rnnotes  -- rename notes
       rmnotes  -- remove notes
 
    Commands for manipulating a view's attributes:
       mkvwattr -- create a view attribute
       rmvwattr -- remove one or more view attributes
       lsvwattr -- list one or more view attributes
 
    Commands for browsing the contents of the ClearView perl library:
       library -- list documentation for one or more ClearView perl functions

-- 
 [email-masked]           Motorola PNSB, Northbrook, IL USA
 "And miles to go before I sleep."    DISCLAIMER: I said it, not my employer!