Newsgroups: comp.os.linux.announce,comp.os.linux.admin
From: Yasuhiro Yamazaki <hiro@rainbow.physics.utoronto.ca>
Subject: Linux JE-HOWTO
Message-ID: <JE-HOWTO.1-8590.767303177@cs.cornell.edu>
Date: Mon, 25 Apr 1994 19:46:59 GMT
Approved: linux-announce@tc.cornell.edu (Matt Welsh)

Archive-name: linux/howto/japanese
Last-modified: 15 Apr 94

$Id: JE-HOWTO.english,v 1.10 1994/04/11 23:38:47 hiro Exp hiro $
----------JE-HOWTO(April 11 1994)--------JE-HOWTO(April 11 1994)----------

JE(Japanese Extensions)-HOWTO

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

  JE-HOWTO explains how to cope with JE, Japanese Extensions of Linux.
  This tells you what JE is, how to get info on it, how to obtain it 
  and how to install it. This is the first document to read for 
  complete novices who are interested in Japanese environments.

  This version deals with JE-0.9.3, and the latest issue should be 
  available as described in section B-0.

--

Authors:
      Hironobu ABE       <hironobu@ap.isl.melco.co.jp>
      Yasu Hiro YAMAZAKI <hiro@ice3.ori.u-tokyo.ac.jp>

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

========================= Table of Contents  =========================

  A. Introduction
     A-1: Concept
     A-2: Contents
     A-3: Requirements

  B. Sources of information
     B-0: The latest version of this document
     B-1: Network News
     B-2: Mailing List
     B-3: Installation Guide
     B-4: Feedback
     B-5: Other sources of information

  C. Getting JE
     C-1: Anonymous ftp
     C-2: CD-ROM

  D. Installation
     D-1: Procedure
     D-2: Tips

  E. Contents of each disk set
     E-0: Outline
     E-1: JE disk set
     E-2: j  disk set
     E-3: jd disk set
     E-4: jw disk set
     E-5: jc disk set
     E-6: js disk set
     E-7: jn disk set
     E-8: jt disk set
     E-9: jf disk set
     E-10: jx disk set
     E-11: jxsi disk set

  F. Future plan

  G. Legalese and miscellaneous

================================================================


A. Introduction
===============

A-1: Concept
------------
JE(Japanese Extensions for Linux) is a collection of free software for 
a standard distribution of the Linux system such as Slackware or SLS for 
the convenience of Japanese users. Each programme is ported or developed 
mostly by members of the Japanese Linux Mailing List, and is available as 
both pre-compiled binary and source codes, though the basic distribution 
only contains the binary. Although the binary is tar+gzip'ed like those 
in Slackware or SLS and could be installed by a standard installer such 
as pkgtool or sysinstall, JE has its own installer called "ezinst" which 
even does some basic configuration after the installation.

A-2: Contents
-------------
JE consists of software to display, input, edit, format, and print 
Japanese documents, as well as small but fancy made-in-Japan software.
For example, kon, kterm and pxvt display Japanese documents on console 
or in the X-window system. Wnn, Canna, and sj3 are what we call "Japanese
input methods" (or JIM) which convert an input string from standard 
keyboards into Japanese characters, words, phrases or symbols. Editors 
included are a Japanese vi clone, NEmacs (Nihongo [=Japanese] Emacs), 
and Mule (Multilingual Emacs). Japanese TeX system typesets beautiful or 
exotic(?) documents. Oneko is a cute mouse-cursor chaser for the X-window 
system. In addition, there are several programmes prepared to read/write 
electronic mail and news, to convert among character code sets, and to 
handle Japanese characters in command line under Linux. See section E for 
more details.

 Binaries in JE are made to handle the EUC-J character code set for 
electronic Japanese whenever choice is necessary at the time of 
compilation. This code set is most popular for UNIX workstations. Some 
software requires re-compilation to support SJIS, while others are 
run-time configurable. SJIS or Shift-JIS is the code set used by MS-DOS 
and other personal computers. JIS code set, yet another encoding, is 
widely used on the net to exchange Japanese information among computer 
systems. This is the only popular 7-bit code set with escape sequences,
and others assign a two-byte 8-bit code for each letter. It is supported 
by editors and network related software in JE. This diversity is due to 
historical reasons, and developers couldn't come up with a better 
solution to this issue. Note that "nkf" will detect and convert among 
these three popular code sets.

A-3: Requirements
-----------------
JE is designed to be installed over a standard distribution of Linux 
such as Slackware or SLS. The current version, JE-0.9.3, requires the 
shared library of libc-4.5.8 (SHARED_VERSION hereafter) or newer and 
libX-3.1.0 (XF_SHARED_VERSION) or greater, both of which are prepared 
in the JE1 disk set.

 Note that the current JE assumes you have a shadow password system, 
but this requirement is expected to be removed very soon.

B. How to get help
==================

