INTRODUCTION

KANJIVIEW was written to allow the display of Japanese language
text on the IBM-PC. After English, Japanese is the most important
world language in many areas of knowledge. Therefore many non-Japanese
have learned to read Japanese. Throughout Japan stores sell books on
using the international electronic information services such as
Compuserve and GEnie. Increasingly Japanese are participating on these
networks. It is therefore natural that those of us on these networks
should communicate in Japanese as well English. However in the IBM-PC
world the only available program that allows reading Japanese language
electronic mail is a commercial word processor, EW+ by Information
Technology Laboratory, Inc., which has a list price of $650! So
Japanese language electronic mail has been beyond the reach of most
users of the standard IBM-PC family. It is my intent in writing
KANJIVIEW and releasing it in a this form, that the Japanese language
be available to as many users as possible throughout the world. In
particular, anyone with an IBM-PC, appropriate graphics card, modem,
and communication software should now be able to receive and display
Japanese language electronic mail.

KANJIVIEW may also be used for Japanese language education.
Teaching Japanese in Romaji is entirely inappropriate. Now lessons may
be written by a teacher with a Japanese language word processor,
transmitted to an IBM-PC, and then viewed by students with KANJIVIEW.

KANJIVIEW is copyrighted property of Steven W. Johnston (1988),
all rights reserved. The font that KANJIVIEW uses is also copyrighted
property of Steven W. Johnston (1988), all rights reserved. You are
granted a limited license to use KANJIVIEW, to distribute it, and to
copy it provided that KANJIVIEW is distributed in the original,
unmodified form.

You may not use KANJIVIEW in a governmental organization, school,
or a business without paying a registration fee. Site licences are
available with discounts for schools and businesses.

Individuals who find this program useful should please fill out
the registration form at the end of this manual. This registration fee
is very low and is used only to cover the cost of maintaining a mailing
list for people interested in Japanese language software for the
standard IBM-PC equipped with EGA/VGA/Hercules graphics. If there is
sufficient support for this program as shown by users registering, I
will write other programs for the IBM-PC family which will allow the
use of the Japanese language for word processing, telecommunication,
and education. Also this software will be extended to the EGA/VGA
graphics displays. Registered users of KANJIVIEW will be notified
immediately when such software is available. A likely place to find
the most current version of KANJIVIEW itself is the Far East languages
file library within the FLEFO (Foreign Language Education Forum) on
Compuserve.




HARDWARE AND SOFTWARE REQUIREMENTS

Version 1.0 of KANJIVIEW requires an IBM-PC family computer with a
Hercules graphics card and a monochrome monitor. If there are
sufficient user registrations and requests, I will extend this software
to EGA/VGA graphics also. It is recommended that KANJIVIEW be run from
a hard disk as the font file must be loaded each time KANJIVIEW is run.

KANJIVIEW may be run under MS-DOS version 2.0 or later. It may
also be run under real-mode OS/2. A minimum of 392 k of free memory
(402,000 bytes) is required to run KANJIVIEW due to the large font file
which must be loaded into memory. So users with large, memory resident
programs memory may need to run without those memory resident programs
present. You can determine the available free memory on your computer
with the DOS CHKDSK command.



USING KANJIVIEW

It is easy to use KANJIVIEW. The font file, KV.FNT, must be in
the default directory. Simply enter the following command:

KV filename -x

Here the filename is the actual name of the text file to be
viewed, which may include a path or drive specifier. "x" is an
optional file type specifier, either upper or lower case.

Valid file types include (1) "A" -- the ASCII file type, (2) "J" --
the JIS-C6226 file type, or (3) "S" -- the Shift-JIS file type. The
optional filetype specifier must be preceded by a dash, "-". If the
filetype is not specified, then KANJIVIEW will make an intelligent
guess at the file type. It is able to recognize the appropriate
filetype in most cases. "A" allows the user to view normal ASCII text
files. "J" allows the user to view the JIS-C6226 file type which is
popular on word processors in Japan. Finally, "S" shows the user a
Shift-JIS format text file, a text type popular with MS-DOS personal
computers in Japan. If KANJIVIEW guesses a wrong type when a filetype
is not supplied by the user, the text will typically be garbled,
containing many 8-bit ASCII characters. This is most likely to occur
in files containing only a small number of Kanji and Kana. If this
happens, simply try specifying a filetype explicitly.

