                                Clipboard
                             Thomas Leonard
                       RISC OS 3.0 and above only

                               IcnClipBrd
                             Thomas Leonard
                       RISC OS 3.1 and above only


Brief
~~~~~
The global clipboard provides a way of transferring data between
applications.  You select the data in one application and cut or copy it
onto the clipboard (usually using Ctrl-X and Ctrl-C). You then move to the
other application and paste the data from the clipboard (usually Ctrl-V).

Clipboard allows you to save the current contents of the global clipboard,
either to disc or to another application. You can also drag files from a
filer window to Clipboard to put that file on the clipboard.

A small module, IcnClipBrd, is also provided for users with RISC OS 3.1 or
later which allows you to cut and paste in writeable icons using the global
clipboard.

NOTE: This version no longer requires Shift to be held down.


Conditions
~~~~~~~~~~
This program is FREEWARE, so you can copy it and pass it around as much as
you like as long as none of the files are modified or deleted.

There is no warranty, but please report any bugs to me.


How to use it
~~~~~~~~~~~~~
Once Clipboard is loaded, it will install an icon on the icon bar. Click
Select on this icon to open the 'Save clipboard' window. If there is
anything on the clipboard then you will be able to drag the icon to a
directory or to another application to save the clipboard. You can put a
file onto the clipboard by dragging it to this window.

If you toggle the window size then you can see an extra box which indicates
what Clipboard is doing. This may be helpful for programmers trying to work
out why their program doesn't work with Clipboard.  Note that the problem
may well be Clipboard's fault!

To use IcnClipBrd the caret must be in a writeable icon. Now:

Ctrl-V pastes the global clipboard into the icon.

Ctrl-Z clears the icon, then pastes the clipboard in.

Ctrl-C copies the contents of the icon to the clipboard.

Ctrl-X cuts the contents to the clipboard (copy then clear).

Ctrl-D de-DOSifies the filename in the icon ("NOTES/TXT" -> "Notes").

Ctrl-E extracts the extension only ("NOTES/TXT" -> "TXT").

Ctrl-K deletes everything left of the cursor (not saved to the clipboard).

Ctrl-Q passes the next keypress on to the task as though IcnClipBrd
       wasn't loaded.

You can clear the icon without putting the contents on the clipboard by
using Ctrl-U, as usual.

Note: You may copy the IcnClipBrd module into your boot sequence so that it
can be used without loading the Clipboard application. Also, quitting
Clipboard does not quit the module. Put it in 'Choices:Boot.Tasks'.


How to improve it
~~~~~~~~~~~~~~~~~
Write to me with suggestions, bug reports, lack-of-bugs reports, praise,
money, etc. My address is:

e-mail :             tal197@ecs.soton.ac.uk
WWW    : http://www.ecs.soton.ac.uk/~tal197

Mail   : (very slow)         Thomas Leonard
                           48 Copthall Lane
                         Chalfont St. Peter
                                      Bucks
                                    SL9 ODJ