B-0: New version of JE-HOWTO
-------------------------------
The latest version of JE-HOWTO should be available as a part of the 
latest JE distribution, and will also be posted on "fj.os.linux" and 
other newsgroups when it is updated.

B-1: Network News
-----------------
For general questions and discussions about JE, the use of "fj.os.linux",
a network newsgroup is recommended, if available. This newsgroup is rich 
in information on how to use JE effectively. Although almost all posts 
are in Japanese, those in other languages are quite welcome such as in 
English, Spanish, Germany, French, Korean and so on. There might be some 
detectives who *decipher* what you write. :) Chances of your getting 
replies would be greatest, however, if you post either in English or in 
Japanese.

B-2: Mailing List
-----------------
There is no mailing list specialized for JE at the moment. However, the
Japanese Linux Mailing List is very active for discussions on JE, and, 
actually, this ML is the mother of JE. In addition, you may get a beta 
version of JE by its occasional circulation in tapes or disk media. You 
can join Japanese Linux ML by sending e-mail as:

       # Mail linux@colias.tutics.tut.ac.jp
       X-Mn-Cmd: join

To obtain a brief guide about the ML, send e-mail to

       linux@colias.tutics.tut.ac.jp

with only "# guide" (without quotations) in its body.

 A Mailing List in English was just born. It is called jewel-ML,
"The Mailing List of JE for the World in the English Language".
The e-mail address is,

       jewel@colias.tutics.tut.ac.jp

and we, JE developers and coordinators, are waiting for you with a cup 
of coffee at hand. Please relax and join us.

B-3: Installation Guide
-----------------------
JE comes with "The Guide", an installation guide written in Japanese.
This explains the installation procedure step by step. Although the 
current version is somewhat outdated, it surely helps if you can read 
Japanese. There is no English edition, and your help in creating it is 
strongly desired by the whole world !
  
B-4: Feedback
-------------
Bug reports and suggestions should be posted on the newsgroup 
"fj.os.linux" to get the attention of people, if possible. Also, 
je@Roy.dsl.tutics.ac.jp is ready to accept those by e-mail. Jewel-ML, 
mentioned in B-2, is also available for those too shy to post an 
article to the public. 

 However, please don't send e-mail to the original developers of each 
programme in JE when you find a problem, because your problem may be 
due to our composer's faults and we don't want to bother the authors.

B-5: Other sources of information
---------------------------------
The following two documents are made public to explain Japanese Linux 
matters. Both are written in Japanese and, unfortunately, no English 
version is available.

They are in the jd disk set of JE, and periodically posted on
fj.os.linux and some BBSs in Japan.

  "Linux Jouhou memo" by Y. Hiro Yamazaki <hiro@ice3.ori.u-tokyo.ac.jp>
  "JMETA-FAQ" by Tetsu Ono <ono@eiehost.gee.kyoto-u.ac.jp>

 There is a book in English which will help you understand how the 
Japanese language is handled on computers, including the complicated 
issue of the character code sets.

    Understanding Japanese Information Processing
    Ken Lunde
    O'Reilly & Associates Inc
    ISBN 1-56592-043-0

You may find it easily, because the title is printed in large Kanjis.
  
C. Getting JE
=============

C-1: Anonymous ftp
------------------
JE is available at the following anonymous ftp sites in Japan as the binary 
distribution: (after JMETA-FAQ 1.28)

    colias.tutics.tut.ac.jp    133.15.144.11    /pub/linux/JE
    ftp.kuis.kyoto-u.ac.jp     130.54.20.1      /Linux/JE
    ftp.cs.keio.ac.jp          131.113.35.20    /pub/os/linux/Japanese/JE
    etlport.etl.go.jp          192.31.197.99    /pub/linux/JE
    ftp.huie.hokudai.ac.jp     133.50.16.80     /pub/system/Jlinux/JE
    ftp.is.titech.ac.jp        131.112.40.1     /pub/linux/JE
    ftp.ipc.chiba-u.ac.jp      133.82.241.128   /ftp.kyoto-u.ac.jp/.u6/JE
    ftp.pu-toyama.ac.jp        133.55.0.133     
                              /pub/ftpmail/ftp.kuis.kyoto-u.ac.jp/Linux/JE
    srawgw.sra.co.jp           133.137.4.3      /pub/os/linux/JE
    theta.iis.u-tokyo.ac.jp    157.82.96.67     /pub2/Linux/Japanese/JE
    wnoc-fuk.wide.ad.jp        133.4.14.3       /pub/Linux/JE
    turbo.te.chiba-u.ac.jp     133.82.181.125   /pub/Linux/JE
    ftp.astec.co.jp            133.147.2.254    /pub/Linux/JE
    ftp.hitachi-sk.co.jp       133.107.1.2      /pub/pds/linux/JE
    ftp.kddlabs.co.jp          192.26.91.15     /pub/os/linux/Japanese/JE

    "colias" is the source of JE. However, use of other sites is strongly
    recommended since the line to it is rather thin.

 The following sites outside Japan are known to mirror colias everyday:

    sunsite.unc.edu            152.2.22.81       /pub/Linux/distributions/je
    ftp.cdrom.com              192.153.46.2      /pub/linux/je

 Source codes are also available at the following sites:

    colias.tutics.tut.ac.jp    133.15.144.11  /pub/linux/je-sources
    ftp.kuis.kyoto-u.ac.jp     130.54.20.1    /Linux/JE-sources
    ftp.huie.hokudai.ac.jp     133.50.16.80   /pub/system/Jlinux/JE-sources
    theta.iis.u-tokyo.ac.jp    157.82.96.67   /pub2/Linux/je-sources
    ftp.iij.ad.jp              192.244.176.50 /pub/linux-j/JE-sources

 Linux patch is separated from its original if there is any. For example,

       oneko-1.1b.tar.Z            Original codes
       oneko-1.1b+lx.diff.gz       Linux patch

