Help file for !Sentence  Version 1.25 (12.1.97)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Luke Graham & Kiwi Software 1996


This program is designed to help young children who are learning sentence
construction.  They are able to drag one of a selection of words to the bar
at the bottom of the screen.  This word will then be incorporated into their
sentence.  When they are happy with their sentence they can then print it out 
by clicking on the printer icon.(no printer driver needed - yet).  If they
make a mistake then they can click on the rubber icon to 'rub out' that word. 
Clicking on the red cross icon will 'rub out' the whole sentence so that you 
can start again.  There is provision for an infinite number of sets of words
within Sentence. 

Sentence does NOT need all of the words in a list to be filled in.  Provided
the first word in a list is filled in, then that list can be used.  Any word
spaces which are not filled in will not be shown to the children.  This
provides and easy way of simplifing the layout of the program.

These sets of words can be easily created or changed by using the in-built 
word editing facilities.  These can be accessed by clicking the middle button
on the icon on the iconbar, and choosing edit from the menu.  You will then 
be asked to enter your teacher code.  The default code is TEACHER.  The 
program IS case sensitive.

The program will also speak the word when it is dragged down to the bar at
the bottom, if you choose it to in the options.  By clicking on the penguin 
you can get the program to speak your whole sentence.

You can click the mouse in your name icon, or the bottom bar  and you can 
then edit, delete or add any characters you want.  This allows you to add 
your own words directly to your sentence, without editing the word list.  It
also allows you to edit the sentence if it does not say quite what you want 
it to say.

By clicking on the green question mark icon you can get the program to add 
punctuation to your sentence for you.  The program should insert capital
letters itself at the start of the sentence and then after all subsequent 
full-stops, it should also convert a single 'i' to 'I'. (I hope...)

Please note that the punctuation icon (green question mark) can be disabled
in the options, should it get in the way - simply untick the 
 'show punctuation icon' in the 'Tool Icons' selection, and click on set.
If you wish the change to be permenant, then click on save.

This program supports Acorn's Interactive Help (!Help) which can be found on
the iconbar in the Apps directory of most machines.  I suggest you use this 
to give more complete help on the features of the program.


Machines supported (Techie stuff)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Sentence will work prefectly on machines with only 1MB of memory, as it
requires only 64K to run.

This program should work properly on ANY of the Acorn range of computers.  It 
has been tested very thoroughly on Risc OS 3.1 and 3.6 machines, and should
work properly on these machines.  Risc OS 3.5 should also be fine.

Machines with Risc OS 2 are also supported, but I have not been able to test 
this so thoroughly.  Also it may not look quite as designed.

Sentence has also been tested very, very briefly at the Acorn World show on a 
Strong Arm with Risc OS 3.7 and seems to work fine.  (Anybody who can afford 
a Strong Arm should definately send me a contribution as they have too much 
money.)

Please note that unless I am specifically told of several users, who are 
running Sentence on a Risc OS 2 machine, then new versions of Sentence may
no support Risc OS 2.  This is because it is becoming harder, and harder to
find Risc OS 2 machines to test on, sorry but that's the way it is...

Feel free to contact me should you experience any problems, try and send the
most complete details you can, including machine type, memory etc.
Also please try and get the problem repeatable as that you can say it
will happen everytime you do such-and-such.


I wish to thank...
~~~~~~~~~~~~~~~~~~
Robert Kendrick for his stupidity and programming knowledge.

Dominic Symes the author of Zap.  This is the program I used to write the 
code for this and I advise anyone who is interested in programming to get a 
copy.

