****************************************************************************

                      The SMART Readme File
                      Version: 2.1B
                      November, 1995

****************************************************************************
   INSTALLATION OPTIONS
****************************************************************************

You have a number of installation choices:
The options for full, reduced or mini installation are available on the
installation dialog panel which will appear when you choose 'Install' in
the SMART installation dialog panel.

     1. You can install the full SMART product.
        This will require approximately 32 MBytes of hard disk.

     2. You can install a reduced version of SMART by not selecting
        to install all of the migration databases.

     3. You can install a "mini-version" of SMART (just those read-write
        files required by the application) and run from the CD-ROM.

You can create installation diskettes and install the full or reduced
version from these diskettes.  Create installation diskettes from your
CD-ROM as follows:

   1. Start an OS/2 Window or OS/2 Full Screen session.

   2. Put the CD-ROM in the CD-ROM drive and change directory
      to the X:SMART (X represents CD-ROM drive)
      subdirectory as follows:

                              CD X:SMART

         Put a high density, blank diskette in your diskette drive A:
         and type the following command:

                               IMAKMDSK .

    3.  Information to make diskette lables to correspond to the eleven
        SMART diskettes can be found in a file named DISKIMG.LBL in the
        SMART directory.

You can also copy the SMART directory and subdirectories onto
your network so that SMART may beinstalled and/or run from the network.

****************************************************************************
   INSTALLATION
****************************************************************************

To use the SMART Installation Program to install the toolset, do the following:

   1. Start an OS/2 Window or OS/2 Full Screen session.

   2. Start the SMART Installation Program from the CD-ROM or diskettes
      as follows:

      -  CD-ROM: Put the CD-ROM in the CD-ROM drive and change directory
         to the X:SMART (X represents CD-ROM drive) subdirectory as
         follows:

         CD X:SMART

         Type the following and press Enter:

         INSTALL

      -  DISKETTES: Put the first diskette into the A: drive (or other
         drive) and type A: to insure you are at the A: prompt.
         Type the following and press Enter:

         INSTALL

   3. The system displays "The SMART Installation Program" window.

SMART desktop program objects and icons will be created as part of this
installation.

If a previous version of SMART is installed, it should be removed by
choosing REMOVE from the action bar of the installation utility.  This
is particularly important for SMART Version 1, because SMART
Version 2 does not install properly unless SMART Version 1 is deleted.
IMPORTANT NOTE: The "removal" process for SMART will delete any
directories (and files in those directories) and subdirectories that were
installed when SMART was installed.  Be careful not to inadvertently
delete files that are needed.

****************************************************************************
  WHAT'S NEW FOR THE DEVELOPER API EXTENSIONS
****************************************************************************

This version of SMART supports the IBM Developer API Extensions for OS/2.

PLEASE READ: "IBM Developer API Extensions for OS/2 Guide" which is
located in the IBM Developer's Toolkit for OS/2 Warp, Version 3.00.4.

1.  Added to the SMARTAUX directory is a subdirectory named DAPIE32.
    It contains the Developer API Extensions (DAPIE) User Defined
    Migration Database (UDMD). The DAPIE32 UDMD contains APIs that
    are functionally equivalent to Windows NT 3.5 and Windows 95 APIs
    and can exploit OS/2 specific features and functions.  Before using
    this UDMD, you must "build" it. Under the TABLES pulldown, choose
    "Create User UDMD". Then select the correct paths and files. The
    DAPIE32 dictionary from which to build the UDMD is named DAPIE32.DCT,
    located in  ..SMARTAUX\DAPIE32. Remember to use this UDMD with the
    WIN32OS2.TBL SMART table when converting your code.

2.  Two new tables have been added to SMART:
      W16DAPIE.TBL - The SMART Table that will identify, categorize and
                       migrate 16-bit Windows applications to the correct
                       OS/2 native APIs and the new DAPIE APIs.

      DAPIE16.TBL - The SMART Table to identify those API that are NOT DAPIE.

3.  Added to the main directory of SMART is a utility DAPIEMRG.CMD. This
    utility may be run to provide a report that will specify header
    information to assist in the analysis of your migration effort.

4.  Added to the SMARTAUX directory is a subdirectory named MEL.
     It contains a Migration Export Library (MEL) that will identify the DAPIE
    APIs in a Windows program.  It is a Windows library that runs in a Windows
    environment and compiles and links as any Windows library.
    However,  MEL only includes the DAPIE supported API, so a program
    compiled and linked with MEL will never actually link or  run.
    But, as an artifact of the linking process, a list of unresolved Windows API
    will be generated by the linker.  The list of unresolved Windows APIs are
    those that are not DAPIE.  For detailed information please read MEL.DOC
    and NT.DOC in the directory ...SMARTAUX\MEL\.

5.  The SMART Resource Translator has been enhanced to output string
    identifiers for resources.  This is a choice which appears at the
    bottom of the Resource Translator dialog box.

****************************************************************************
    GENERAL NOTES
****************************************************************************

1.  In addition to new DAPIE32 UDMD, the following UDMDs (User Defined
    Migration Databases) are located in the SMARTAUX subdirectory:
          - OS/2 WARP UDMD is in the WN32WARP subdirectory.
          - Power PC UDMDs are in the WN16PWPC and WN32PWPC subdirectories.
          - MDI UDMD is in the WINXOS2 subdirectory.

2.  MDI (Multiple Document Interface):   Included with SMART is a
    UDMD  that contains MDI keywords named WINXOS2.DCT. The WINXOS2
    UDMD is located in the directory ..\SMARTAUX\WINXOS2.  Documentation
    for MDI implementation is located in MDI.DOC which resides in
    ..SMARTAUX\SMARTMDI\.

3.  HELP file conversion with SMART:  After converting a HELP file to an IPF
    file with SMART, the IPF facility will compile it to either INF or HLP.
    Therefore, the IPF compiler, available from the OS/2 Developer's
    Toolkit, is necessary.

4.  When converting HELP files with SMART, the "input" file should always
    be an HPJ file.  The HPJ file will contain the name of the RTF file(s)
    and any bitmap files that are needed. A sample HPJ file can be found in
    SMARTAUX directory in the file SAMPLE.HPJ.

5.  Step-by-step instructions on how to convert HELP files with SMART
    are included in the SMART User's Guide and in SMART's online help.

6.  Resource files that are converted from Windows to OS/2 contain no
    comments regarding converted code.   Refer to the "error log" produced
    during the resource file translation for comments, warnings and errors
    related to the converted file.

7.  Any Microsoft Windows keyword or command present in a UDMD table will
    terminate the processing of the table.   That includes all UDMD
    format tags except for .KEYWORD.  That also includes comments.  For
    example, if a Windows key word was included in a comment in the
    .COMMENT format tag, SMART would not create the UDMD.

8.  If source code is partially migrated with version 1 and you want to
    move to SMART Version 2, then remove tagged code lines from source
    code.

9.  Source files that are set up to migrate the statement #include "windows.h"
    need to be slightly modified. In order to migrate correctly,
    the statement has to be changed to #include <windows.h>.

****************************************************************************
    HELP ON USING SMART
****************************************************************************

1. To see online help in SMART, press F1 with the focus on any menu item
   or dialog panel. Select "General Help" from the "Help" menu and
   navigate throughout the help facility.

2. Help documents (Users' Guides) can be found in your SMART desktop folder.

3. For printed documentation, print while viewing the guide.
   See 'Services' on the help menu bar.