Apply the Linux patch with extension of "+lx" or "+je" after applying
others if any.

C-2: CD-ROM
-----------
JE is also available in CD-ROM:

       CD-ROM Shop Laser5
       Big Office Plaza, Suite 203
       2-652-8 Higashi Ikebukuro
       Toshima-ku,
       170 Tokyo Japan

       Phone: +81-3-5952-4639
       FAX:   +81-3-5952-7486

 This CD-ROM contains JE with its source codes as well as Slackware and 
SLS distributions. The organizers are active members of Japanese Linux ML 
and reflect the feedback from Japanese users quickly.

 Also available is "The best Linux plus FreeBSD CDROM ever" CD-ROM by
Trans-Ameritech.

       Trans-Ameritech
       2342A Walsh Avenue
       Santa Clara, CA 95051

       phone +1-408-727-3883
       FAX   +1-408-727-3882
       e-mail: roman@trans-ameritech.com


D. Installation
===============

D-1: Procedure
--------------
This section briefly explains the installation procedure of JE. Please
refer to "The Guide" for more information.

 The custom installer called "ezinst" is in the JE disk set of JE. Use 
"pkgtool" of Slackware or "sysinstall" of SLS in your system to install 
ezinst itself.


 (1)Prepare floppy disks of JE. Each disk set of JE should fit in a High 
   Density floppy disk, 5" or 3.5" 2HD. Note that this step is not 
   necessary if you install JE from HDD or CD-ROM, or via NFS.

 (2)Install JE1 using pkgtool of Slackware or sysinstall of SLS as:

        # pkgtool
    or,
        # sysinstall -doprompt -series JE

    Read the manpage of the installer if you don't want to install JE1
    from floppies.

  The JE1 disk contains the following packages:

    ezinst:   Easy installer for JE
    konbin:   KON to display Kanji on console
    konfnt:   Fonts for kon (the same as those for Minix/V)
    libc:     Linux standard shared libraries            [Optional]
    libx:     XFree86 shared libraries (English version) [Optional]

 Software in JE is compiled to use the standard shared libraries of 
SHARED_VERSION and XF86 shared libraries of XF_SHARED_VERSION, both of
which are defined in A-3. So, you need to install these, ONLY if you 
use older ones. "kon" is necessary if you don't have any software which
display Japanese and is supported by the curses, because "ezinst" speaks
Japanese. You might be able to use "-e" option to use it with English 
messages, though this option is in its beta stage.

 (3)Run your Japanese terminal software, such as "kon" for console:

        # kon

 You may use "kterm" if you already have one. Also, if your machine is 
J3100SX made by Toshiba Japan, you may use Kanji-term for J3100 as well 
as kon with j3100 option:

        # kon j3100sx

 (4)Start "ezinst".

    If you install JE from floppy disks:

        # ezinst -fd /dev/fd0

    To install from HDD, say from "/dos/JE":

        # ezinst -hd /dos/JE

    To install from "install/JE" directory of CD-ROM:

        # ezinst -cd install/JE

    To install via NFS from /linux/JE directory of a server Roy:

        # ezinst -nfs Roy:/linux/JE

 The installer uses "/mnt" as a temporary mount point of the floppy disks 
or CD-ROM. Thus, you need to "umount /mnt" if you already have something 
mounted on it, unless you install JE via NFS or from HDD.

 (5)Follow the instructions by ezinst to go on. ^^;

 Note that the next version of ezinst will be modified significantly to 
simplify the installation procedure.

D-2: Tips
---------
If you can't install JE successfully, try adding user "wnn" and invoke
ezinst again. You are facing the known problem of the current JE which 
requires a shadow password package in you Linux system. In this case, 
don't use software in JE such as "xklock" which requests your password. 
This problem will be fixed in the next release, and all software will be 
re-compiled without the shadow password library.

E. Contents of each disk set
============================

