GPnese Japanese <=> English Dictionary                           June 5th, 2003
===============================================================================
                                     by Pawel Szymczykowski (pawel@makenai.net)

Description
-----------
This is a Japanese <=> English dictionary for the GamePark32 handheld. It is
based on the EDICT project's (http://www.csse.monash.edu.au/~jwb/edict.html) 
excellent dictionary data files. Currently, it maintains compatability with
the dictionary and index files that are used with Jim Breen's JDIC 
(http://www.csse.monash.edu.au/~jwb/jdic.html) program for MS-DOS, though
it is likely that I will switch to a proprietary format in the near future
in order to be able to load the latest version of the EDICT data into the
GamePark's 8mb of memory. At the moment, an older data file is being used
since the very latest version would require almost 7.5mb with index. Please 
see the included edict_doc.html for more on the EDICT project including 
licensing conditions and information on conventions used in the dictionary 
data.

Usage
-----
Simply put gpnese.fxe into your GP:/GPMM directory and copy the contents
of the GPNESE folder in this archive to GP:/GPMM/GPNESE.

After the dictionary has finished loading, you will be presented with a
virtual keyboard and an input box. You can switch between J=>E and 
E=>J lookup modes by pressing the WAEI (top-rightmost) and EIWA 
(middle-rightmost) keys respectively. You can also quickly toggle between 
these two modes by pressing the left shoulder button.

The Japanese input mode uses a form of hepburn romanization detailed in the
romaji_table.png file included in this archive. Please reference it if you
are unsure of how to enter a specific character sequence.

After you have typed in your Japanese or English search term, you will need
to press the SHIRABERU (bottom-rightmost) key on the keyboard or press the
right shoulder button on the GP32 to initiate the lookup. The results should
then pop up fairly quickly.

On the result screen, you may use the following keys:

B button              - return to lookup screen
Joystick up           - scroll results up one line
Joystick down         - scroll results down one line
Left shoulder button  - scroll results up one page
Right shoulder button - scroll results down one page
A + Left shoulder     - go to top of results
A + Right shoulder    - go to bottom of results

A maximum of 200 results will be return for any search term.

Todo
----
* The initial load time of the dictionary takes a long time - it would be nice
  to be able to start entering your term before the dictionary has finished
  loading.
  
* I plan to incorporate karthur's Quad-9 input system as an option in addition
  to the virtual QWERTY keyboard. This would allow one to input much faster.
  Learn more about Quad-9 from karthur's site: 
  http://www.f-labs.com/gp32/wind-ups/03.htm

* In addition to providing a dictionary data file, the EDICT project also
  encompasses a nice kanji dictionary which I plan to incorporate into
  GPnese eventually.

* The interface - I will spiff it up eventually with some nicer color 
  graphics. Right now everything is in monochrome bitmaps since XBM 
  files are easy to work with and I already had the monochrome blitting 
  functions written up for the font routines. It has kind of a nice
  oldschool X-Windows feel to it that I kind of like though.

* There are lots of other ways the dictionary data could be exploited.. 
  quizzes & kanji drills for study, a Japanese text reader with automatic 
  lookup etc. etc.