The KANJIVIEW screen will appear. It will take a moment for the
font file to be loaded into memory. Then the text file is displayed.
The user may go up and down the document using the cursor keys. To exit
the program, the user simply touches either the Esc key or the "Q"
key. Control-C also takes the user back to DOS, but leaves the user in
the graphics mode, not the text mode.



The text file is displayed on pages 13 lines long consisting of 30
characters. Text that extends beyond 30 characters for a given line is
wrapped to the next line. A maximum of 12 pages may be shown in this
initial release of KANJIVIEW.



HOW TO RECEIVE JAPANESE LANGUAGE ELECTRONIC MAIL

I suggest that all Compuserve users with KANJIVIEW include the
phrase "Japanese Language" in their user profile for each Forum that
they participate in. That will make it easy for those who are literate
in Japanese to locate appropriate users to write to in each area of
interest. Ask that anyone sending you mail use a binary transfer
protocol such as XMODEM, KERMIT, etc. Simple ASCII transfers will have
the 8th bit stripped off of them, making any Japanese in them
unreadable with KANJIVIEW. Of course, to receive binary electronic
mail on your own computer, you must be using software with a binary
transfer protocol.

Correspondence from Japanese with personnel computers is typically
in the Shift-JIS format. However many Japanese use word processors
with special hardware that allows communication with the electronic
information services. Correspondence from this second group will often
be in the JIS-C6226 format. For most mail, KANJIVIEW will be able to
determine the correct format itself without the user having to guess.
There are additional JIS text formats, but Shift-JIS and JIS-C6226 are
most commonly used.

The author may be contacted on Compuserve as user #73300,517 and
on GEnie as user S.JOHNSTON2.




REGISTRATION INFORMATION

Registration licenses individuals to use KANJIVIEW on a regular
basis. This includes mailed notification of KANJIVIEW updates or other
new Japanese language software.

For schools, businesses, and government agencies each registration
is limited to use on a single computer. Site licences are available.

Send this registration form to:

Steven W. Johnston
10344 Kenlee Drive
Baton Rouge, Louisiana 70815 USA

Please indicate the registration type:

__________ Individual registration.......... @ $5.00 each $ _________

__________ Business or School registration.. @ $5.00 each $ _________

__________ Government Agency registration.. @ $10.00 each $ _________

For registrations orders placed from outside of the United States,
payment should be by either international bank draft or by
international postage coupons.

Please indicate which version number you have a copy of: __________

Please list your electronic mail address:

Compuserve User No.: ___________, GEnie User Name: ___________

Please list your postal mailing address:

Name: ___________________________________________________________

Address: ________________________________________________________

City: ________ State: _______ POSTAL CODE:_______ Country:______


Site licensing discounts are available for use of KANJIVIEW on an
unlimited number of machines within an organization. Write to the
above address for information.

WARNING: YOU ARE NOT ALLOWED TO USE THIS PROGRAM WITHIN A SCHOOL,
BUSINESS, OR GOVERNMENT INSTITUTION WITHOUT REGISTRATION OR A SITE
LICENCE.



TRADEMARKS

IBM-PC is a trademark of International Business Machines Corporation.

Hercules is a trademark of Hercules Computer Technology.

EW+ is a trademark of Information Technology Laboratory, Inc.

MS-DOS is a trademark of Microsoft Corporation.

-----------------------------------------------------------------------

SUGGESTED READING

Pasokon Tsuushin Nyuumon, by Hideyo Waki, published by Koodansha,
ISBN4-06-132626-0 C0255, 580 yen, is a simple introduction to the world
of personal computer communications in Japan. This book contains a
description of the common JIS text file types.

Pasokon Waapuro Kanji Jiten, by Tsutomu Uegaki, published by
Natsumesha, ISBN4-8163-0696-X C2054, 1800 yen, is the best dictionary
that I've seen yet in Japan for use with personal computers, essential
for word processing applications.

Kokusai Pasokon Tsuushin, a special collection of articles
published by ASCII, ISBN4-87148-110-7 C3055, 1200 yen, shows how
Japanese are able to access the international networks as well as how
you can access networks in Japan via Telenet.

If these books are not available at your local Japanese language
bookstore, I recommend that those in the USA order from Kinokuniya in
San Francisco. Typically when ordering Japanese language books from
within the USA, prices become about double the list price.