E-0: Outline
------------
The current JE consists of 44 disks, and they are divided into 11 disk 
sets, as in the following list.

    JE1: disk set to install JE easily                   1disk
    j? : nkf, lha, Emacs related packages                8disks
    jd?: Japanese documents mostly by JF project         1disk
    jw?: Wnn Input Method users' packages                3disks
    jc?: Canna Input Method users' packages              4disks
    js?: sj3 Input Method users' packages                3disks
    jn?: Network software such as mailers, newsreaders   2disks
    jt?: Japanese TeX packages                           2disks
    jf?: Font packages for TeX and XFree86              13disks
    jx?: XFree86 Japanese client packages                2disks
    jxsi?: XFree86j (X11R5 with Xsi extensions)          5disks

 The choice of Japanese input method depends mostly on your taste, and 
JE provides four of them though all you need is only one: SKK, Wnn, Canna, 
or sj3. The large size of JE is due to this diversity as well as numerous 
complicated characters in Japanese; count how many emacs' variants JE has! 
You can't install jw, jc and js all at the same time. In addition, the 
choice of emacs is more difficult. You need one of X or non-X version of 
emacs with the built-in interface for one of the input methods. Mule (multi-
lingual emacs) has more features than NEmacs(emacs for English and Japanese), 
but it takes more disk space. Here are some examples that might be helpful: 
Hiro, a desktop PC user, uses Canna-Mule on his X window system, while a 
notebook user prefers to use non-X NEmacs with SKK; they are both happy with 
their choices and have little reason to have more than one emacs. Anyway, 
once you make the major decisions, the installer will help you choose which 
packages to install, since it knows the dependency among packages to some 
extent.

E-1: JE disk set
----------------
The JE disk set, actually a JE1 disk, is compiled to help you install JE.
See section C-1 for the installation procedure.

    ezinst:   Easy installer for JE
    konbin:   Binary of KON to display Japanese on console
    konfnt:   Fonts for kon (the same as those for Minix/V)
    libc:     Linux standard shared libraries
    libx:     XFree86 shared libraries (English version)

 (1)ezinst is the installer for the rest of the JE distribution.
   It works on kon (Kanji on console) and other Japanese terminals.

 (2)libc and libx are shared libraries required by JE. JE-0.9.3 has
   libc.4.5.8 and libx.3.1.0. Don't install them if they are older
   than what you have in your system.

 (3)kon (kanji on console) in JE-0.9.3 is version 0.991b which displays
   Japanese characters on the console. The next version will be able to 
   show other languages and will be able to work even on a vacant virtual 
   console to save the number of login shells. Kon might be useful not 
   only for the installation but also for your daily work.

E-2: j disk set
---------------
    jbase:    lha, nkf, ed, jhd, pwd, ish. pf and other basic tools
    jless:    Japanese less (pager)
    pcurses:  Pelican's curses (for Japanese)
    jman:     Manpage system with Japanese nroff
    dic:      To consult a dictionary on CD-ROM
    recjis:   Tool to recover damaged Japanese document
    jelvis:   Japanese elvis (vi clone)
    ng:       Japanese Micro GNU Emacs
    nemsup:   NEmacs(Nihongo[=Japanese] Emacs) supporting files
    nemuty:   NEmacs utilities 
    nemlisp:  Lisp package for NEmacs
    mulelisp: Mule lisp package
    mulesup:  Mule supporting files
    muleuty:  Mule utilities
    muleskk:  SKK related lisp files for Mule
    nemskk:   SKK elisp for NEmacs
    skkbin:   SKK server binaries
    skkdic:   SKK dictionary
    skkman:   SKK manual
    bash:     Japanese bash  (mostly sh compatible)
    tcsh:     Japanese tcsh (csh compatible)
    zsh:      enhanced shell
    vnem:     NEmacs without input method support
    vmenx:    NEmacs without input method support for X
    vmule:    Mule without input method support
    vmulex:   Mule without input method support for X 
    jgsbin:   Japanese Ghostscript (binary)
    jgslib:   Japanese Ghostscript (library)
    jgsgnt1:  Fonts for Japanese Ghostscript (part 1)
    jgsfnt2:  Fonts for Japanese Ghostscript (part 2)

 (1)"jbase" is a package of basic tools: "lha" is an archiver widely used
    under MS-DOS especially in Japan, "pf" is a print tool for Japanese 
    line printers.
 
 (2)"jless" is a Japanese pager, which automatically judges the character
    code set in the document and converts it to display depending on the
    environment variable of LESSCHARSET which most Linuxers set as 
    "japanese-ujis" in Japan.

 (3)"pcurses" is a curses with a Japanese handling feature.

 (4)"jman" is a manpage system with Japanese nroff, which enables you to 
    look up the Japanese manpages.
 
 (5)"dic" looks up a dictionary in 8cm CD-ROM, widely available in Japan 
    for "Data Discman" made by SONY or for its compatibles.  Also included
    is an e-lisp code to call it from your emacs.

 (6)"recjis" will recover damaged Japanese documents encoded in JIS, SJIS, 
    or UJIS code set which might have lost some information through network 
    transfers or by other accidents.

 (7)"jelvis" is Japanese elvis(vi clone), while "ng" a subset of Japanese 
    Emacs. Use them with "uum", "canuum" or "kinput2" to input Japanese 
    characters.

 (8)"nemsup", "nemuty", and "nemlisp" are necessary to use NEmacs, the 
    Japanese Emacs. The current JE contains NEmacs-3.3.2 based on 
    emacs-18.59.

 (9)"mulelisp", "mulesup", and "muleuty" are necessary to use Mule, the
    Multi lingual Emacs. The JE-0.9.3 has Mule-1.0pl1 (KIRITSUBO version).

 (10)"skkbin", "skkdic", and "skkman" are SKK, a Japanese input method,
    accessible by Mule with "muleskk" or NEmacs with "nemskk". JE-0.9.3 
    comes with SKK-6.32.

 (11) "bash", "tcsh", and "zsh" are enhanced shells. "bash"(bash-1.13.5j)
    and "tcsh" will pass 8-bit Japanese characters.

 (12)"vnem" and "vnemx" are naked NEmacs based on emacs-18.59 without 
    support of any input method for the console and X respectively. You 
    don't have to install these if you decide to use either Wnn, Canna 
    or sj3.

 (13)"vmule" and "vmulex" are naked Mule-1.0pl1(KIRITSUBO version) without
    support of any input method for the console and X respectively. You 
    don't have to install these if you decide to use either Wnn, Canna 
    or sj3.

 (14)"jgsbin", "jgslib", "jgsgnt1", and "jgsfnt2" makes a Japanese 
    Ghostscript system which is an interpreter of Japanese PostScript,
    based on Ghostscript-2.6.1. The only allocated devices in JE binary
    kit are X window and VGA console. Run "gslx" script to use it on the 
    console. Note that older JE used to contain a version of gs which 
    required libsvga.so. Install libsvga.so.1 in Slackware of obtain new 
    JE, if you have this.

