From: panya@sl.t.u-tokyo.ac.jp (Panyarak Ngamsritragul)
Subject: Mule : MULtilingual Enhancement to GNU Emacs
Organization: Sakai-Kamata Lab., Dept. of Mech. Eng., Univ. of Tokyo, Japan.
Date: Tue, 26 Jan 1993 02:33:20 GMT


Followed is a README.Mule distributed with Mule.  Those who are
interested in this software, please get it from the site as listed
below.  If you do not have GNU Emacs version 18.58 in your system,
you should first get the file INSTALL.Mule and read it.  If you
are going to install it and want it to support many languages,
then be sure you have approx. 20MBytes for it, and another
25 MBytes during installation.

------------- README.Mule --------------------------------------------
1989.12.15: Nemacs Ver.3.2.1 (MUSUME-DOUJOUJI version)
1989.12.17: Nemacs Ver.3.2.1A (MUSUME-DOUJOUJI version with ANCHIN patch)
1989.12.22: Nemacs Ver.3.2.3 (YUMENO-AWAYUKI version)
1990.3.3:   Nemacs Ver.3.3.1 (HINAMATSURI version)
1990.6.6:   Nemacs Ver.3.3.2 (FUJIMUSUME version)
1992.3.4:   Mule Ver.0.9.0 Beta
1992.3.23:  Mule Ver.0.9.1 Beta
1992.4.6:   Mule Ver.0.9.2 Beta
1992.4.18:  Mule Ver.0.9.3 Beta
1992.5.28:  Mule Ver.0.9.4 Beta
1992.7.31:  Mule Ver.0.9.5 Beta
1992.8.5:   Mule Ver.0.9.5.1 Beta
1992.10.27: Mule Ver.0.9.6 Beta
1992.12.28: Mule Ver.0.9.7 Beta
1993.1.22:  Mule Ver.0.9.7.1 Beta

############################################################
	0. INTRODUCTION
	1. WHAT IS MULE
	2. SUPPORTED LANGUAGES
	3. SUPPORTED SYSTEMS
	4. INSTALLATION
	5. DOCUMENTS
	6. DISTRIBUTION
	7. MAILING LIST
############################################################

0. INTRODUCTION

This directory contains the distribution of Mule Ver.0.9.7.1 beta.

Mule is free software distributed either as patches to GNU Emacs
(18.58) or as a complete tar file.  You can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 1, or (at
your option) any later version.

Mule is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to the Free
Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.


1. WHAT IS MULE?

Mule is a MULtilingual Enhancement to GNU Emacs.  It can
handle not only ASCII characters (7 bits) and ISO Latin-1 (8
bits), but also Japanese, Chinese, Korean (16 bits) coded in
the ISO2022 standard and its variants (e.g. EUC, Compound
Text).  For Chinese there is support for both GB and Big5.
In addition, now we provide new support for Thai based on
TIS620 which is non-ISO but quite popular in Thai.

A text buffer in Mule can contain a mixture of characters
from these languages.  To input any of these characters, you
can use various input methods provided by Mule itself.  In
addition, if you use Mule under some terminal emulator
(kterm, cxterm, or exterm), you can use any input methods
supported by the emulator.


2. SUPPORTED LANGUAGES

2.0 ENGLISH

Just type in. :-)

2.1 JAPANESE

It is strongly recommended to install Wnn4.108.  EGG system
bundled with Mule can communicate with jserver of Wnn and
provide you a very convenient Japanese inputting method.
See 'doc/EGG' for the usage of this system.
You can run Mule as a client of X window, or run it under
some Japanese terminal (including such emulators as kterm and
exterm).  In the latter case, you can use any inputting
methods supported by the terminal.
Among other inputting methods are:
	EGG-SJ3, CANNA (bundled with Mule)
	SKK, boiled-egg (in 'contrib' directory)

2.2 CHINESE

It is strongly recommended to install Wnn4.108.  EGG system
bundled with Mule can communicate with cserver of cWnn and
provide you a very convenient Chinese (GB) inputting method.
See 'doc/EGG' for the usage of this system.
You can run Mule as a client of X window, or run it under
some Chinese terminal (including such emulators as cxterm and
exterm).  In the latter case, you can use any inputting
methods supported by the terminal.

QUAIL system (bundled with Mule) also provides several
inputting methods for:
	GB: PINYIN, PINYIN_with_TONE, CCDOSPY, SW
	Big5: PINYIN, ETZY, ZOZY
See 'doc/QUAIL' for the usage of this system.

Subscribers of alt.chinese.text will find it very useful to
use GNUS (news reader written in Emacslisp) with hz2gb.el
(in 'contrib/lisp.tar.Z').  It encodes/decodes HZ/zW
encoding to/from Mule internal code automatically.

2.3 KOREAN

Korean inputting method is provided by QUAIL system (bundled
with Mule).  See 'doc/QUAIL' for the usage of this system.
You can run Mule as a client of X window, or run it under
Hangul terminal or exterm.

