home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / z / zap / !Zap / 3rdParty / Aylett / Help next >
Text File  |  1996-11-04  |  4KB  |  96 lines
  1. ZapOLE - Object Linking and Embedding for Zap
  2. ---------------------------------------------
  3.  
  4. Legal:
  5. ------
  6.  
  7. The ZapOLE module is © James Aylett. Please feel free to distribute it with
  8. Zap or ArcWeb, on the condition that the module and this accompanying
  9. helpfile are both distributed unaltered and unseparated, and under the
  10. distribution conditions of Zap or ArcWeb as appropriate. If you want to
  11. distribute ZapOLE in any other way, please get in touch with me.
  12.  
  13. Introduction:
  14. -------------
  15.  
  16. ZapOLE is an extension module for Zap which enables you to use Zap as an OLE
  17. server, using Computer Concepts' Object Linking and Embedding protocol. OLE
  18. is used by applications such as Impression and ArcWeb to ask other
  19. applications to edit data for them that they cannot edit themselves.
  20.  
  21. ZapOLE is smaller and faster than using OLESupport, CC's module for
  22. simluating OLE sessions with applications that do not support OLE themselves.
  23. There is also no doubt about the legal status of distributing it :-).
  24.  
  25. ZapOLE version 0.06 requires Zap (by Dominic Symes) version 1.33 or later. To
  26. use it for interactive HTML editing you require ArcWeb (by Stewart Brodie)
  27. version 1.62 or later.
  28.  
  29. Installation and use:
  30. ---------------------
  31.  
  32. Installing this is slightly icky. First, copy this directory into
  33. !Zap.3rdParty. Then you have to make sure that Zap does the following in its
  34. !Boot and !Run files:
  35.  
  36. Set OLEServer$Type_xxx -N Zap -R /<Zap$Dir>
  37.  
  38. for any filetype xxx that you want Zap to cope with. Useful ones are fff (for
  39. text files, and also used by ArcWeb to look for a textual editor for HTML)
  40. and ffb (BASIC). Then ensure that Zap knows about the ZapOLE by adding the
  41. following to the External file:
  42.  
  43. <Zap$3rdParty>.Aylett.ZapOLE
  44.     OLE
  45.     -
  46.     -
  47.     &80E21
  48.  
  49. You might like to make it auto-loading (stick " *" without the quotes at the
  50. end of the first line of the entry) which will make the first response
  51. slightly faster.
  52.  
  53. Now simply start your OLE session in the usual way. Providing Zap has been
  54. booted, it should start up as required, and the session will open. You may
  55. either use ^F3 to quick save, or F3 <Return> or similar to 'slow save' the
  56. file. Saving in either way will update the display in the program which
  57. started the OLE session.
  58. Reopening a session will bring a window on that file to the front.
  59.  
  60. History:
  61. --------
  62.  
  63. 0.01 (26 Sep 96)    First version.
  64. 0.02 (26 Sep 96)    Stopped trying to get Zap_Service 3 to occur and
  65.             started using Zap_Service 4. Works(ish).
  66. 0.03 (27 Sep 96)    Reopening a session brings the window to the front.
  67.             Fixed problem with files going into the wrong mode.
  68.             Fixed mistake with issuing CloseSession messages for
  69.             every window closed rather than just OLE windows.
  70.             Changed window close handling to callback.
  71. 0.04 (27 Sep 96)    Sessions now in a linked list (removed 32 concurrent
  72.             session limit).
  73.             Acts on client CloseSession messages.
  74. 0.05 (04 Nov 96)    Following Dominic's prompting I've rewritten ZapOLE
  75.             as a proper Zap mode. This makes updates on saves
  76.             transparent (previously required OLEFILECHANGED).
  77. 0.06 (04 Nov 96)    Linked list discarded in favour of f_source blocks.
  78.             Zap heap used in preference to RMA.
  79.             f_source block converted to allow integration to
  80.             Text mode.
  81.  
  82. Contact:
  83. --------
  84.  
  85. James Aylett
  86. Clare College
  87. Cambridge
  88. CB2 1TL
  89.  
  90. email: sja20@hermes.cam.ac.uk
  91.  
  92. This is available until June 1997.
  93.  
  94. The latest version of ZapOLE (plus other Acorn things, including ZapConfig)
  95. is available by anonymous ftp to crystal.clare.cam.ac.uk in something
  96. approximating the /pub/acorn/zap directory.