home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / wf_expl / read.1st < prev    next >
Text File  |  1992-05-03  |  5KB  |  101 lines
  1. This diskette contains documents and sample code to assist developers
  2. integrate their tools into the WorkFrame/2 environment.  Updates
  3. will be shipped to registered users as they become available.   The
  4. sample code is shipped as-is with no guarantees to its correctness.
  5. Any support of the code will be provided as time permits.
  6.  
  7.  
  8. The following documents are available on this diskette:
  9.  
  10.    1. INTRFACE.DOC  - "WorkFrame/2 Programming Interfaces"
  11.    2. NDXFORM.DOC   - "NDX File Format"
  12.    3. WFDRAG.DOC    - "WorkFrame/2 Drag & Drop Conventions"
  13.  
  14. These documents are also available in hard copy form.  The diskette
  15. versions are straight ASCII files and as a result, are missing the
  16. figures showing several of the WorkFrame/2 screens.
  17.  
  18.  
  19. In the SAMPLES subdirectory you will find the following C sample code:
  20.  
  21.    1. INSTALL.C   - This file contains a subroutine which will help you
  22.                     identify whether the WorkFrame/2 has already been 
  23.                     installed.  If installed, it will return its installation
  24.                     directory.  This directory should be used for installing
  25.                     any PRJ and PRF (project control and language profiles)
  26.                     files during your product installation.
  27.  
  28.    2. WRITEPRJ.C  - This file contains a complete subroutine which will
  29.                     allow you to dynamically create a PRJ file.  This will
  30.                     be necessary if you intend on intalling sample projects
  31.                     and wish to automatically make its PRJ file available.
  32.                     This subroutine can also be used to determine the layout
  33.                     format of the PRJ file.
  34.  
  35.    3. LANGPROF.H  - This provides the structure layout of the language profile
  36.                     (PRF) file.  This information will be required if you
  37.                     need to dynamically create a language profile as part
  38.                     of your installation.
  39.  
  40.  
  41. In addition to the sample code, you will also find the following utilities:
  42.  
  43.    1. CRTPRF.EXE  - This is our own version of the MAKEINI.EXE used
  44.                     for creating the necessary INI input file to the ADDTOOL
  45.                     utility. The CRTPRF has larger string length limits to
  46.                     match that of the Tool descriptions within the 
  47.                     WorkFrame/2. 
  48.  
  49.       SAMPLE.RC   - This is a sample RC input file to CRTPRF.EXE which
  50.                     installs 2 distinct tools into the WorkFrame/2 Tools 
  51.                     pulldown menu.  It is also self-documented, describing
  52.                     the RC file format as well as the various options.
  53.  
  54.    2. WF2DDE.EXE  - This PM program simulates the editor DDE server
  55.                     component.  It can be used to ensure that the
  56.                     proper compiler error information is being passed
  57.                     to the editor session when dragged(!) to this process.
  58.                     It is a good test for the following compiler support
  59.                     APIs while in dragging mode:  PARSEERROR, QUERYHELPFILE,
  60.                     QUERYRESOURCEID.  Note that the program should be
  61.                     started as a tool and not as an editor.
  62.  
  63.  
  64. Also in the SAMPLES subdirectory, there are 2 language profiles:
  65.  
  66.    1. DOSRUN.PRF  - This profile uses the DEFAULT.DLL and the DOSRUN 
  67.                     components to provide support for developing DOS 
  68.                     applications.
  69.  
  70.    2. MSC600.PRF  - This profile uses the IBMCCOMP.DLL (sample user built
  71.                     DLL for non-supporting compilers), to provide greater
  72.                     WorkFrame/2 integration then that provided by the
  73.                     DEFAULT.DLL.
  74.  
  75.  
  76. The following samples are also included in this diskette:
  77.  
  78.    1. DOSRUN contains a composite project "DOSRUN" and 2 base projects
  79.       "DOSCL1" and "DOSCL2".  This project works in conjuntion with
  80.       the DOSRUN.PRF language profile to provide native DOS compiler
  81.       support.
  82.  
  83.    2. IBMC2 contains all the source required to build the IBMCCOMP.DLL.
  84.       This DLL provides the compiler support for IBM C/2 and Microsoft
  85.       C 5.0 to 6.0 compilers.  It does not contain suppport for creating
  86.       make files.
  87.  
  88.  
  89.  
  90.  
  91. If you have any technical questions, forward them to
  92.  
  93. John Kehm
  94. IBM Canada Ltd.,
  95. 844 Don Mills Rd.,
  96. North York, Ontario,
  97. Canada M3C 1V7
  98.  
  99. IBM VNET : KEHM at TOROLAB6
  100. email    : workframe@vnet.ibm.com
  101.