home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / idedll.zip / README.TXT < prev    next >
Text File  |  1995-11-23  |  4KB  |  88 lines
  1. Files in this ZIP file:
  2.  
  3. CPELINK.C       - Source code for the DLL
  4. CPELINK.H
  5. CPELINK.TGT     - Watcom Target file for the CPELINK.DLL
  6. CPELINK.WPJ     - Watcom Project file for the CPELINK.DLL
  7. README.TXT      - This file
  8. WATCOM.PEL      - PEL file with support routines for the PREDITOR/2 package
  9.  
  10. This DLL will link the Watcom IDE to CompuWare's PREDITOR/2 editor.  This is a
  11. first pass at the DLL, and there are a few things that I know could be improved
  12. with the interface, but it seems to provide the basic interface.
  13.  
  14. Please read the comments at the begining of the CPELINK.C file for information
  15. on redistributing this software and other such issues.
  16.  
  17. I will happily attempt to answer any questions one might have about this DLL,
  18. but I cannot make any promises about how long it will take, or the accuracy of
  19. my answers.  If you do make improvements to the code, I would certainly be
  20. intersted in seeing them.  You can email me at 76512,3213@compuserve.com.
  21.  
  22. To use this DLL, do the following:
  23.  
  24. 1) Copy the CPELINK.DLL into some directory that is part of the LIBPATH
  25.    defined in your CONFIG.SYS.  The \WATCOM\BINP\DLL directory is a good
  26.    choice.
  27.  
  28. 2) Copy the WATCOM.PEL file to the PREDITOR/2 directory used to hold the PEL
  29.    files for the editor.  The default directory is \CPE\PEL.
  30.  
  31. 3) Add a line to the WPEL.RSP file (which should reside in the same directory
  32.    as the PEL files).  The line should read:
  33.  
  34.    WATCOM.PEL
  35.  
  36.    This tells the PREDITOR/2 PEL Compiler that the WATCOM.PEL file should be
  37.    included as part of the next compilation of the eidtor's PEL files.
  38.  
  39. 4) Run the MAKE_AE.CMD command file (which should also be in the same directory
  40.    as the PEL files).  This will recompile the CPE.AE file that the editor
  41.    uses during its operations.
  42.  
  43. 5) You should then shutdown any copies of the PREDITOR/2 editor that you are
  44.    running.  The changes made to the CPE.AE file will only be active in copies
  45.    of the editor started *after* the new CPE.AE file was created.
  46.  
  47. 6) Go into the Watcom IDE and click on the 'File' menu item in the menu bar.  In
  48.    the pop-up menu that appears, there is an item label 'Set Text Editor'.  Click
  49.    on that item.  You should now have a dialog window that is asking you to supply
  50.    the name of the DLL or executable to use within the IDE to access the editor.
  51.  
  52. 7) In the box labeled 'Enter Editor File Name:' type in 'CPELINK' (do *not* include
  53.    the quotes, only the seven-letter name).  In the box labeled 'Editor Type', click
  54.    on the radio button labeled 'DLL'.
  55.  
  56. 8) Click on the 'OK' button and you're ready to go.
  57.  
  58.  
  59. Known Problems:
  60.  
  61. The PREDITOR/2, version 2.1, does not send WM_DDE_TERMINATE messages to clients
  62. when it terminates.  Therefore, you should avoid terminating the editor before
  63. terminating the IDE.  Starting up the editor from within the IDE and then
  64. terminating the editor can result in the IDE telling you that it cannot access
  65. the editor.  The error will not go away until you shut down the IDE and then
  66. restart it.
  67.  
  68. The EDITSaveFiles function doesn't do anything at the moment.  Therefore, if you
  69. have modified files in the editor, you must remember to save them before instructing
  70. the IDE to compile.
  71.  
  72. It is possible that once this DLL is loaded into memory, it will *never* be removed
  73. until the machine is rebooted (I haven't had a chance to check this yet).  This shouldn't
  74. actually cause a problem other than the memory it occupies (which shouldn't be that much,
  75. really).
  76.  
  77. On slower machines, the editor might not have enough time to load and initialize
  78. before the IDE will give up on trying to contact it.  This problem can be
  79. solved by editing the CPELINK.C file and changing WAITTIME constant to a larger
  80. value (WAITTIME is the number of seconds to wait for the PREDITOR/2 editor to
  81. load and initialize).  You will then need to recompile the DLL and copy the new
  82. DLL over the old DLL (which you will not be able to do while the IDE is running).
  83.  
  84. Everything within this DLL is based upon one sample DLL that was written for the
  85. Windoze environment and my own experimentation.  Therefore, who knows if this DLL
  86. will work in all situtations.  I think it will, but since Watcom couldn't be bothered
  87. to respond to any of my inquiries about how the editor DLL is used from the IDE, I
  88. just don't know for sure.