E-3: jd disk set
----------------
This is a collection of Japanese documents for Linux.

    jmemo: Linux Jouhou Memo (INFO-SHEET with Japan specific issues)
    jmeta: JMETA FAQ  (Japan Edition of META-FAQ, not translation)

 (1)"Linux Jouhou Memo" is a document explaining Linux to Japanese 
    beginners, which is based on "Linux INFO-SHEET" by Michael K. Johnson
    (johnsonm@stolaf.edu) translated into Japanese and modified by
    Yasu Hiro Yamazaki at the University of Toronto with additional 
    information.

 (2)"JMETA-FAQ" is written by Tetsu Ono at Kyoto University to help
   Japanese Linuxers to get Linux itself and related information.

 These authors are active in the Japanese Linux society, especially 
making better documents as a part of JF(Japanese FAQ) project, a 
Japanese version of LDP (Linux Documentation Project). Tetsu is the 
head of this project. Although this disk set currently consists of 
very a limited number of documents, it is expected to grow rapidly 
because JF has already made many more documents such as its original 
FAQ and translations of most HOWTOs with lots of help from Mr. Nakagome 
and other members. Contact one of the two authors above if you are 
interested in this project. Any help is more than welcome !


E-4: jw disk set
----------------
This disk set is necessary only if you decide to go with Wnn, which is 
the most popular Japanese input method.

    wnnbin:  Wnn4.109(binary)
    wnndic:  Wnn4.109(dictionary)
    wnnman:  Wnn4.109(manual)
    wnnprog: Wnn4.109(programmer's kit)
    ki2wnn:  kinput2 for Wnn users
    wnem:    NEmacs-3.3.2 with Wnn interface
    wnemx:   NEmacs-3.3.2 with Wnn interface for X window system
    wmule:   Mule-1.01 with Wnn interface
    wmulex:  Mule-1.01 with Wnn interface for X window system

 (1)"wnnbin", "wnndic", "wnnman", and "wnnprog" make Wnn-4.109, the most 
   popular Japanese Input Method on Unices, which enables you to input 
   Japanese words and phrases by regular keybaords such as English 101.

 (2)"ki2wnn" is kinput2-fix6 for Wnn users, which enables input of 
   Japanese characters into some Japanese applications.

 (3)"wnem" and "wnemx" are Japanese Emacs(NEmacs-3.3.2) with built-in
   support of Wnn for non-X and X environment respectively.

 (4)"wmule" and "wmulex" are Multilingual Emacs(Mule-1.01) with Wnn 
   support of Wnn for non-X and X environment respectively.

E-5: jc disk set
----------------
This disk set is necessary only if you decided to go with Canna. Canna 
is famous for its features and speed among Japanese input methods.

    canbin:  Canna2.2pl4(binary)
    canman:  Canna2.2pl4(manual)
    canprog: Canna2.2pl4(programmer's kit)
    candic:  Canna2.2pl4(dictionary)
    ki2can:  kinput2 for Canna users
    cnem:    NEmacs-3.3.2 with Canna interface
    cnemx:   NEmacs-3.3.2 with Canna interface for X
    cmule:   Mule-1.01 with Canna interface
    cmulex:  Mule-1.01 with Canna interface for the X window system

 (1)"canbin", "candic", "canman", and "canprog" make a Canna-2.2pl4 
   system, an Input Method with good features and speed, which converts 
   your input into Japanese.

 (2)"ki2can" is kinput2-fix6 for Canna users, which communicates with a 
   Canna server to input Japanese into your Japanese application.

 (3)"cnem" and "cnemx" are NEmacs-3.3.2 with a built-in interface to a
   Canna server for non-X and X environment respectively.

 (4)"cmule" and "cmulex" are Mule-1.01 with a Canna interface for
   non-X and X environment respectively.

E-6: js disk set
----------------
This disk set is necessary only for SKK users. This enables input of 
Japanese characters into some Japanese applications.

    sj3bin:  sj3(binary)
    sj3prog: sj3(programmer's kit)
    ki2sj3:  kinput2 for sj3 user
    snem:    NEmacs-3.3.2 with sj3 interface
    snemx:   NEmacs-3.3.2 with sj3 interface for X
    smule:   Mule-1.02 with sj3 interface
    smulex:  Mule-1.02 with sj3 interface for the X window system

 (1)"sj3bin", and "sj3prog" make the sj3 input method system.

 (2)"ki2sj3" is kinput2-fix6 for sj3 users.

 (3)"snem", and "snemx" are NEmacs-3.3.2 with built-in interface to sj3
   for non-X and X environment respectively.

 (4)"smule", and "smulex" are Mule-1.01 with sj3 interface for non-X and
   X environment respectively.

E-7: jn disk set
----------------
This is the collection of network related software.

    cf:       CF-3.2W4 (produces sendmail.cf)
    sendmail: sendmail-8.6.5 for Japanese networks
    mailx:    mailer (mail, Mail, rmail)
    mhlib:    MH-6.8jp2c (library)
    mhbin:    MH-6.8jp2c (binary)
    mhman:    MH-6.8jp2c (manual)
    nntpclt:  inews for NNTP
    cnn:      cnn-1.4.2 (news checker)
    ktin:     Japanese tin (newsreader)

 (1)"cf" helps to configure sendmail by producing sendmail.cf.

 (2)"sendmail" is the most popular mail transport in the Unix world.
   This binary has some extensions to use over the Japanese networks, 
   such as WIDE or TISN.

 (3)"mailx" is one of the most popular mailers among Linuxers.

 (4)"mhbin", "mhlib", and "mhman" make MH, a mail handling system with
   Japanese support.

 (5)"nntpclt" is Japanese inews, which enables the exchange of Japanese 
   e-mail.

 (6)"cnn" checks if there are new articles posted on you favourite 
   newsgroups via an NNTP connection.

 (7)"ktin" is a newsreader with Japanese support.

 Next JE is expected to contain "mnews".

E-8: jt disk set
----------------
This set contains all the necessary files for the TeX system except 
for fonts in the jf disk set, and xdvi in jx.

    bptexbin: PTeX (Japanese big TeX binary)
    bptexfmt: PTeX (Japanese big TeX format file)
    sptexbin: pTeX (Japanese TeX binary)
    sptexfmt: pTeX (Japanese TeX format file)
    ptexlib:  common resources for PTeX and pTeX
    jbibtex:  Japanese BibTeX
    dvi2tty:  DVI previewer for character terminals
    dviout:   DVI previewer for VGA consoles
    dviprt:   DVI printer driver
    fntuty:   TeX font utility

 (1)"bptexbin"+"bptexfmt" and "sptexbin"+"sptexfmt" are Japanese (big)
   TeX systems developed by ASCII, a Japanese publisher of computer books,
   naturally based on the famous TeX system. You have to install the PTeX 
   system only if you want to handle large documents, otherwise you should
   go with pTeX. These can handle both English and Japanese documents.

 (2)"ptexlib" is a package of common files of PTeX and pTeX systems.
 
 (3)"jbibtex" is Japanese BiBTeX.

 (4)"dvi2tty" is a DVI file previewer for character terminals.

 (5)"dviout" is a DVI previewer for VGA while "dviprt" is a printer 
   driver; both are ported from their DOS versions, which work under 
   non-X environments. They are based on version 2.39 of dviout/prt.

 (6)"fntuty" is a utility software to exchange formats among bitmap, PK, 
   and vector fonts.

 Note that DVI previewer for X environment is in the jx disk set for X
applications.

E-9: jf disk set
----------------
This disk set contains bitmap and vector fonts for Japanese TeX and the X 
window system. Note that Japanese PK fonts are NOT necessary if you decide 
to go with vector fonts.

    cmf118:   118dpi-PK Computer Modern font for TeX
    cmf180:   180dpi-PK Computer Modern font for TeX
    j118w98:  118dpi-PK Watanabe's jfonts for TeX
    j118w142: 118dpi-PK Watanabe's jfonts for TeX
    j118w204: 118dpi-PK Watanabe's jfonts for TeX
    j118w108: 118dpi-PK Watanabe's jfonts for TeX
    j118w129: 118dpi-PK Watanabe's jfonts for TeX
    j118w170: 118dpi-PK Watanabe's jfonts for TeX
    j118w118: 118dpi-PK Watanabe's jfonts for TeX
    j118w245: 118dpi-PK Watanabe's jfonts for TeX
    j118w294: 118dpi-PK Watanabe's jfonts for TeX
    j118wlnk: DNP fonts -> Watanabe's jfonts linkage
    asiya24:  Round Gothic PK font for dviout/prt
    hokuto24: Brush typeface PK font for dviout/prt
    kfonts:   other PK fonts for  dviout/prt
    vmincho1: Zeit vector font in Mincho (JIS level1 kanjis)
    vmincho2: Zeit vector font in Mincho (JIS level2 kanjis)
    vasiya1:  Zeit vector font in Round Gothic (JIS L1 kanjis)
    vasiya2:  Zeit vector font in Round Gothic (JIS L1 kanjis)
    vhokuto:  Zeit vector font in Brush typeface
    xfnt13:   13 dot alphabet and Kana font for X
    xfnt16:   16 dot Japanese fonts for X
    xfnt18:   18 dot Japanese fonts for X
    xfnt24:   24 dot Japanese fonts for X
    xfnt26:   26 dot Japanese fonts for X
    xmarufnt: Round typeface Japanese font for X

 (1)TeX requires Computer Modern fonts of "cmf118" or "cmf180" depending
   on the resolution of your printer. If other fonts with different 
   resolutions are required, you have to find them in the net or make 
   them by yourself using the Metafont system.

 (2)Most Japanese TeX systems also require DNP fonts designed by a printing 
   company called "Dai-Nippon Printing". Although you can buy DNP fonts for 
   TeX from them, free alternatives are available in JE as Watanabe's 
   jfonts, and Zeit compatible vector font sets. The authors recommend the
   use of vector fonts to save your disc space. In addition, if you have 
   better CPU than 386 SX, the use of the vector fonts results in better 
   speed, because it is faster to read smaller fonts from disks.

 (3)"asiya24", "hokuto24", and "kfonts" are PK (bitmap) fonts for dviout/prt.
   These are not necessary if you decide to use the vector font set.

 (4)"vmincho1/2", "vasiya1/2", and "vhokuto" are Zeit compatible vector
   fonts for TeX (dviout/prt, xdvi) and Japanese Ghostscript. You can buy 
   the original Zeit font from Zeit, a Japanese software vender, or you 
   can get free alternatives here in JE.

 (5)"xfnt??" and "xmarufnt" are Japanese fonts for the X-window system.
   Make sure to execute mkfontdir in /usr/lib/X11/fonts/misc after you 
   install any of them.

E-10: jx disk set
-----------------
This is a collection of X applications.

    fvwm:    small and good looking window manager (1.18d)
    k14:     the famous 14 dot Kanji fonts for X
    kterm:   kterm-5.2.0, xterm with Kanji support
    pxvt:    small terminal emulator for X, based on rxvt
    xldimg:  image file viewer for X
    oneko:   a cat chasing your mouse cursor
    libtk:   Tcl7.3Tk3.6jp (library)
    tkbin:   Tcl7.3Tk3.6jp (binary)
    tkdemo:  Tcl7.3Tk3.6jp (demo)
    tkman:   Tcl7.3Tk3.6jp (manual)
    xdvi:    DVI previewer with PK font support
    xdviz:   DVI previewer with Zeit vector font support
    gview:   ghostview-1.5 ( X interface for ghostscript)
    tgif:    tgif-2.13.2.j ( a draw tool with Japanese support)
    xfig:    xfig-2.0.pl9.j ( a draw tool with Japanese support)
    xklock:  screen lock with Kanji support

 (1)"fvwm" is a small and good looking window manager for X, and is
   getting popular. You can configure it into mwm-like mode.

 (2)"k14" is a set of Japanese fonts contributed to the X-window system.
   You may find it even in your English-only workstations in your office, 
   since it is in the core distribution of X.

 (3)"kterm" is a Kanji terminal emulator for X. It will be found in the 
   contrib directory of X.

 (4)"pxvt" is a small terminal emulator for X, based on rxvt.

 (5)"xldimg" is a viewer of image files such as those in GIF format.

 (6)"oneko" makes it easy to find your mouse cursor; a neko (a Japanese 
   word for cat) chases your mouse on your screen. You may make it a 
   dog chasing a bone.

 (7)"tkbin", "libtk", "tkdemo", and "tkman" make Japanese Tcl/Tk. This
   package helps to make software with a Graphical User Interface with
   Japanese messages.

 (8)"xdvi" and "xdviz" are DVI previewers for X. "xdviz" is compiled to
   use Zeit compatible vector fonts. See E-9 to decide which one to use.

 (9)"gview" is a user-friendly interface for Ghostscript.

 (10)"tgif" in JE is a drawing tool tgif with kinput2 interface to input 
   Japanese strings. It can handle EPS files as well as its proprietary 
   files.

 (11)"xfig" in JE is a drawing tool xfig with a Japanese patch.

 (12)"xklock" is a screen lock with Kanji support. It is currently 
    linked with shadow password libraries.

E-11: jxsi disk set
-------------------
This disk set contains internationalized XFree86-2.0 using the Xsi 
extension WITHOUT fonts.

    xfs3.tgz:     S3 server
    xfsvga.tgz:   SVGA server
    xfvga16.tgz:  VGA16 server
    xf8514.tgz:   8514 server
    xfmach32.tgz: Mach32 server
    xfmach8.tgz:  Mach8 server
    xfmono.tgz:   VGA Mono server
    xfprog.tgz:   programming kit
    xfbin.tgz:    basic clients
    xflib.tgz:    shared libraries and others
    xfxawk.tgz:   Xaw-i18n + Xawk2 + Xwchar

This disk set was made through the following steps.

    - Applied the latest patches to XFree86 source codes
    - Set Xsi, X_LOCALE, X_WCHAR and XML, and did "make World"
    - Merged Xawk2 and Xwchar into Xaw-i18n (xfxawk.tgz)

Xawk2 was chosen in order to use kinput2. This allows us to input 
Japanese characters into internationalized clients such as xcal-i18n 
with Canna or sj3. Xaw will be replaced by the internationalized 
version when you install "xfxawk.tgz".

"XFree86-j" is upper-compatible with its original, and even non-
internationalized clients will run without problem. Moreover, the 
binaries might improve your X system, because they have the latest 
patches applied. However, you need to install it over your X window 
system beause this package is NOT complete. Intensive testing has 
not yet been done, either.

A new version based on XFree86-2.1 is in its testing stage, and is 
expected to come with the next release of JE.

F. Future Plan
==============
We plan to improve the following aspects of JE.

 (1)More and better documentation:
   Works of JF members will be made available in the jd disk set. 
   Most major HOWTOs, Japanese FAQs and others are ready to come.

 (2)More varieties of Emacs:
   New emacs package with temacs is under development.

 (3)XFree86 with Ximp extensions:
   Some people prefer Ximp to Xsi, another implementation of 
   internationalized X.

 (4)Reform of fonts:
   /usr/share/fonts is the new candidate to store Japanese fonts.
   PK fonts for TeX might be removed from JE.

 (5)Evolution toward Multilingual Extensions:
   Give us your opinions ! JE developers are not specialists in all 
   languages.

JE was originally compiled as an extension of the SLS distribution of
Linux, but the developers are moving toward Slackware while keeping 
their eyes on the Debian package.

G.  Legalese and miscellaneous
===============================
Any trademark in this document is owned by its owner. This document is 
freely distributable, though it is copyrighted by the authors. However, 
please distribute the latest version available, whenever you do, and the 
authors will appreciate it very much if you let them know about your 
distribution. There is no warranty on any information in this document.  

 The authors express special thanks to the following people for their 
dedicated help.

                       Takashi MANABE <manaba@Roy.dsl.tutics.tut.ac.jp>
                          Nozomi YTOW <nozomi@yacca.cc.tsukuba.ac.jp>
                          Kuniko MIKI <kuniko@ori.u-tokyo.ac.jp>

 Comments, suggestions, cheers or just greetings to the authours are quite
welcome. They will be reaached at the following addresses:

      Hironobu ABE       <hironobu@ap.isl.melco.co.jp>

      Yasu Hiro YAMAZAKI <hiro@ice3.ori.u-tokyo.ac.jp>
      2696 Bloor St. W., Apt B3, Totonto Ontario, Canada M8X 1A5

----------JE-HOWTO(April 11 1994)--------JE-HOWTO(April 11 1994)----------

================================== Yasu Hiro Yamazaki   _______      _/\_
   /  /                   hiro@ice3.ori.u-tokyo.ac.jp  |   _   | _/\_>  <_/\_
  __ /  /  , \ , \   hiro@rainbow.physics.utoronto.ca  |  (_)  | >          <
_/ _/ _/ _/_<  __/ Dept. of Physics, Univ. of Toronto  |_______| `----||----'
