home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / odtlktv5.zip / ODTLKT / README next >
Text File  |  1996-02-21  |  9KB  |  276 lines
  1. __________________________________________________________________
  2.  
  3. IBM  OPENDOC DEVELOPER'S TOOLKIT FOR OS/2 WARP README FILE
  4. __________________________________________________________________
  5.  
  6. Welcome to the IBM* OpenDoc Developer's Toolkit for OS/2* Warp (Toolkit).
  7. In addition to this README, the book--"Using Your Toolkit"--is
  8. included to help you:
  9.  
  10.    -  See what is new and what has changed in the Toolkit
  11.    -  Become familiar with the Toolkit
  12.    -  Access information about the Toolkit more easily and quickly
  13.  
  14. This README, a supplement to "Using Your Toolkit," contains the following
  15. information:
  16.  
  17.    1. Introduction to OpenDoc Developer's Toolkit
  18.    2. Installing the OpenDoc Developer's Toolkit
  19.    3. Updates to CONFIG.SYS
  20.  
  21. Use a non-proportional font to view this file.
  22.  
  23.  
  24. INTRODUCTION TO THE OPENDOC DEVELOPER'S TOOLKIT
  25. __________________________________________________________________
  26.  
  27. The OpenDoc Developer's Toolkit helps you develop OpenDoc applications for
  28. OS/2 by providing you with:
  29.  
  30.      - Header files
  31.      - Library files
  32.      - Online documents
  33.      - Programming tools
  34.      - Sample application programs
  35.  
  36. This version of the OpenDoc Developer's Toolkit has been updated to the SOM
  37. Version which corresponds to the level of SOM in FixPak XR_W017 and OpenDoc
  38. for OS/2.
  39.  
  40.  
  41. INSTALLING THE OPENDOC DEVELOPER'S TOOLKIT
  42. __________________________________________________________________
  43.  
  44. This section provides a step-by-step procedure for installing the
  45. OpenDoc Developer's Toolkit.
  46.  
  47.  
  48. System Requirements
  49. __________________________________________________________________
  50.  
  51. The following is the prerequisite software required:
  52.  
  53.    o  OS/2 Warp, Version 3 or
  54.       OS/2 Warp with WIN-OS/2, Version 3 or
  55.       OS/2 Warp Connect or
  56.       OS/2 Warp Connect with WIN-OS/2
  57.  
  58.    o  OS/2 Warp FixPak XR_W017 (available on the Developer Connection
  59.                                 Special Edition and BBS)
  60.  
  61.    o  OpenDoc for OS/2
  62.  
  63.  
  64. Before you install the OpenDoc Developer's Toolkit, make sure you have:
  65.  
  66.    -  A personal computer that has an Intel386** (or higher)
  67.       microprocessor with OS/2 installed
  68.  
  69.    -  A minimum of 4MB of memory (8MB or more is recommended)
  70.  
  71.    -  A high capacity 3.5-inch diskette drive or CD-ROM drive
  72.  
  73.    -  A hard disk drive with 100MB of free disk space (to install
  74.       the entire Toolkit)
  75.  
  76. We recommend that you install a mouse and The Developer's Toolkit for OS/2
  77. Warp Version 3.
  78.  
  79.  
  80. Installation Program
  81. __________________________________________________________________
  82.  
  83. Install all or part of the OpenDoc Developer's Toolkit through the Toolkit
  84. Installation Program (a Presentation Manager/2* (PM) application).
  85. Through the Toolkit Installation Program, you can install:
  86.  
  87.      - Header files
  88.      - Library files
  89.      - Online documents
  90.      - Programming tools
  91.      - Sample application programs
  92.  
  93. By default, the Toolkit installation will copy chosen files to your machine
  94. and update CONFIG.SYS with respect to the locally installed files.
  95.  
  96.  
  97. Installation Help
  98. __________________________________________________________________
  99.  
  100. When installing the OpenDoc Developer's Toolkit, get online help for
  101. installation by doing one of the following:
  102.  
  103.    -  Press the F1 key
  104.    -  Select the Help push button
  105.    -  Choose one of the help choices from the Help menu
  106.  
  107.  
  108.  
  109. Installing the OpenDoc Developer's Toolkit
  110. __________________________________________________________________
  111.  
  112. To install the Toolkit, do the following:
  113.  
  114.    1. Unpacking the OpenDoc Developer's Toolkit package using any standard
  115.       programs that understands .ZIP format.
  116.  
  117.       For example, the PKUNZIP, (use the -d option to retain all subdirectories)
  118.       Type in:  pkunzip -d ODTLKT0n
  119.       ( n = 1 to 7, there is a total of 7 zip files )
  120.  
  121.    2. Start the OpenDoc Developer's Toolkit Installation Program
  122.  
  123.             CD path\ODTLKT
  124.  
  125.       (where path is the location of the unpacked files including drive letter)
  126.  
  127.          Type the following and press Enter:
  128.  
  129.             TKINSTAL
  130.  
  131.    3.  The system displays the "IBM OpenDoc Developer's Toolkit for OS/2 Warp
  132.        Installation" window.  Select each component you want to install.
  133.        Depending on the components you select for installation,
  134.        additional components might be automatically selected for
  135.        installation.  A plus (+) sign in a box in front of a component
  136.        indicates that the component has at least one level of
  137.        subcomponents from which you can select.  Select the plus sign in
  138.        front of the component to expand the list of components.
  139.  
  140.    4. If desired, change the default destination for the selected
  141.       components by editing the "Destination" entry field.  If the entire
  142.       Toolkit is not required, components may still be deselected in the
  143.       usual manner.  However, it is important that the paths are not
  144.       changed from their defaults for all components other than the root.
  145.  
  146.    5. Select the "Options" push button to specify what updates to your
  147.       system are required.  You can choose to:
  148.  
  149.          -  Install the selected files
  150.          -  Register Workplace Shell* classes
  151.          -  Create Workplace Shell objects
  152.          -  Select the file where any CONFIG.SYS updates are to be made,
  153.             or deselect the "Write CONFIG.SYS updates to:" check box to
  154.             prevent the Toolkit Installation program from updating
  155.             CONFIG.SYS.
  156.  
  157.    6. To install all selected components of the OpenDoc Developer's Toolkit:
  158.  
  159.          a. Select the "Install" push button.
  160.          b. Follow the prompts in the message boxes to complete the
  161.             installation.
  162.  
  163.    7. The system displays a message box indicating successful completion
  164.       of the installation.
  165.  
  166.    8. To make the changes effective and have the Toolkit folder appear
  167.       on the Desktop, shut down and restart your system.  After the
  168.       Toolkit is installed, the Toolkit folder appears on the desktop,
  169.       represented by the toolbox icon.  If you installed the entire
  170.       Toolkit, the folder will contain the following subfolders for
  171.       the installed components:
  172.  
  173.          -  Development Tools
  174.          -  Toolkit Information
  175.          -  Headers & Libraries
  176.          -  Sample Programs
  177.          -  Try Me!
  178.  
  179.  
  180. UPDATES TO CONFIG.SYS
  181. __________________________________________________________________
  182.  
  183. The Toolkit Installation Program adds the paths of all needed
  184. environment variables with the appropriate Toolkit path.  These
  185. variables include, but are not limited to:
  186.  
  187.    -  BOOKSHELF
  188.    -  DPATH
  189.    -  HELP
  190.    -  INCLUDE
  191.    -  LIB
  192.    -  LIBPATH
  193.    -  PATH
  194.    -  SMEMIT
  195.    -  SMINCLUDE
  196.    -  SOMBASE
  197.    -  SOMIR
  198.    -  TMP
  199.  
  200.  
  201. OpenDoc
  202. __________________________________________________________________
  203.  
  204. When compiling an OpenDoc part with DTS and define the
  205. symbol INCL_OD, you will also need to define the following 5
  206. symbols to prevent compile errors:
  207.  
  208.         _DTS_HH_INCLUDED_comp
  209.         _DTS_HH_INCLUDED_compmgr
  210.         _DTS_HH_INCLUDED_osaterm
  211.         _DTS_HH_INCLUDED_osasc
  212.         _DTS_HH_INCLUDED_osagsc
  213.  
  214.  
  215. For more exciting information on OpenDoc development, join
  216. Club OpenDoc on the World Wide Web at:
  217.  
  218.         http://www.software.ibm.com/clubopendoc
  219.  
  220. Highlights include news and information, community spirit interaction,
  221. and technical information in a two-way communication channel.
  222.  
  223. Come on aboard!
  224.  
  225.  
  226. __________________________________________________________________
  227.  
  228. Thank you for your continued interest in OS/2.
  229. __________________________________________________________________
  230.  
  231.  
  232. TRADEMARK INFORMATION
  233. _____________________
  234.  
  235.  
  236. The following terms, denoted by an asterisk (*) in this file, are
  237. trademarks or registered trademarks of the IBM Corporation in the United
  238. States or other countries:
  239.  
  240.    -------------------------------------------------------
  241.    C Set ++
  242.    -------------------------------------------------------
  243.    IBM
  244.    -------------------------------------------------------
  245.    OS/2
  246.    -------------------------------------------------------
  247.    Presentation Manager/2
  248.    -------------------------------------------------------
  249.    VisualAge
  250.    -------------------------------------------------------
  251.    Workplace Shell
  252.    -------------------------------------------------------
  253.  
  254.  
  255. The following terms, denoted by a double asterisk (**) in this
  256. publication, are trademarks of other companies:
  257.  
  258.    -------------------------------------------------------
  259.    Intel386                    Intel
  260.    Pro AudioSpectrum 16        Media Vision, Inc.
  261.    Sound Blaster               Creative Technology, Ltd.
  262.    Windows                     Microsoft Corporation
  263.    -------------------------------------------------------
  264.  
  265. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING
  266. WITHOUT LIMITATION, WARRANTIES OF FITNESS AND MERCHANTABILITY WITH
  267. RESPECT TO THE INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS
  268. DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS.
  269.  
  270. Copyright IBM Corporation, 1996, all rights reserved.
  271.  
  272. __________________________________________________________________
  273.  
  274. END-OF-README-FILE
  275. __________________________________________________________________
  276.