HV and Japanese Web Pages
-------------------------

HV 2.2 and later supports Japanese Web pages, provided the proper font
drivers are loaded on your palmtop (see the article by Toshiki Sasabe
that follows further down in this document). Also make sure that all
fonts in the [Fonts] section of HV,CFG are set to the value "Medium" so
that the drivers can recognize the displayed fonts.

Unfortunately, there are three different encoding schemes for Japanese
text (EUC-JP, JIS, and SJIS). The only one of them that can be
recognised unambiguously is JIS (also known as ISO-2022-JP). It is not
possible to decide if two adjacent high ASCII in a text are in fact
two characters encoded, for example, in ISO Latin-1 or if the two
characters form a Japanese character. HV needs your help to make that
decision. In the Options menu, there is an item "Japanese Decoding" that
lets you choose from four different modes: "Western" decodes the text
without interpreting any characters as Japanese. "Automatic" tries an
intelligent guess of what it might be. "EUC-JP" interprets the text as
EUC-JP encoded and "SJIS" interprets the text as SJIS encoded. Note
that you have to reload the current page to apply a changed setting to
the page.

The default mode is to process pages as ISO Latin-1 (ISO 8859-1)
encoded pages. If you want to make any of the other modes the default, add
the line "Japanese=x" to the [SYSTEM] section of HV.CFG where x can be
one of the following 4 digits:

 0 Western (default)
 1 Automatic
 2 EUC-JP
 3 SJIS

The following article explains how to set up your palmtop for display
of Japanese text. Many thanks to Toshiki Sasabe for providing that text
and also for teaching me how Japanese text is encoded in Web pages and
for testing the new version of HV. He also provided the Japanese
translations of the documents within JAPANESE.ZIP. See README.TXT for
how to use them.

Andreas Garzotto, 17-Sep-98

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

               Display Japanese text on a HPLX Palmtop
                    (Minimum configuration)
                                          Toshiki Sasabe
                                          toshiki@j.email.ne.jp
                                          September 16, 1998

[1] How to set up

1. Add the following line to your CONFIG.SYS

  device=c:\bin\fontman.exe -b5 -fc:\bin\fontman.ini -d

  This line loads FONTMAN.EXE (Japanese font manager) with
  following options:
    -b buffer size. '-b5' is 5 KB.
    -f filespec for the initialization file, FONTMAN.INI in
       this example.
    -d disable direct RAM access.  (if you have the 100/200LX
       from early days, when 2MB RAM was the maximum, you can
       remove this option for faster access.  If you have
       relatively new HPLX, whose memory configuration is
       different, you should put this option).

2.Your fontman init file FONTMAN.INI should contain the
  following three lines:
  [fontx2]
  c:\font\akagi11k.fnt
  c:\font\akagi11a.fnt

  This tells FONTMAN.EXE to handle the FONTX2 format font files
  AKAGI11K.FNT and AKAGI11A.FNT placed in C:\FONT\ directory.

3.Add the following line to your autoexec.bat, before loading
  System Manager.

  c:\bin\dsp14a -s11 -k

  This line loads a display manager DSP14A.COM with -s11
  (use 11-dot height font) option.  '-k' tells to DSP14A that
  it should use Japanese single byte character set for high ASCII
  bytes (half-width Katakana, or DOS code page 932).

4.Reset the system by CTRL-ALT-DEL. Start System Manager. Open
  a Japanese text for a test.

  Note: If you are not always using Japanese language, you can
        enter "dsp14a -s11 -k" to load the display manager
        before running a Japanese application and enter "dsp14a
        -r" to remove it after the usage.

[2] Where to find the necessary files:

1. FONTMAN.EXE
   This font manager is created by MeW, the author of MaxDOS.
   The latest version (Version 1.2.9, 18-Nov-1994) is
   available at:
   ftp://ftp.vector.co.jp/pack/dos/util/machine/hp/japan/fman12a.lzh

2. AKAGI11K.FNT and AKAGI11A.FNT
   This beautiful Akagi Font, optimized for use on the LCD screen of
   the 100/200LX, is designed by Hiroyuki Kobayashi. The
   latest version (Ver 3, March 1996) is available at
   ftp://ftp.vector.co.jp/pack/data/writing/font/akagi300.lzh

3. DSP14A.COM
   This ia a patched version of DSP14.COM, a display manager
   created by Yoshihiro Hanaoka (Maruha), the author of EXkey.
   The latest version (Ver 0.02A, 1994) is available at:
   ftp://ftp.vector.co.jp/pack/dos/util/machine/hp/japan/dsp1402a.lzh

   After downloading the archive and extracting DSP14.COM,
   you should apply the patch (DS14TO11.PAT) as follows.
     (1) Place DS14TO11.PAT and DSP14.COM in the same
         directory.
     (2) Move to that directory with CD command.
     (3) Enter "debug dsp14.com < ds14to11.pat"
   This will create DSP14A.COM from DSP14.COM. (This patch
   changes the acceptable font height range (in dots) of '-s'
   option from "12,14,16" to "11,12,16".) This patch is created
   by Cyno and included in the document of Akagi Font.

==== DS14TO11.PAT ====
f 010d 012c 00
e 02ff 5d
m 02f7 030b 02f4
e 0309 41 90 90
e 0407 18
e 041e 5d
e 0421 18
m 0416 042a 0413
e 0428 41 90 90
e 056e 0b
f 06bd 06e4 00
e 06bd 00 01 01 00 01
n dsp14a.com
w
q
==== End DS14TO11.PAT ====

[3] Limitations

1. This procedure enables only the "display" of Japanese
   language.  The "entry" of Japanese words is a totally
   different story.

2. This FONTMAN/DSP14 method works only in System Manager
   applications. It works also in PAL applications, which uses
   system fonts.  It does not work on DOS applications.

