           Help for !Wapuro, by Jason Williams
           ===================================

    This application allows you to enter Japanese script
 (either Hiragana or Katakana) by typing the appropriate
 Romaaji at the keyboard. It can be used in conjunction
 with ANY desktop application that can use the Japanese
 font set supplied with this program.

    To enter Japanese, click on the Wapuro icon (a capital
'A')- The 'A' will change to a hiragana 'a' character.
Also, a small window will appear showing the translation
buffer state (see below).

    Now, typing Romaaji syllables in lowercase or
uppercase will produce appropriate character(s) from the
hiragana or katakana character sets.
    Note that this will appear as a jumble of english
characters if you have not chosen a Japanese font to
display the text with!


    To enter English, click again on the Wapuro icon, and
it will change back to the capital 'A'. The translation
buffer state window will disappear while in English
mode.

    The Translation buffer state window (Which only
appears when in Romaaji mode) shows the characters
currently waiting to be translated from Romaaji to
Hiragana/Katakana. For example, if you type 'tsu', the
window will display the letters 't' and then 'ts' as you
type. As soon as you type the 'u', the complete Romaaji
syllable will be converted to Japanese characters and
sent to the current input focus application, and the
buffer display will become blank again.

    If you make a mistake while typing, you can clear
the buffer by clicking on the 'reset' button in the
state window.


Important notes:
    The romaaji syllable 'o' can be confused with
'(w)o', so you must type 'wo' whenever you want the
'(w)o' syllable rather than 'o'.

    A special case exists for the group of syllables na,
ni, nu, ne, no, and n. If you type an 'n', !Wapuro will
wait for you to type another character before it decides
whether it should output an 'n' or a 'na' etc. In most
cases, this works fine, but take care, and remember to
read the japanese that appears and check that it is
correct. In all cases, pressing SPACE or RETURN after
typing 'n' will cause an 'n' to be output.

    Four syllables have name clashes (two named 'ji',
and two name 'zu'). At present, !Wapuro matches input for
these syllables in the following way:
    ji  or  sji  :    ji  (as in shi")
    zu  or  szu  :    zu  (as in su")
    tji or  cji  :    ji  (as in chi")
    tzu          :    zu  (as in tsu")

Thus, to obtain a chi", you must type 'cji' or 'tji';
Typing only 'ji' will default to the wrong characters.

You can also obtain these characters by typing the base
syllable followed by an English double-quote mark, ".
e.g. In Romaaji mode, type:

    chi"

this will produce the chi form of ji (a chi character
followed by ").

