home *** CD-ROM | disk | FTP | other *** search
/ Microsoftware Monthly 19…2 Programming Power Tools / MASO9512.ISO / smart / readme.now < prev    next >
Encoding:
Text File  |  1995-05-19  |  5.5 KB  |  136 lines
  1.  
  2. ****************************************************************************
  3.  
  4.                   The SMART Readme File
  5.                       Version: 2.1B
  6.                       May, 1995 
  7. ****************************************************************************
  8.  
  9.    PLEASE, take a few moments to read this file.  
  10.  
  11. ****************************************************************************
  12. ****************************************************************************
  13.    INSTALLATION OPTIONS
  14. ****************************************************************************
  15.  
  16. You have a number of installation choices:
  17.  
  18. 1. You can install the full SMART product from a CD-ROM.  This will require
  19. approximately 20 MBytes of hard disk.
  20.  
  21. 2. You can install a reduced version of SMART by not selecting
  22. to install all of the migration databases.
  23.  
  24. 3. You can install a "mini-version" of SMART (just those
  25. read-write files required by the application) and run from the CD-ROM.
  26.  
  27. 4. You can create installation diskettes from the CD-ROM and install the
  28. full or reduced version from these diskettes.  To create installation   
  29. diskettes from your CD-ROM (you will need eight diskettes): 
  30.    a. Switch to your CD-ROM drive.
  31.    b. Change to the IMAGES directory from the SMART main directory.
  32.    c. Insert a blank diskette in your floppy drive.         
  33.    d. Enter:   
  34.             LOADDSKF  SMART_Dn.IMG  A:
  35.       to create a copy of each of the disk images.   Substitute the 
  36.       appropriate number for n.   
  37.   
  38.       For example, to create the first diskette, enter LOADDSKF SMART_D1.IMG  A:       
  39.     
  40. 5. You can make an image of the CD-ROM SMART directory and sub-directories
  41. on your network and install and run from this image.
  42.  
  43. 6. The options for full, reduced or mini installation are available on the
  44. installation dialog panel which will appear when you choose 'Install' in 
  45. the SMART installation program.
  46.  
  47. ****************************************************************************
  48.    INSTALLATION
  49. ****************************************************************************
  50.  
  51. 1. Install SMART by entering "INSTALL" from a command line set to your floppy
  52. disk drive containing the SMART Installation  Disk or from the CD-ROM 
  53. directory containing the SMART files.
  54.  
  55. 2. Desktop program objects and icons will be created as part of this 
  56. installation.
  57.  
  58. ****************************************************************************
  59.    HELP
  60. ****************************************************************************
  61.  
  62. 1. To see online help in SMART, press F1 with the focus on any menu item
  63.    or dialog panel. Select "General Help" from the "Help" menu and navigate 
  64.    throughout the help facility.
  65.  
  66. 2. Help documents (Users' Guides) can be found in your SMART desktop folder.
  67.  
  68. 3. For printed documentation, print while viewing the guide.
  69.    See 'Services' on the help menu bar.
  70.  
  71. ****************************************************************************
  72.    ADDITIONAL NOTES ON USING SMART
  73. ****************************************************************************
  74. New notes for SMART Version 2.1B:
  75.  
  76. 1.  Resource files that are converted from Windows to OS/2 contain no comments
  77.     regarding converted code.   Refer to the "error log" produced during the 
  78.     resource file translation for comments, warnings and errors related to 
  79.     the converted file.
  80.  
  81.  
  82.  
  83. Notes from previous versions that still apply:
  84.  
  85.  
  86. 1.  New UDMDs (User Defined Migration Databases) are located in the SMARTAUX
  87.     subdirectory.   OS/2 WARP UDMD is in the WN32WARP subdirectory.  Power PC
  88.     UDMD is in the WN16PWPC and WN32PWPC subdirectories.  MDI UDMD is in the
  89.     WINXOS2 subdirectory.
  90.  
  91. 2.  MDI (Multiple Document Interface):   Included with SMART is a
  92.     UDMD  that contains MDI keywords named WINXOS2.DCT. The WINXOS2
  93.     UDMD is located in the directory ..\SMARTAUX\WINXOS2.  Documentation
  94.     for MDI implementation is located in MDI.DOC which resides in
  95.     ..SMARTAUX\SMARTMDI\.
  96.  
  97.  
  98. 3.  HELP file conversion with SMART:  After converting a HELP file to an IPF
  99.     file with SMART, the IPF facility will compile it to either INF or HLP.
  100.     Therefore, the IPF compiler, available from the OS/2 Developer's Toolkit,
  101.     is necessary.
  102.  
  103. 4.  When converting HELP files with SMART, the "input" file should always be
  104.     an HPJ file.  The HPJ file will contain the name of the RTF file(s) and
  105.     any bitmap files that are needed. A sample HPJ file can be found in 
  106.     SMARTAUX directory in the file SAMPLE.HPJ.
  107.  
  108. 5.  Step-by-step instructions on how to convert HELP files with SMART
  109.     are included in the SMART User's Guide and in SMART's online help.
  110.  
  111.  
  112. 6.  Any Microsoft Windows keyword or command present in a UDMD table will 
  113.     terminate the processing of the table.   That includes all UDMD 
  114.     format tags except for .KEYWORD.  That also includes comments.  For 
  115.     example, if a Windows key word was included in a comment in the 
  116.     .COMMENT format tag, SMART would not create the UDMD.
  117.  
  118. 7.  Before installing SMART Version 2,  completely remove SMART Version 1.
  119.     SMART Version 2 does not install properly unless SMART Version 1 is 
  120.     deleted.
  121.  
  122. 8.  If source code is partially migrated with version 1 and you want to
  123.     move to SMART Version 2, then remove tagged code lines from source 
  124.     code.
  125.  
  126. 9.  The "removal" process for SMART will delete any directories (and files 
  127.      in    those directories) and subdirectories that were installed when 
  128.      SMART was installed.  Be careful not to inadvertently delete files that
  129.     are needed.
  130.  
  131.  
  132.     
  133.  
  134.  
  135.  
  136.