Release notes for PureCoverage 5.3 Solaris 2

Contents
========

  o Changes from previous releases

  o Supported systems

  o Restrictions and known issues


New in this release
===================
  - Bug fixes and compatibility with OS patches.

  - Support for Solaris 8.

  - Support for Forte 6 (compiler version 5.1) 
    compiler. The product has not been tested 
    with Forte 6 Update 1.

New in PureCoverage 5.2
========================
  - Bug fixes and compatibility with OS patches.

  - This release uses a new FlexLm based
    licensing. Read the new installation
    guide before installing the product.
    Use rs_install instead of pure_install
    for the installation.

New In PureCoverage 5.1
=======================
  - Bug fixes and compatibility with OS patches.

  - Support for Cygnus GNUPro 98r2 compilers

  - This will be the last release to support
    Solaris 2.4.

New In PureCoverage 4.5
=======================
  - Bug fixes and compatibility with OS patches.

  - Support for Solaris 7 and Sun Visual
    Workshop 5.0.

  - This is the last release to support 
    SunOS 4. Apex Ada is no longer 
    supported.

New In PureCoverage 4.4
=======================

  - Bug Fixes

  - Support for gcc/g++ 2.8.1

  - Support for Rational's ClearQuest defect
    tracking tool.  Please see the Restrictions
    and Known Issues section below for details
    on how to use Purify with ClearQuest or
    ClearDDTS.

  - Supports FLEXlm based licensing when
    installed as part of RSDSU.

New in PureCoverage 4.3
=======================

  - Support for Apex 3.0.0 Ada and C++ on 
    Solaris and HPUX.

  - Support for Rational's ClearQuest defect
    tracking tool.  Please see the Restrictions
    and Known Issues section below for details on
    how to use PureCoverage with ClearQuest or
    ClearDDTS.

New in PureCoverage 4.2
=======================

  - bug fixes

==================================================


Supported systems
=================

  Operating system and Hardware
  -----------------------------

    PureCoverage has been tested with Solaris
    versions 2.5, 2.5.1, 2.6, 2.7 and 2.8 
    on SPARC platforms.

    PureCoverage has also been tested on normal
    and V8+ SPARC programs on the UltraSPARC.

  Compilers
  ---------

    PureCoverage has been tested with the 
    following compilers:
    - Forte 6 (compiler version 5.1)
    - Sun Workshop C and C++ 4.2 and 5.0
    - SPARCWorks C and C++ versions 3.x
    - SPARCWorks f77  versions:
         3.0
    - GNU gcc and g++ versions, through version 2.8.1.
    - Cygnus GNUpro v.98r2

  Threads
  -------

    PureCoverage supports these threads packages:
    - The native Solaris libthread library.
    - The Solaris Pthreads library, libpthread.
    - Transarc DCE threads.

==================================================


