It is public domain. This means it may be distributed freely on the condition that:
a. no money is made from it although PD libraries may make a small charge for duplication and p+p.
b. No files are deleted, altered or added to the !Insert directory
The files in the !Insert application should be:
{C!Run, Templates, !Sprites, !RunImage, !Help
Insert is supplied as is. Therefore no guarantee is given or implied as to its fitness for purpose. The author can not be held responsible for any loss of time money or data.
{03Using HyperHelp
To advance a page simply click on the right hand arrow at the top of the window. To go back a page click on the left hand arrow. If either of the arrows is greyed out you have reached on end of the document and may not go further.
Any text highlighted with bright green may be clicked on to jump to a different page in the text.
If, at any point, you want to retrace your steps you can click on the "Go back" icon. It is situated next to the left hand arrow. This will allow you to retrace up to five steps through the pages. If this icon is greyed out then you have retraced your maximum five steps and may not go further back.
If you bring up the HyperHelp menu you can select the name of the page you wish to go to using the contents option. Open the contents sub-menu and select the page you require from the supplied list.
{04The Insert Story
O.K. that's the boring bit out of the way. Now it's time to get down to the nitty-gritty and answer the all important question. What's it all for?
!Insert is a text macro utility. It allows a number of short phrases to be stored and then inserted at the text cursor (caret) when required. It should save wear and tear on your finger tips if there are a number of phrases you use often.
The program was initially written to help with my R.P.R. (this will only make sense to those familiar with the Scottish Examination Boards' Higher English course) That is why the default macros are the names of the different books in the most excellent 'Hitchhikers Guide to the Galaxy' series.
{05How to use Insert
To use Insert simply type in the phrases you want in the allotted spaces. They must be no longer than 42 characters each. Then you start writing what ever it is you are writing and when you want to use one of the macros simply click on the 'Type' icon next to the corresponding macro.
Couldn't be simpler could it? (This is a rhetorical question and doesn't require an answer)
New for version 1.20, <Ctrl><Shift> f5 - f9 now correspond to the appropriate macros. Why doesn't it use <Ctrl><Shift> f1 - f5 I hear you ask. Simple, Edit uses <Ctrl><Shift> f1 to expand tabs so there is a bit of a clash there.
{06Errors
The program will produce certain error messages under certain conditions. These should be self explanatory but here is a bit of explanation just in case.
Number Message Meaning
100 Can't load a directory You have attempted to drag a directory to the !Insert window and it can't cope with directories.
101 Can't load an application Same as above but with an application.
102 Wrong file type You have dragged a file that is not a text file onto the !Insert window. The program can't deal with non text files.
103 Not a macro file You have dragged a text file to !Insert but it doesn't have an identifying string so it didn't came from !Insert in the first place.
{07Error messages
104 I am already typing You have clicked on a type icon while !Insert is already in the middle of typing another string.
105 I don't want to type into myself
The caret is placed in the !Insert window. Remove it.
106 The caret has not been positioned
The caret is not in any window on the desktop. you will have to put it in one before !Insert will work.
107 Data not saved. Really exit?
You have altered the text since the last save. You now have the chance to save it before the program is exited.
{08Technical stuff
{H11WARNING: Read on at your own risk. After this line comes the techno-talk
This program simply places characters in the keyboard buffer on null events. Not very clever I know but I don't know of a different way. I got the original concept from a program called !BuffStuff by Roland Cleaver.
{H11RELAX: All those non technically minded people can start reading again.
I would like to thank the following without whom this application would never have been written:
RISC User and in particular Lee Calcraft for his 'Mastering the Wimp' course
Roland Cleaver whose !BuffStuff application gave me the keyboard stuffing routines
{10Revision history
v1.00 - The first version, quite good even though I do say so myself.
v1.10 - Wow. Now you lucky people with RISCOS 3 should get solid drags. The caret is also removed from the window when Return is keyed.
v1.20 - Hot keys implemented. <Ctrl><Shift> f5 - f9 should do the job.
v1.30 - Lots of tidying up. The filename of a loaded file is now the default name in the save box. Arrow keys now move between the writable icons. If return is pressed data is marked as infirm and an asterisk is shown on the title bar. If you try to exit with infirm data you will be warned. Spaces can not be entered into the save box.
v1.31 - Sorted out a major bug that arose during the previous amendments.
v1.32 - Another horrendous bug fixed.
v1.33 - Another bug arising from v1.30 adjustments fixed. Full pathname is now put into the save icon when you load or save a file.
{11Upkeep
If you find any bugs in this program or feel that your superior programming skill could be brought to bear on some of my code then please write to me:
{CMatthew Hambley,
{C15, North Roundall,
{CLimekilns,
{CDunfermline,
{CFife, KY11 3JY.
So there you are. I hope you find this utility useful.
