Building a new version of the International Module
==================================================

If you using !IKHG to build a new keyboard layout that does not currently
exist in the list of countries (do a *countries to find out), then you will
need to create a new version of the International module to define your
country as being a known one.

To do this you will need to alter the inter source supplied in the 'Inter'
directory.  The items that will need altering/adding will be as follows :-

Source file: InterBody

At line 764, a table of known countries is defined.  You will need to add
your country to this table.  This is done by adding the following line before
the line 'InterEntry    80,ISO1' :-

	InterEntry	99, MyCountry
	
Where '99' is the number of your country/territory and 'MyCountry' is the
name of your country.

At line 804, a table of strings for the country name are defined.  You will
need to at your country name to this table.  This is done by adding the
following line to the table before the line 'StringISO1   = "ISO1",0,80' :-

	StringMyCountry	=	"MyCountry",0,99
	
When assembled and loaded, the international module will now recognise your
country as being one of the standard ones and you can use !IKHG to build your
keyboard layout.  However, if your countries alphabet is one of the standard
RISC OS alphabets (such as Latin1,Latin2,Cyrillic etc...), then a further
table will need to be altered in the InterBody source file so that !IKHG will
recognise its alphabet properly (the table is altered so that a country to
alphabet conversion will work when Service_Internatinal4 is issued by !IKHG).

At line 642, another table is defined for responding to
Service_International4.  The table looks like the following :-

CToATable
        =       1,101, 2,100, 3,100, 4,101
        =       5,101, 6,101, 7,101, 8,101
        =       9,103, 10,107, 11,101, 12,101
        =       14,101, 15,101, 16,101
        =       17,101, 18,101, 19,101
        =       24,105, 25,120, 26,108
        =       27,101, 28,101
        =       80,101
        =       0
        ALIGN

The numbers in the table are in pairs of country number followed by alphabet
number.  You will need to add the following line to the table before the line
'=   80,101' :-

	=	99,101
	
Where 99 is your territory number and 101 is the alphabet number (101 is
alphabet Latin1 and this should be changed if you are not using this alphabet
- the list of alphabet number cans be found at line 791 of the source).

If you are not using one of the standard alphabets defined by RISC OS, then
you will need to add the following file inside !IKHG.

	- you will need to add a !IKHG.Letters.MyCountry file
	  to produce the necessary codes
	  
	- you will need to add a !IKHG.Source.Chars.MyCountry file
	  for assembling with your own alphabet characters
	  

Please note, that when building Inter you will need to copy the 'Tokenise'
program into your library directory and create a directory in the root called
'RM' to receive the module after it has been assembled.  You will also need
to click on 'SetPath' if the path 'Hdr:' is not already set by your system.
