	  	    Dr Wimp Elixir_08
	  	    (The "OLE Elixir")

   	       Version 1.01 (October 9th 2006)
   	       
   	       
   	       
This folder contains the DrWimp Elixir_08 which implements the RISCOS
OLE protocol.

Overview of Elixir_08 contents

There are actually four OLE Elixir libraries in the folder:

    !DrWimpOLE - the main OLE Elixir (includes a user-function library)

    !DrWimpBLK - a support Elixir

    !DrWimpSCP - a support Elixir

    !DrWimpRIU - a support Elixir (includes a user-function library)

The three support Elixirs can also be used independently of the OLE
Elixir.

The Help directory contains the ElixirOLE Manual in StrongHelp format.

For an overview of the above libraries, run the 'ElixirOLE' StrongHelp
file and in its main window click the i for information icon at the
top right - and select Overview. (In this doucument, several
references are made to Dr Wimp's 'FuncProc' StrongHelp file which is
in its usual place inside the Documents folder of the main Dr Wimp
package.)

As can be seen from the above names, the four OLE Elixir libraries are
in application directories and each has a !Boot file which sets
important system variables so they can be loaded painlessly using
Basic's LIBRARY command.

As indicated, two of the Elixirs have separate user-function library
files inside them. These files need to be copied into the !RunImage of
an application using the Elixirs.


Example application !OLETest

The example application !OLETest should run from where you find it -
or as long as the Elixir system variables have been set.

!OLETest opens a single window with five icons in it. Clicking on
these should start an OLE session for the test file associated with
each icon (in the 'testfiles' folder). If your filer has seen !Zap or
!StrongEd the text-file icon illustrates an OLE session with !OLETest
as a client to a 'real' OLE server - !Zap, or !StrongEd. The other
icons will load the OLE Support module from the
!OLETest.Resources.Modules directory to illustrate OLE editing with
non-OLE editors. (Don't try !SrceEdit with this - its OLE server
system variable doesn't seem right, and !SrceEdit might crash on
loading) The module is also included in the folder in the
Resources.Modules directory. Also, the last icon in the !OLETest
window is for an OvationPro file, so it will only work if you have the
OvationPro application, and it has been seen by the filer.

Using !OLETest you should be able to edit the files and save them back
to !OLETest - and close the OLE session by either closing the editor
window or using the pop up menu in the !OLETest window when over an
icon. (Then see the result by starting a new OLE session by clicking
on the text file icon in the !OLETest window. If the session has
already been started you should get a warning message stating that
instead of a second OLE session on the same data).

If you lose the !OLETest window in the window stack, click on the
!OLETest iconbar icon to bring it to the front again (or on a part of
the window background).

OLE Support module and !MyOLE

To use the Elixir with editors that do not natively support the RISCOS
OLE protocol you will need the OLE Support module. There is a 26-bit
module with the folder (in Resources.Modules.26bit).

However, there isn't a freeware 32-bit compatible OLE Support module
that can be distributed with programs. You may already have a version
on your system supplied with another program. If you don't then you
can use an alternative module supplied with the folder !MyOLE. It is
in its own application directory in the folder.

To find out more on using the OLE Support module with the Elixir read
the StrongHelp Manual - follow the i for information link on the root
page and select Overview and scroll down to the The OLE Support Module
sub heading. To find out how to use the MyOLE module with the Elixir
follow the i for information link next to the The OLE Support Module
sub heading.

-----------------
Release History
-----------------

Version 1.01 - 9th October 2006

Bug fix to enable multi-session client operations to work properly.

-----------------
Version 1.00 - 1st October 2006

Initial release (with Dr Wimp Version 4.60)


-----------------
EOF101