                                MoreKeys   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.



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. RiscPC running a recent version of RISC OS 4.
      
      3. RiscPC running RISC OS 6.
      


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

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

There is, currently, no support for UTF-8.



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.


Tested on:  RedSquirrel and RISC OS 3.70     [ check :-)        ]
            A real RiscPC with RISC OS 3.70  [ erm, todo...     ]
            RPCEmu with RISC OS 5.18         [ yup, this works! ]
            
            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   ]
            


Licence
-------

Copyright  2012 Rick Murray.

Free to use. Have fun.