MBUK (it's a Mountain Bike Magazine) for inspiration and Mint Sauce 
(the Sheep)


Boring Legal Message
~~~~~~~~~~~~~~~~~~~~
It wasn't me.  Nobody saw anything.  There aren't any witnesses and you can't
prove a thing.


The Speech module (Speech!) remains copyright  Superior Software at all 
times and I gratefully acknowledge their help in allowing me to use this 
module.

All other code remains within my Copyrights.  I maintain copyright on ALL
material supplied and reserve the right to change these conditions at any 
time and without notice.

This software is FreeWare.  That means that I own the copyrights.  Sentence may
be distributed, provided that ALL of the files are intact and complete.  It is
illegal to distribute this program in a modified or incomplete state.  It is 
also illegal to make any gain from this program.

This software is supplied "as is"; no warranty, express or implied, of the
merchantability of this software or its fitness for any particular purpose
is given. In no circumstances shall the author, or any provider or 
distributor of this software, be liable for any damage, loss of profits, or 
any indirect or consequential loss arising out of the use of this software or
inability to use this software, even if I have been previously advised of 
such a possibility.

If there are any legal problems then I am prepared to deny everything, up to 
and including my own existence...


What is Kiwi Software?
~~~~~~~~~~~~~~~~~~~~~~

Kiwi Software is a company name that myself (Luke Graham) and Robert Kendrick
write under.  If there is another Kiwi Software then we are not linked...

You may(?) have seen some of our software as there should be some around in
PD libraries

I have also written;

CrudDraw - several versions, a bad singletasking one, and a bad            
multi-tasking one, they  are meant to be bad by the way, I'm taking the
mickey out of Corel, maybe they will buy me, like they do to all their other   
competition....

Why II - My favourite program so far.  It is a coded disc protection program,
and it asks you to enter a code when you first look at a disc.  It can also be
used to lock the system when you wish to prevent your work being tampered with.

Sentence - This program, who's wonderful help file you are reading now.

Encrypt - Encrypts text files so they are totally unreadable trash, oh yeah
and decrypts them again.

Tips - A tip giving program like Windoze has.

Silly - Gives silly error messages from a text file at whatever time delay
you want.

Dustbin - Go on, guess what it does!

Convert - Converts between almost any related measurements - even things like
Parsecs to millimetres, and a number of Ancient Roman measurements just for
fun.

Obey2C - Converts obey files (like !Run files) to C source code.


PLEASE NOTE:- We are NOT from New Zealand, nor do we resemble small fruits...


Bugs/Contacting me
~~~~~~~~~~~~~~~~~~

There aren't any bugs that I am aware of - however...

If you find any bugs/problems with the software or have any features you 
would like to add then pleeeease contact me.  I will be VERY HAPPY to receive
any suggestions, bug reports, food, inflatible bananas, Red Dwarf videos, 
chocloate or monitary contributions for this program (ie. used fivers).

Contacting me;

I can be contacted at:

            Luke Graham
            48 HeatherStone Avenue
            Dibden Purlieu
            Southampton
            SO45 4LH
            
            
Additions since V 1.22 (5.12.96)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Since 1.22 I have added;

Nicer printing - which should be compatible with the Printer Manager
Icons with no word in them are not shown
Sentences to be printed are added to a print list - this is currently very
 simply written, at some point I will improve this...
The option to delete just one word list (as opposed to a whole group).  Lists
 are resructured afterwards to ensure that all exisiting lists are still used
More 'bullet-proof' handling of word groups, particularly when adding / 
 deleting lists or groups.


Future Stuff
~~~~~~~~~~~~

Included here is my current add list, the stars are an approximate indication
of how importantly I view that addition.  Someday I WILL add;

**make pretty - smiley face & patronising tunes etc

**Allow option to choose which list of words to load with.

*Make Word list editing scroll through all groups + lists...

**Reduce (or remove) repeat when pressing keys for name window

****make printout approx 20 point instead of 12... (maybe variable)

****Make print list nicer (and visible), so stuff can be deleted from it?

***Add solid dragging for words so U can see word...

***Allow option to change font (and size?) for printing and screen display

***Create menu with number of word lists in it for loading wordlists into
   edit section of program.  Update each time word group is changed.
   
**Implement a decent interactive help system within Sentence...

*Add Menu help to the !Help




That's All Folks..