Restrictions and Known Issues
=============================

  General
  -------
  - As of version 5.1, the product home
    directory was reorganized. The new
    layout should be transparent to most
    users. All libraries have been moved
    to a lib32 sub-directory, but top
    level links preserve backward 
    compatibility for accessing the stubs
    libraries.

    In the unlikely event you need to
    access private libraries such as 
    solaris2_threads.so, and you use
    -printhomedir to construct the path,
    you must now add a "lib32" component
    to the path:

    `purecov -printhomedir`/lib32/solaris2_threads.so

    Reference to these libraries is rarely
    necessary.

  - PureCoverage may not work properly with applications
    that use Java 1.2 libraries. For details, please
    see Technical Note #11091 at:

    http://solutions.rational.com/solutions/

    Or contact Rational Technical Support and
    reference Tech Note #11091.

  - Archive libraries containing both 32-bit
    and 64-bit libraries are not supported.
    All components of a link must be of the
    same ELF type, and the first archive
    member is used to determine the link
    type.

  - gcc/g++ 2.8.1 is supported, but there are
    known problems with C++ shared libraries
    containing gcc/g++ produced objects files
    containing exception handling code.

  - This release of PureCoverage does not
    support Solaris 2.3.

  - Because of operating system differences,
    programs instrumented on one version of
    Solaris may crash or generate incorrect
    results if run on a different version of the
    operating system.

  - PureCoverage does not support use of the
    LD_PRELOAD environment variable.

  - The SPARCWorks incremental linker, ild, is
    automatically disabled by PureCoverage 
    due to an incompatibility with file naming
    conventions.

  - Earlier releases of PureCoverage intercepted
    calls to dlclose() and prevented dynamically
    loaded libraries from being unmapped.  This
    had the effect of preventing static
    destructors from running but allowing coverage
    data for such libraries to be saved at program
    exit.  By default, PureCoverage 4.0 now allows
    libraries to be unmapped, at the expense of
    not saving coverage data for such libraries.
    The new -dlclose-mode integer option controls
    this behavior :

    -dlclose-mode=0 (default for earlier releases)
    libraries may not be unmapped.

    -dlclose-mode=1 (default for PureCoverage 4.0)
    libraries may be unmapped.

    -dlclose-mode=2
    libraries may be unmapped, coverage data
    is saved just prior to unmapping.

  User Interface
  --------------

  - The PureCoverage GUI menus and buttons become 
    inaccessible if either the NumLock or 
    ScrollLock key is activated. The workaround
    is to switch them off, or add the following
    line(s) to your $HOME/.Xdefaults file.
 
    ! Ignore the NumLock and ScrollLock keys on 
    ! mouse buttons
    PureCoverage*ignoreModifierMask: Mod3|Mod2
 
    This second workaround will take effect for 
    a new PureCoverage viewer after you restart 
    your X-session or run a command like 
    'xrdb -merge $HOME/.Xdefaults'.

  - The "Invoke ClearDDTS" Button has been
    modified to bring up the ClearQuest web
    interface.  This feature only works with
    Netscape Navigator.

    The site-wide URL for ClearQuest can be
    given during installation or set by
    manually editing the file

    pure_clearquest_url

    in your PureCoverage home directory. A user 
    can override the site-wide URL by setting 
    the environment variable

    PURE_CLEARQUEST_URL

    This feature is partly implemented by a shell
    script, ("pure_invoke_clearquest" in your
    PureCoverage home directory) to allow you to 
    tailor its operation to your needs.  If you 
    wish, you may copy and customize this.
    script. As long as the directory containing 
    the script appears in your search path 
    before your PureCoverage home directory, it will 
    be used instead of the original script.

    If you prefer to use PureCoverage with 
    ClearDDTS, you can do so by setting the 
    X resource:

    PureCoverage*ddtsCommandString

    to 'xddts', if xddts is in your search path,
    or to the full path to your xddts executable.
    xddts is invoked by a shell script
    ("pure_invoke_ddts" in your PureCoverage home
    directory).  If you wish to customize it,
    please read the section on customizing
    "pure_invoke_clearquest" above.

    If you already have a customized
    "pure_invoke_ddts" script in your search path,
    All you need to do is set your X resource as
    described above, and PureCoverage will find 
    your customized script automatically.

    The following copyright applies to portions
    of this ClearQuest integration code:

    Copyright 1996 Netscape Communications 
    Corporation, all rights reserved. Created: 
    Jamie Zawinski , 24-Dec-94.
    Permission to use, copy, modify, distribute, 
    and sell this software and its documentation 
    for any purpose is hereby granted without 
    fee, provided that the above copyright 
    notice appear in all copies and that both 
    that copyright notice and this permission 
    notice appear in supporting documentation.  
    No representations are made about the 
    suitability of this software for any 
    purpose. It is provided "as is" without 
    express or implied warranty.


  Compilers
  ---------

  - The GNU gcc extensions are not tested against
    PureCoverage.  Most gcc extensions will
    probably work fine.  Known limitations at
    present include problems with nested functions
    (e.g.: making a pointer to a nested function
    and attempting to call through it will not
    work).

  Threads
  -------

  - Customers using unsupported threads packages
    should contact Rational Software technical 
    support (support@rational.com) to ensure 
    compatibility.