***************
* KANJI BUNKA *
***************

Version 1.01 for DOS.
Christophe Verre. http://perso.libertysurf.fr/kurikuri/


-== INFORMATION IN SECTION 4 ARE REALLY IMPORTANT ==- 


1. What's all this ?
--------------------

A little program to learn japanese characters called kanji.

2. Installation
---------------

-> Uncompress all files in a directory
-> You should be able to run the program right away.


Content:

CWSDPMI.EXE : dpmi mode for DOS
KANJI.EXE   : the main program
KANJI.INI   : initialization file
KLISTE.JIS  : JIS file containing the list of kanji
README.TXT  : this file


3. Setup
--------

You will probably have to edit the KANJI.INI file :

-> First    : first kanji from KLISTE.JIS to learn
-> Last     : last kanji from KLISTE.JIS to learn
-> Random   : randomize the display of your list
-> Font	    : font to use to display the current kanji
-> Kanji    : display the main kanji or not
-> On       : display onyomi or not
-> Kun      : display kunyomi or not
-> Meanings : display meanings or not
-> Font Directory : 24x24 and 48x48 bitmap font directory.
-> IntroScreen : display the splash screen or not
-> keepErrors  : memorize errors or not
-> errorColour : color of the wrong kanji
-> saveErrors  : store errors in a file

There are two font files you can use : k48x48.f00 and k24x24.f00.
I recommend the 48x48 font. 

4. WARNING
----------

You need two files called KIJIS16.FNT and KINFO.DAT. The first one is a 16x16 bitmap font file. The second keeps information about kanji (onyomi, kunyomi, meanings...). Without those two, you won't be able to make the program run. You can find them at http://ftp.cc.monash.edu.au/pub/nihongo/00INDEX.html.


5. HOW-TO USE
-------------

First, create a list of the kanji you want to study. Save it in a file called KLISTE.JIS. This must be JIS encoding. Only kanji must be in this file, otherwise everything will go wrong ! (see BUGS). I've included a sample of this file in the archive.

Then, you may run the program. It's a DOS program, meaning that it may have unpredictable behaviour under Windows. I've had no problem using it under Windows 98, but minimizing it IS a wrong idea :) It doesn't seem to work at all under Windows 2000.
I intend to make a Windows port as soon as possible.

The following keys are used :

F1  : Show Help
F2  : Error Mode On/Off
ESC : Exit
Any other key : Show Answer/Display Next Kanji

In Error Mode:

r : right answer
w : wrong answer
F3 : save errors On/Off


6. Error Mode
-------------

Entering error mode will send wrong answers to the error bar at the top of the screen. For each flashcard, you will have
to tell whether your answer is right ('r' key) or wrong ('w' key). You may save your errors to a file. If you rename this file KLISTE.JIS, you can use it to study your errors.

I never use this mode, so it's a bit basic.


7. WHAT'S NEW
-------------

v1.01 : Added F4 for snapshot (dump.bmp)

v1.00 : First Release


8. BUGS
-------

Many bugs for sure. Don't have time to fix anything at the moment.

- Input strange things in Kanji.ini and it will probably crash
- Don't put spaces between the name and value in Kanji.ini or it may crash
- Using a list file which doesn't use only kanji will probably display strange things
- Not Windows friendly at all !


Send me your comments or suggestions at christophe.verre1@libertysurf.fr
