                                MoreKeys   v0.06
                                ================
                                (module - v0.03)

Introduction
------------

This application provides a method of gaining easy access to accented keys
without learning the keyboard shortcuts.

In order to invoke MoreKeys, simply press a key that can be accented while
holding down Alt and Ctrl. When you do this, the keypress will be trapped and
a window opened to allow you to select an accent. You can use cursors and
Enter to choose character you want, or if you did this by mistake, just hit
Esc to insert the plain unaccented key.

MoreKeys has been designed to be as unobtrusive as possible, while providing
you the facilities that are useful with minimum fuss.


Alternative: I believe that cursor keys are the most convenient when you are
typing, however if you are the sort of person that prefers to reach for the
mouse for things such as this, then that's okay too. Simply click a character
to choose it, or alternatively right-click to cancel.

Note: For lots of boring technical excuses, multitasking is suspended while
      the MoreKeys window is open. For 99% of you that won't be a big deal,
      but keep this in mind if you run a server or somesuch in the background.



Available keys [Latin1, UK QWERTY or French AZERTY keyboard]
--------------

   a  ->       
   
   c  ->  
   
   e  ->     
   
   f  ->   
   
   i  ->     
   
   m  ->                   ['m' for "maths"]
   
   n  ->  
   
   o  ->        
   
   q  ->                     ['q' for "quotes"]
   
   s  ->                     ['s' for "symbols"]
   
   u  ->     
   
   w  ->  
   
   y  ->    
   
   #  ->                       [other "stuff"]
   
   .  -> as for '#'

Some emulator/netbook combinations may not want to pass on the Ctrl-Alt-#
keypress, therefore you may use Ctrl-Alt-. instead (or, if you prefer in any
case...).


There is also a Latin2 mapping for UK layout keyboards; a Latin1 for French
layout (AZERTY) keyboards, plus a UTF8 layout for UK layout keyboards (for
those wishing to experiment with UTF8 on RISC OS 5).



Version zero-point-something?
-----------------------------

Yup. v0.xx. Also known as alpha-test, or panties-ahoy, or oh-my-god-what-the-
-hell-dude or any number of other phrases (trust me, they just get worse).
Basically, this *should* work. But it might not. You're a guinea pig. Let me
know if it all blows up in your face...

When it has had a little more testing on a wider variety of systems and works
as expected, the version will increment to be v1.xx.
It's looking good so far! :-)

I'm looking for feedback from:

      1. Old RISC OS - anything running on ARM2 or ARM3
         [though MoreKeys will *NOT* work on Arthur or RISC OS 2].
      
      2. Genuine (not emulated) RiscPC running a recent version of RISC OS 4
         and/or RISC OS 6.
      


Limitations
-----------

Mappings are provided for:
  UK.Latin1
  UK.Latin2
  UK.UTF
  France.Latin1
Other countries (keyboard layouts) and alphabets (character sets) will need
to be created. In this case, MoreKeys will tell you so.



It just beeps at me!
--------------------

If MoreKeys beeps when you try to Ctrl-Alt-<letter>, this is because the
country and/or the alphabet has changed between the time MoreKeys started and
the present.

MoreKeys will attempt to load an appropriate mapping, but it may not have the
correct mapping available, or (less likely) the file may be damaged. In this
case you will hear a beep.

If MoreKeys was unable to locate an appropriate mapping, either at startup or
later, the system variable MoreKeys$Layout will be set to the mapping that
was expected, for example "Germany.Latin1".
The full path of the expected file is:
  "<MoreKeys$Dir>.mappings.<country>.<characterset>".
The layout/format of the mappings file is described in the UK.Latin1 file.


The internal module test software "TestMorKys" is included as an extra to aid
you in determining internal key codes. Simply press keys (with Ctrl and Alt),
note the key codes, and press ESC when you're done. That and a notepad are
much quicker than messing around with diagrams and tables...



OS support
----------

Written to be 32 bit neutral, so should work on everything (except Arthur and
RISC OS 2 ;-) ).


Tested on:  RedSquirrel and RISC OS 3.70     [ Rick               ]
            A real RiscPC with RISC OS 3.70  [ Rick               ]
            RPCEmu with RISC OS 5.19         [ Rick               ]
            
            RiscPC with RISC OS 4.02         [ B. Evans, csam     ]
            Iyonix with RISC OS 5.16         [ M. Durham, csam    ]
            ARMini with RISC OS 5.??         [ P. Young, csam     ]
            RiscPC with RISC OS 6.20         [ G. Baxendale, csam ]
            


Licence
-------

Copyright  2012 Rick Murray.

Free to use. Have fun.
