home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / gbasedoc.zip / README < prev    next >
Text File  |  1995-10-19  |  10KB  |  274 lines
  1. ____________________________________________________________________
  2. ********************************************************************
  3. ____________________________________________________________________
  4.  
  5.                          GUIDELINES 3.2
  6.                          ─────────────
  7.  
  8. Version Control
  9.  
  10. 3.1.1  11/07/95   Released with PIP1 of G3.1A
  11.                         Amended to include OS/2 generated application
  12.                         install instructions
  13.  
  14.                         PIP1 details added
  15.  
  16. 3.2    13/10/95   Redesigned for simpler User understanding and 
  17.                         updated for 3.2 release.
  18.  
  19.  
  20. Graphical User Interface Editor and Application Generator for Personal
  21. Computers running IBM's OS/2 Version 2.1 or higher.
  22.  
  23. JBA reserves the right to change the function and design of the 
  24. Guidelines product without prior notice.
  25.  
  26. ____________________________________________________________________
  27. ********************************************************************
  28. ____________________________________________________________________
  29.  
  30. Please refer to the following documents for further information on:
  31.  
  32. 1. Licence Conditions                   - READEME.LIC
  33. 2. Support Information & Trademarks     - README.SUP
  34. 3. Technical information for OS/2       - README.OS2
  35. 4. Technical Information for Windows    - README.WIN
  36. 5. New Features in this release         - README.NEW
  37. 6. Known problems in this release       - README.PRB
  38. 7. Installation                         - see below
  39.  
  40. ____________________________________________________________________
  41. ********************************************************************
  42. ____________________________________________________________________
  43.  
  44.  
  45. INSTALLATION
  46. ────────────
  47.  
  48.  
  49. SYSTEM REQUIREMENTS
  50. ───────────────────
  51.  
  52. The Guidelines Editor requires that you have OS/2 Version 2.1 or
  53. higher already installed on your computer. For information about setting
  54. up OS/2 on your computer, see the instructions in your OS/2 package.
  55.  
  56. The minimum hardware requirements for running Guidelines are the same
  57. as for OS/2 itself. However the recommended configuration
  58. for Guidelines development is as follows:
  59.  
  60.     ■ 486 DX 33Mhz PC
  61.     ■ SVGA display card and the appropriate monitor
  62.     ■ 16MB of memory
  63.     ■ 210MB of disk
  64.  
  65. Guidelines assumes that you have a supported C++ compiler and the OS/2
  66. Toolkit installed on your hard drive. While applications can be designed
  67. without a C++ compiler, the source code generated cannot be compiled
  68. into an executable unless one is present.
  69.  
  70.  
  71. COMPILERS / PLATFORMS
  72. ──────────────────────
  73.  
  74. Version 3.2 of Guidelines supports the following compilers:-
  75.  
  76.         IBM     C++ 2.01
  77.         IBM     C++ 3.00 VisualAge
  78.         Borland C++ 4.0
  79.         Borland C++ 4.5
  80.  
  81. In line with current policy of supporting the latest versions of third party 
  82. software, JBA will discontinue support for IBM C++ 2.01 and Borland 4.0
  83. compilers six months from this release (ie. in first quarter 1996).
  84.  
  85. For the same reasons, JBA will discontinue support for the OS/2 2.1
  86. platform six months from this release (ie. in first quarter 1996).
  87. *********************************************************
  88.  PLEASE NOTE: JBA RECOMMEND THE USE OF OS/2 3.0 WARP OR
  89.  LATER. Guidelines works on OS/2 2.1, but reported problems which
  90.  occur on this version will not be fixed unless they are reproducible
  91.  using WARP. 
  92. *********************************************************
  93.  
  94.  
  95.  
  96. INSTALLATION
  97. ────────────
  98.  
  99.   Preliminary
  100.   ───────────
  101.  
  102.   You may encounter unusual behaviour if you combine old and new versions
  103.   of Guidelines.  To avoid this, it is recommended that before installing
  104.   Guidelines, you should manually remove all references to any existing
  105.   version of Guidelines from your CONFIG.SYS file (typically any references
  106.   to GUIDE or CSS), remove your Guidelines folder and template, and then
  107.   delete your old \GUIDE and \CSS directories. This will ensure that
  108.   Guidelines does not encounter any problems with old versions of controls
  109.   that may be left over should Guidelines be installed over an existing version.
  110.  
  111.   You can delete your \GUIDE and \CSS directories from within the Drives
  112.   object on Workplace Shell by using the Delete option on their popup
  113.   menus or dragging and dropping them onto the Shredder.  You can delete
  114.   your Guidelines folder and the Guidelines template (in your Templates
  115.   folder) in the same way.
  116.  
  117.   Installing from ZIP file
  118.   ────────────────────────
  119.  
  120.   If you are installing the shareware release of Guidelines, ensure that
  121.   you have obtained all of the archives (there are four) from a reliable
  122.   source.  The shareware release of Guidelines is available on CompuServe
  123.   in the files section of the OS2AVEN forum, on FIDONET on any site
  124.   worldwide that carries the file distribution backbone from Fernwood
  125.   (1:141/109.0 and 1:141/209.0), and on the Hobbes FTP site
  126.   (ftp.hobbes.nmsu.edu).
  127.  
  128.   Unarchive the archives into an empty directory and run the install
  129.   program INSTALL.EXE from that directory.
  130.  
  131.  
  132.   Installing from Diskette
  133.   ────────────────────────
  134.  
  135.   To install Guidelines, insert the first installation disk into your 
  136.   floppy drive (drive A:) and type:
  137.  
  138.         A:\INSTALL
  139.  
  140.   at a native OS/2 command prompt.
  141.  
  142.   Please refer to the main install document for general installation
  143.   instructions. This is located on the first diskette and may be viewed
  144.   by typing the following command:
  145.  
  146.     VIEW A:\INSTALL.INF
  147.  
  148.  
  149.   Installing from an IBM AS/400
  150.   ─────────────────────────────
  151.  
  152.   If you are installing Guidelines from an IBM AS/400 via PC Support the
  153.   installation instructions are contained in an on-line document.  To view
  154.   the document enter the following command from your PC:
  155.  
  156.   VIEW I:\GUI_INST.ALL\INSTALL.INF
  157.  
  158.   where I: is your PC Support shared folder drive and GUI_INST.ALL is
  159.   where the Guidelines installation packs reside on that folder.
  160.  
  161.  
  162.   Installation Options
  163.   ────────────────────
  164.   
  165.   NOTE:
  166.   You may also choose to disable support for certain compilers. Only support
  167.   for the compilers you use need to be installed, clear the checkbox next
  168.   to a particular compiler name to prevent any files for that compiler
  169.   being installed. Note that VisualAge and Borland 4.5 are mandatory for
  170.   CSet 2.01 and Borland 4.0 respectively. This is because Guidelines requires
  171.   these for its own objects at design and runtime.
  172.  
  173.   The environment paths within Guidelines may require updating after 
  174.   installation, especially if both IBM or both Borland compilers were loaded.
  175.   Please refer to the README.OS2 (IBM) or README.WIN (BORLAND)
  176.   documents for further detail.
  177.   
  178.  
  179.   Icons and Bitmaps
  180.   ─────────────────
  181.  
  182.   Once Guidelines has been installed, you can extract the icons and bitmaps
  183.   (.ICO and .BMP files) by selecting the "Install Images" icon in the
  184.   Guidelines folder. If you wish to extract icons for Microsoft Windows
  185.   development, select the "Install Windows Images" icon - this will extract
  186.   icons which have the extension .ICW and bitmaps which have the extension
  187.   .BMW.
  188.  
  189.   There are over 400 icon and bitmap files in each archive.
  190.  
  191.   The Windows Icons are shipped as part of the Windows Code Enable pack.
  192.  
  193.  
  194. RUNNING GUIDELINES
  195. ──────────────────
  196.  
  197. After a successful installation you may invoke Guidelines by typing "Guide"
  198. and depressing the Enter key at a command prompt, or via the work place
  199. object created (optionally) during the install.
  200.  
  201.  
  202.   ─────────────────────────────────────────────
  203. ─ EXTRA INSTRUCTIONS FOR - NEW IMAGE EXTENSION ─────────────────
  204.   ─────────────────────────────────────────────
  205.  
  206.   The Image DLLs for OS2 and Windows are copied to {GUIDE}\OS2\DLL and
  207.    {GUIDE}\WIN\DLL respectively. They have to be in separate directories 
  208.   as some DLLs have the same name for both environments. Ensure that 
  209.   {GUIDE}\OS2\DLL is on the LIBPATH of the OS2 Config.Sys and 
  210.   {GUIDE}\WIN\DLL is on the WINDOWS path.
  211.  
  212.   
  213. Color Installation (OS2)
  214.  
  215. The following is needed if image scanning is required...
  216.  
  217.   Copy {GUIDE}\OS2DRV\ASPIDRV.SYS to C:\OS2
  218.  
  219.   Add the following to the Config.Sys file:
  220.  
  221.   BASEDEV=OS2ASPI.DMD
  222.   BASEDEV=AHA154X.ADD /V /ET A:0 /!DM:2
  223.   DEVICE=C:\OS2\ASPIDRV.SYS
  224.  
  225.   This loads the OS2 ASPI Device Manager and Adaptec AHA 1542 SCSI Card
  226.   ADD driver. The last parameter of line 2 stops the OS2 Disk Manager from 
  227.   accessing SCSI device 2. Change this for the SCSI ID of the Scanner / Printer
  228.   installed. Be very careful when changing the Config.Sys if the hard disk uses 
  229.   the same SCSI controller. Setting a line incorrectly could stop the system 
  230.   from recognising the hard disk.
  231.  
  232.  
  233. Color Installation (Windows)
  234.  
  235. The following is needed if image scanning is required...
  236.  
  237.   Create a directory C:\ASPI
  238.   Copy {GUIDE}\WINDRV\ASPI2DOS.SYS to C:\ASPI
  239.   Copy {GUIDE}\WINDRV\ASPI4DOS.SYS to C:\ASPI
  240.   Copy {GUIDE}\WINDRV\VASPID.386 to C:\ASPI
  241.  
  242.   Add the following to the Config.Sys file:
  243.  
  244.   DEVICE=C:\ASPI\ASPI2DOS.SYS  (for the AHA1510 Adapter card)
  245.   DEVICE=C:\ASPI\ASPI4DOS.SYS  (for the AHA1542 Adapter card)
  246.  
  247.   Add the following to the Windows SYSTEM.INI file:
  248.  
  249.   DEVICE=C:\ASPI\VASPID.386
  250.  
  251.  
  252. Monochrome Installation (Windows)
  253.  
  254. The following is needed if image scanning or display is required...
  255.  
  256.   Go to directory {GUIDE}\WINKIPP and run INSTALL.
  257.  
  258.         During the install, select the desired drive and directories,
  259.         choose the option to install KF-911, then complete the install.
  260.  
  261.  
  262.   ───────────────────────────────────────────────────
  263. ─ EXTRA INSTRUCTIONS FOR - NEW LOTUS NOTES EXTENSION ────────
  264.   ───────────────────────────────────────────────────
  265.  
  266.   In order for Lotus Notes samples to be used, they must be moved from 
  267.   the {GUIDE}\SAMPLES\DATA directory to the Lotus Notes data directory
  268.   (typically {NOTES}\DATA). All Notes samples have .NSF suffixes.
  269.  
  270. ____________________________________________________________________
  271. ********************************************************************
  272. ____________________________________________________________________
  273.  
  274.