home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / smart21b.zip / README.NOW < prev    next >
Text File  |  1995-10-18  |  9KB  |  196 lines
  1. ****************************************************************************
  2.  
  3.                       The SMART Readme File
  4.                       Version: 2.1B
  5.                       November, 1995
  6.  
  7. ****************************************************************************
  8.    INSTALLATION OPTIONS
  9. ****************************************************************************
  10.  
  11. You have a number of installation choices:
  12. The options for full, reduced or mini installation are available on the
  13. installation dialog panel which will appear when you choose 'Install' in
  14. the SMART installation dialog panel.
  15.  
  16.      1. You can install the full SMART product.
  17.         This will require approximately 32 MBytes of hard disk.
  18.  
  19.      2. You can install a reduced version of SMART by not selecting
  20.         to install all of the migration databases.
  21.  
  22.      3. You can install a "mini-version" of SMART (just those read-write
  23.         files required by the application) and run from the CD-ROM.
  24.  
  25. You can create installation diskettes and install the full or reduced
  26. version from these diskettes.  Create installation diskettes from your
  27. CD-ROM as follows:
  28.  
  29.    1. Start an OS/2 Window or OS/2 Full Screen session.
  30.  
  31.    2. Put the CD-ROM in the CD-ROM drive and change directory
  32.       to the X:SMART (X represents CD-ROM drive)
  33.       subdirectory as follows:
  34.  
  35.                               CD X:SMART
  36.  
  37.          Put a high density, blank diskette in your diskette drive A:
  38.          and type the following command:
  39.  
  40.                                IMAKMDSK .
  41.  
  42.     3.  Information to make diskette lables to correspond to the eleven
  43.         SMART diskettes can be found in a file named DISKIMG.LBL in the
  44.         SMART directory.
  45.  
  46. You can also copy the SMART directory and subdirectories onto
  47. your network so that SMART may beinstalled and/or run from the network.
  48.  
  49. ****************************************************************************
  50.    INSTALLATION
  51. ****************************************************************************
  52.  
  53. To use the SMART Installation Program to install the toolset, do the following:
  54.  
  55.    1. Start an OS/2 Window or OS/2 Full Screen session.
  56.  
  57.    2. Start the SMART Installation Program from the CD-ROM or diskettes
  58.       as follows:
  59.  
  60.       -  CD-ROM: Put the CD-ROM in the CD-ROM drive and change directory
  61.          to the X:SMART (X represents CD-ROM drive) subdirectory as
  62.          follows:
  63.  
  64.          CD X:SMART
  65.  
  66.          Type the following and press Enter:
  67.  
  68.          INSTALL
  69.  
  70.       -  DISKETTES: Put the first diskette into the A: drive (or other
  71.          drive) and type A: to insure you are at the A: prompt.
  72.          Type the following and press Enter:
  73.  
  74.          INSTALL
  75.  
  76.    3. The system displays "The SMART Installation Program" window.
  77.  
  78. SMART desktop program objects and icons will be created as part of this
  79. installation.
  80.  
  81. If a previous version of SMART is installed, it should be removed by
  82. choosing REMOVE from the action bar of the installation utility.  This
  83. is particularly important for SMART Version 1, because SMART
  84. Version 2 does not install properly unless SMART Version 1 is deleted.
  85. IMPORTANT NOTE: The "removal" process for SMART will delete any
  86. directories (and files in those directories) and subdirectories that were
  87. installed when SMART was installed.  Be careful not to inadvertently
  88. delete files that are needed.
  89.  
  90. ****************************************************************************
  91.   WHAT'S NEW FOR THE DEVELOPER API EXTENSIONS
  92. ****************************************************************************
  93.  
  94. This version of SMART supports the IBM Developer API Extensions for OS/2.
  95.  
  96. PLEASE READ: "IBM Developer API Extensions for OS/2 Guide" which is
  97. located in the IBM Developer's Toolkit for OS/2 Warp, Version 3.00.4.
  98.  
  99. 1.  Added to the SMARTAUX directory is a subdirectory named DAPIE32.
  100.     It contains the Developer API Extensions (DAPIE) User Defined
  101.     Migration Database (UDMD). The DAPIE32 UDMD contains APIs that
  102.     are functionally equivalent to Windows NT 3.5 and Windows 95 APIs
  103.     and can exploit OS/2 specific features and functions.  Before using
  104.     this UDMD, you must "build" it. Under the TABLES pulldown, choose
  105.     "Create User UDMD". Then select the correct paths and files. The
  106.     DAPIE32 dictionary from which to build the UDMD is named DAPIE32.DCT,
  107.     located in  ..SMARTAUX\DAPIE32. Remember to use this UDMD with the
  108.     WIN32OS2.TBL SMART table when converting your code.
  109.  
  110. 2.  Two new tables have been added to SMART:
  111.       W16DAPIE.TBL - The SMART Table that will identify, categorize and
  112.                        migrate 16-bit Windows applications to the correct
  113.                        OS/2 native APIs and the new DAPIE APIs.
  114.  
  115.       DAPIE16.TBL - The SMART Table to identify those API that are NOT DAPIE.
  116.  
  117. 3.  Added to the main directory of SMART is a utility DAPIEMRG.CMD. This
  118.     utility may be run to provide a report that will specify header
  119.     information to assist in the analysis of your migration effort.
  120.  
  121. 4.  Added to the SMARTAUX directory is a subdirectory named MEL.
  122.      It contains a Migration Export Library (MEL) that will identify the DAPIE
  123.     APIs in a Windows program.  It is a Windows library that runs in a Windows
  124.     environment and compiles and links as any Windows library.
  125.     However,  MEL only includes the DAPIE supported API, so a program
  126.     compiled and linked with MEL will never actually link or  run.
  127.     But, as an artifact of the linking process, a list of unresolved Windows API
  128.     will be generated by the linker.  The list of unresolved Windows APIs are
  129.     those that are not DAPIE.  For detailed information please read MEL.DOC
  130.     and NT.DOC in the directory ...SMARTAUX\MEL\.
  131.  
  132. 5.  The SMART Resource Translator has been enhanced to output string
  133.     identifiers for resources.  This is a choice which appears at the
  134.     bottom of the Resource Translator dialog box.
  135.  
  136. ****************************************************************************
  137.     GENERAL NOTES
  138. ****************************************************************************
  139.  
  140. 1.  In addition to new DAPIE32 UDMD, the following UDMDs (User Defined
  141.     Migration Databases) are located in the SMARTAUX subdirectory:
  142.           - OS/2 WARP UDMD is in the WN32WARP subdirectory.
  143.           - Power PC UDMDs are in the WN16PWPC and WN32PWPC subdirectories.
  144.           - MDI UDMD is in the WINXOS2 subdirectory.
  145.  
  146. 2.  MDI (Multiple Document Interface):   Included with SMART is a
  147.     UDMD  that contains MDI keywords named WINXOS2.DCT. The WINXOS2
  148.     UDMD is located in the directory ..\SMARTAUX\WINXOS2.  Documentation
  149.     for MDI implementation is located in MDI.DOC which resides in
  150.     ..SMARTAUX\SMARTMDI\.
  151.  
  152. 3.  HELP file conversion with SMART:  After converting a HELP file to an IPF
  153.     file with SMART, the IPF facility will compile it to either INF or HLP.
  154.     Therefore, the IPF compiler, available from the OS/2 Developer's
  155.     Toolkit, is necessary.
  156.  
  157. 4.  When converting HELP files with SMART, the "input" file should always
  158.     be an HPJ file.  The HPJ file will contain the name of the RTF file(s)
  159.     and any bitmap files that are needed. A sample HPJ file can be found in
  160.     SMARTAUX directory in the file SAMPLE.HPJ.
  161.  
  162. 5.  Step-by-step instructions on how to convert HELP files with SMART
  163.     are included in the SMART User's Guide and in SMART's online help.
  164.  
  165. 6.  Resource files that are converted from Windows to OS/2 contain no
  166.     comments regarding converted code.   Refer to the "error log" produced
  167.     during the resource file translation for comments, warnings and errors
  168.     related to the converted file.
  169.  
  170. 7.  Any Microsoft Windows keyword or command present in a UDMD table will
  171.     terminate the processing of the table.   That includes all UDMD
  172.     format tags except for .KEYWORD.  That also includes comments.  For
  173.     example, if a Windows key word was included in a comment in the
  174.     .COMMENT format tag, SMART would not create the UDMD.
  175.  
  176. 8.  If source code is partially migrated with version 1 and you want to
  177.     move to SMART Version 2, then remove tagged code lines from source
  178.     code.
  179.  
  180. 9.  Source files that are set up to migrate the statement #include "windows.h"
  181.     need to be slightly modified. In order to migrate correctly,
  182.     the statement has to be changed to #include <windows.h>.
  183.  
  184. ****************************************************************************
  185.     HELP ON USING SMART
  186. ****************************************************************************
  187.  
  188. 1. To see online help in SMART, press F1 with the focus on any menu item
  189.    or dialog panel. Select "General Help" from the "Help" menu and
  190.    navigate throughout the help facility.
  191.  
  192. 2. Help documents (Users' Guides) can be found in your SMART desktop folder.
  193.  
  194. 3. For printed documentation, print while viewing the guide.
  195.    See 'Services' on the help menu bar.
  196.