$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 Yasu Hiro YAMAZAKI ---------------------------------------------------------------------- ========================= 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 "JMETA-FAQ" by Tetsu Ono 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 Nozomi YTOW Kuniko MIKI Comments, suggestions, cheers or just greetings to the authours are quite welcome. They will be reaached at the following addresses: Hironobu ABE Yasu Hiro YAMAZAKI 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 |_______| `----||----'