2.4 EUROPEAN

Many kinds of European character inputting methods are
provided by QUAIL system (bundled with Mule).  For the
moment, QUAIL provides inputting methods for:
	Latin1, Latin2,.. Latin5, Greek (ISO8859-7),
	Hebrew (ISO8859-8), Cyrillic (ISO8859-5)
See 'doc/QUAIL' for the usage of this system.
As for Hebrew, however, right-to-left writing is not yet
supported.  Please wait for the next version.

2.5 THAI

By the new facility of dynamic character composition, we can
now provide Thai support based on TIS620 character set.  The
inputting methods is also provided by QUAIL system (bundled
with Mule).  See 'doc/QUAIL' for the usage of this system.
The name of quail-package for Thai is 'thai'.  A free font
for TIS620 (12x29 dots) is also available in
'fonts/ETL.tar.Z'.  To use the font with 12x24 ASCII font,
you should increase upper linespace by the command
x-set-linespace or command line argument of "-lsp".  Specify
"5+" as the argument.

2.6 OTHER LANGUAGES

In the next version, we'll support Vietnamese.  Arabic and
Devanagali are also in our target, but we don't know if we
can support them by the next version.  We may need more
time.


3. SUPPORTED SYSTEMS

Basically, Mule runs on any systems (and machines) on which
GNU Emacs runs.  In addition, several systems (including
MS-DOS) are supported.  See etc/MACHINES.


4. INSTALLATION

To install Mule, see INSTALL.Mule.


5. DOCUMENTS

For the moment, we have the following documents.
'etc' directory contains:
	FAQ (for original GNU Emacs in English)
	FAQ.jp (for original GNU Emacs in Japanese)
	FAQ.Mule (for Mule in English)
	FAQ.Mule.jp (for Mule in Japanese)
	emacs.1 (man file for original GNU Emacs in English)
	mule.1 (man file for Mule in English)
'info' directory contains:
	emacs (for original GNU Emacs in English)
	mule-jp (for Mule in Japanese)
	egg-jp (for EGG in Japanese)
	canna-jp (for CANNA in Japanese)
You may also find various documents under 'doc' directory.
Especially, please refer 'doc/TERMINOLOGY' if you find
unknown terms.  Novice users may have to read 'doc/X11',
'doc/EGG', and 'doc/QUAIL'.

The file NEWFEATURE is also very important.

Since many of these documents (including this file) were
written by a non-native speaker of English (it's me), you
may find many curious expressions.  Please correct them.  In
addition, we are looking for volunteers who translate the
documents to Chinese, Korean, and the other langauges.


6. DISTRIBUTION

Mule is available by anonymous ftp from:

	etlport.etl.go.jp [192.31.197.99]:/pub/mule
		Manager: Ken'ichi HANDA <handa@etl.go.jp>
	sh.wide.ad.jp [133.4.11.11]:/JAPAN/mule/mule-0.9.7
		Manager: Akira KATO <kato@wide.sfc.keio.ac.jp>
	ftp.funet.fi [128.214.6.100]:/pub/gnu/emacs/mule
		Manager: Hannu Aronsson <haa@cs.hut.fi>

If you are accessing from out of Japan, please use the one
of the last two sites.  For Europeans, the last site is
probably the best.  Either ftp the complete tar file
(mule-0.9.7.tar.Z), *or* if you have an unmodified GNU Emacs
18.58 you can ftp just the patch file (diff-18.58-0.9.7.Z)
and apply that.  If you find a patch with version number
higher than 0.9.7 (e.g. diff-0.9.7-0.9.7.1.Z), apply that
also.

These directories contain several other useful files such as
X's fonts and contributed softwares.  See the file '00README'.

We are looking for ftp sites out of Japan.  If you can
kindly provide this service, please send mail to
handa@etl.go.jp.

If you can't get Mule by ftp, please send request to
mule-request@etl.go.jp.  We send you patches by mail.
Russian or Ukrainian sites may ask mail request to
	postmaster@ts.kiev.ua, or
	nib@ts.kiev.ua.


7. MAILING LIST

We are running two mailing lists:
	mule@etl.go.jp (main language: English)
	mule-jp@etl.go.jp (main language: Japanese)
All mails to mule@etl.go.jp are also sent to
mule-jp@etl.go.jp.

We ask everyone who gets Mule to join one of these
mailing-list.  Please send requests of
subscribing/unsubscribing to:
	mule-request@etl.go.jp
saying which mailing list you want to join.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Note that you can use other languages than 'main' on both
lists.  You can read/write any languages by Mule.

At last, we are deeply grateful to the current members of
mailing lists for their cooperation.

---
Ken'ichi HANDA  Electrotechnical Lab., JAPAN.  <handa@etl.go.jp>
Satoru TOMURA   Electrotechnical Lab., JAPAN.  <tomura@etl.go.jp>
Mikiko NISIKIMI Electrotechnical Lab., JAPAN.  <nisikimi@etl.go.jp>
Newsgroups: soc.culture.thai