README.TXT file for 
===================

    ENVY/QA 1.3 [Free] Release for
        VisualAge Smalltalk

    Last updated August 22, 2000



Table of Contents
=================

    Release Notes
    Configuration Map
    Supported Platforms
    Documentation
    Distribution Contents
    Installation
    Usage Notes
    Documentation Notes
    Known Problems
    Support
    Trademarks
    Copyright Notices



Release Notes
=============

ENVY/QA is a robust quality-assurance toolkit for users of IBM 
VisualAge for Smalltalk.

ENVY/QA provides critical quality-assurance tools that development
teams need to produce high-quality production software with low
defect counts.  Managers can analyze development team productivity
and can publish Smalltalk applications to promote reuse within the
enterprise.  Source-code formatting supports enterprise-wide
standards.

If you are interested in integrating ENVY/QA with QA Partner, please
contact Segue Software, Inc., at 1-800-287-1329 or visit their
website at http://www.segue.com.



Configuration Map
=================

ENVY/QA for VisualAge Smalltalk    1.3 [Free]



Supported Platforms
===================

ENVY/QA R1.3 supports the following platforms:

   VisualAge for Smalltalk V4.5
   VisualAge Smalltalk Enterprise V5.0
   VisualAge Smalltalk Enterprise V5.5


Documentation
=============

The following OTI documentation is relevant for this release:
    ENVY/QA R1.3 User's Guide  ED2900, Revision 1.0012

See the Documentation Notes section for additional information
related to the User's Guide.



Distribution Contents
=====================

    Please note:  This section updates and replaces 
                  Section 3.1 Release Files 
                  in the User's Guide.


The installation zip file contains the following directory
structure and release files.

        LIBRARY
           QA13FREE.DAT          Library for VisualAge platforms
        TEMPLATE
           OTIML.CAT             NLS catalog file
           OTIML.DTD             SGML Data Type Definition 
           OTIMLRTF.DOT          Microsoft Word template
           SGMLPUB.CAT           NLS catalog file
           SYSPUB.STY            LaTeX style file
           SYSPUBF.STY           LaTeX style file
        README.TXT               Release notes (this file)
        QA13FREE.PDF              Documentation for ENVY/QA


Installation
============

    Please note:  This section updates and replaces 
                  Section 3.2 Installing the Release Files
                  in the User's Guide.

                  If you want to use both ENVY/QA and
                  UML Designer, please see the section
                  "Usage Notes" in this file before
                  installing ENVY/QA.



Follow these steps to install ENVY/QA.

1.  Unzip the qa13free.zip file into a temporary folder.

2.  Copy LIBRARY\QA13FREE.DAT from the temporary directory
    to the directory containing your default library.

3.  Start VisualAge Smalltalk.

4.  Open a Configuration Maps Browser.

5.  Import all configuration maps from QA13IBM.DAT.

6.  Copy the files TEMPLATE\OTIML.CAT and TEMPLATE\SGMLPUB.CAT
    to the NLS directory.  (This is path specified on the line
    for 'nlspath=' in your abt.ini file under the section 
    [NLS Config]).

7.  Load with required maps the most recent edition of the
    following config map:

       ENVY/QA for VisualAge Smalltalk    1.3 [Free]

8.  If you plan to use Code Publisher to publish Microsoft Word
    manuals, copy TEMPLATE\OTIMLRTF.DOT to the directory containing
    your Microsoft Word user templates.  
       
    To determine the default location of Microsoft Word user 
    template files, select Tools->Options... in Word.

    In Word 97, use Tools->Templates and Add-Ins.

9.  If you plan to use Code Publisher to publish LaTeX manuals, 
    copy TEMPLATE\SYSPUB.STY and TEMPLATE\SYSPUBF.STY to the 
    directory containing your LaTeX style files. 
       
    For the appropriate directory, refer to the LaTeX documentation 
    or see your site publishing coordinator.

You are now ready to use ENVY/QA.  The Transcript's Tools pull-down
menu has the new options Tool and Tool Settings.



Usage Notes
===========

Information for users who choose to have both ENVY/QA and UML 
Designer loaded at the same time:

    You may notice that some of the individual QA tools are
    identified as Required Maps for the UML Designer.  Because 
    ENVY/QA 1.3 [Free] contains newer versions of these tools in
    some cases, you are advised to load UML Designer prior to
    loading ENVY/QA 1.3 [Free].



Documentation Notes
===================

1.  Comment on Code Critic Section 4.5.1 Creating a Problem

    In the method #named: aString age: anInteger, a typing error is
    purposely introduced to demonstrate the type of message this
    generates in the code review.  Please type the method as shown.
    You will see the reference to the error in Section 4.5.4.

2.  Correction to Code Critic Section 4.15.1 Layout of the Code
    Critic Results Browser

    The screen snapshot is incorrect.  The button which is labeled 
    'More...' in the User's Guide should be labeled 'Previous'.

3.  Correction to Code Coverage Section 6.5.3 Watching Your Application

    In item 3, the action Methods->Show All is the default.  The toggle
    for this is Methods->Hide Ignored.

4.  Clarification of 'class fragment'

    The phrase 'class fragment' used in the documentation refers to
    that part of a class inside a single application, rather than an
    entire class which may be specified by more than one application.
    A class fragment is contained entirely within one application.


Known Problems
==============

ENVY/QA for VisualAge Smalltalk R1.3 [Free] has no known problems.



Support
=======

ENVY/QA for VisualAge Smalltalk 1.3 [Free] is provided as-is.  If you
want to provide feedback on ENVY/QA for VisualAge Smalltalk 1.3 [Free],
please post your feedback to the VisualAge Smalltalk newsgroup -
news://news.software.ibm.com/ibm.software.vasmalltalk .




Trademarks
==========

ENVY is a registered trademark of Object Technology 
International Inc. (OTI).
OTI is a wholly owned subsidiary of IBM Canada, Ltd.
VisualAge is a trademark of International Business Machines 
Corporation.



Copyright Notices 
=================

(c) 1996-1999 Object Technology International Inc. (OTI).


*** end of file ***
