                                    Ellipsis
                                    ========

Version 1.00 (11 Nov 1995)
Version 1.01 (12 Nov 1995)
     
Introduction
------------
I've found that when I work on the PC's in the Computer Lab there is no
easy way to enter the  character, and so I have to type ... and this annoys
me. What annoys me more is that when I come back to my A5000 I do the same,
even though my ExtraKeys module performs the same feat by Alt-.

However, if you use so wordprocessors on the PC you will see ... converted to
 automatically. Wouldn't that be nice on the Arc ? Yes ? Well here it is.

Ellipsis is the correct name for the  sequence, indicating that there is a
pause or that information has been omitted. So, in any application if you
type . three times whilst Ellipsis is installed you will find that it is
replaced by 

Usage
-----
   Run the !Create file. That's it.
   Hopefully, the code will be assembled with no errors and all that in
future will be required is the running of the !Run code file.

    
How it works
------------
The module intercepts the insert vector and traps inserts into the keyboard
buffer (single byte, not multiples) and counts . sequences, resetting to 0 on
any other press. Once the third . is received it is trapped and not passed on
to the main routine. Instead a OS_CallAfter routine is used to insert the
characters into the buffer. OS_CallAfter is set to 5cs intervals, so the
whole process takes around 15cs to perform. The actual sequence that is
inserted is Delete, Delete, Control code (meaning next character is literal,
not function key) then the ellipsis character.

Obviously, this may have strange effects on routines using . for some
specific task where no other key is used in between. However, I believe that
the benefits outway the costs.


Disclaimer
----------
  The author accepts no responsibility for any problems which this
application may cause or loss of data resulting in its use. This application
is Public Domain. This means that it may be distributed, so long as no charge
other than copying costs are charged for it.
  

Source code
-----------
   This program requires the !JFPatch pre-assembler to make the code. This is
a simple text-to-basic assembler which takes a text assembler file, makes a
basic program from it to assemble, assembles it and returns any errors.
Currently, it is under development and requires a lot of work before it will
be released in any form. As such, the patch file is mostly useless, but must
be distributed with the resultant module.
   All source code an the resultant module must be distributed together.


Contact
-------
Any comments, queries, donations or bug reports can be sent to Justin
Fletcher at :

E-Mail : Gerph@essex.ac.uk
URL    : http://users.essex.ac.uk/users/gerph
IRC    : On #Acorn as Gerph
Finger : finger jrflet@postman.essex.ac.uk
Tel    : (01842) 813979

Snail Mail :
    Justin Fletcher
    Galadriel
    17b Cromwell Road,
    Weeting,
    Brandon,
    Suffolk.
    IP27 0QT


History
-------
Version 1.00 : 11 Nov 1995
               First version written, inserting keys within the main routine.
               Crashed due to not setting SVC mode and storing link register.
               Would not work with Impression Style for obscure reasons.
               
Version 1.01 : 12 Nov 1995
               Recoded using CallEvery. Couldn't terminate calling, so
               used CallAfter instead.
               Setting SVC mode and stacking link crashed because r8 and r9
               were not restored.
               All bugs fixed, and works correctly with Impression Style.
