/usr/share/xemacs21/mule-packages/etc/mule-doc/README.Mule is in xemacs21-mulesupport 2009.02.17.dfsg.2-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 | 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
1993.6.14: Mule Ver.0.9.8 Beta
1993.8.1: Mule Ver.1.0 (KIRITSUBO) based on GNU Emacs 18.59
1994.2.8: Mule Ver.1.1 (HAHAKIGI) based on GNU Emacs 18.59
1994.8.6: Mule Ver.2.0 (UTSUSEMI) based on GNU Emacs 19.25
1994.11.2: Mule Ver.2.1 (YUUGAO) based on GNU Emacs 19.27
1994.12.28: Mule Ver.2.2 (WAKAMURASAKI) based on GNU Emacs 19.28
1995.7.24: Mule Ver.2.3 (SUETSUMUHANA) based on GNU Emacs 19.28
############################################################
0. INTRODUCTION
1. WHAT IS MULE
2. SUPPORTED LANGUAGES
3. SUPPORTED SYSTEMS
4. INSTALLATION
5. DOCUMENTS
6. DISTRIBUTION
7. NEWS GROUP AND MAILING LIST
8. MAIL SERVICE
9. MISC
############################################################
0. INTRODUCTION
This directory contains the distribution of Mule Ver.2.3.
Mule is free software distributed either as patches to GNU Emacs
(19.28) 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 2, 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, Thai (based on TIS620), Vietnamese (based on
VISCII and VSCII), Arabic, and Ethiopic are also supported.
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, mterm, 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 or later.
EGG system bundled with Mule can communicate with jserver of
Wnn and provide you a very convenient Japanese inputting
method. Read `EGG (mule)' node in Info 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 mterm 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, mlh, tcode (in 'contrib' directory)
2.2 CHINESE
It is strongly recommended to install Wnn4.108 or later.
EGG system bundled with Mule can communicate with cserver of
cWnn and provide you a very convenient Chinese (GB)
inputting method. Read `EGG (mule)' node in Info 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 mterm 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
Read `Quail (mule)' node in Info for the usage of this system.
Subscribers of alt.chinese.text and alt.chinese.text.big
will find it very useful to use GNUS (news reader written in
Emacs lisp) with gnusutil.el (bundled with Mule). It
encodes/decodes HZ/zW encoding or Big5 to/from Mule internal
code automatically.
2.3 KOREAN
Korean inputting method is provided by QUAIL system (bundled
with Mule). Read `Quail (mule)' node in Info for the usage
of this system. The name of quail-package for Hangul is
`hangul' or `handle3'. You can run Mule as a client of X
window, or run it under Hangul terminal or mterm 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)
Read `Quail (mule)' node in Info for the usage of this
system. As for Hebrew, right-to-left writing is supported.
Consult `R2L (mule)' in Info.
The `lisp/iso-*.el' files have not been modified yet for
this version of Mule. Please use quail system instead.
2.5 THAI
Thai support based on TIS620 character set. The inputting
method is also provided by QUAIL system (bundled with Mule).
Read `quail (mule)' node in Info 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.gz'. To use the font with 12x24 ASCII font,
you should increase upper line-space by a command line
argument of "-lsp". Specify "5+0" as the argument.
2.6 VIETNAMESE
Vietnamese support is based on two-table-VISCII methods,
which divide VISCII's code table into two, lower-case and
upper-case. Mule can read/write any of VISCII, VIQR, VSCII.
The inputting method is also provided by QUAIL system
(bundled with Mule). Read `Quail (mule)' node in Info for
the usage of this system. The name of quail-package for
Vietnamese is `viet'. For X, you can use both VISCII and
VSCII fonts. A free font for VISCII is available in
`fonts/ETL.tar.gz' which is designed suitable for the use
with other ETL fonts.
2.7 ARABIC
Arabic and Persian are supported, but it uses special code
and fonts proper to Mule. To read and write Arabic text,
you need three fonts: etl16-arabic0.bdf (Arabic digits),
etl16-arabic1.bdf (narrow characters) and etl16-arabic2.bdf
(wide characters). These fonts are available in
`fonts/ETL.tar.gz' which is designed suitable for the use
with other ETL fonts. Read `Mule/Languages/Arabic Script
Languages' node in Info for the usage of arabic-mode.
2.8 IPA (International Phonetic Alphabet)
A subset of IPA is available in Mule. You can use IPA
symbols by loading `lisp/quail/ipa.el'. The name of the
quail package for IPA is `ipa'. The file `fonts/ETL.tar.gz'
contains BDF files of IPA in 14, 16 and 24 dot. For the
usage of quail, read `Quail (mule)' node in Info.
2.9 ETHIOPIC
Ge'ez script (used in Ethiopic) is supported by the latest
release. Use Quail package `ethio' for inputting.
2.10 OTHER LANGUAGES
We are willing to support Devanagali as soon as we get
enough information on how they are supported in the other
softwares.
3. SUPPORTED SYSTEMS
Basically, Mule runs on any systems (and machines) on which
GNU Emacs runs. In addition, several systems (including
DOS, NT) are supported. See etc/MACHINES.
4. INSTALLATION
To install Mule, see INSTALL. Mule specific notices are surrounded by
lines <MULE> and </MULE>.
5. DOCUMENTS
For the moment, we have the following documents.
`etc' directory contains:
FAQ (for original GNU Emacs in English)
FAQ-NEW (new FAQ for original GNU Emacs in English)
FAQ-Mule (for Mule specific items in English)
FAQ-Mule.jp, FAQ-Mule.kr, FAQ-Mule.th
emacs.1 (man file for original GNU Emacs in English)
mule.1 (man file for Mule in English)
m2ps.1 (man file for m2ps -- Mule's text to PostScritp converter)
coco.1 (man file for coco -- Code converter)
`info' directory contains:
emacs (for original GNU Emacs in English)
mule (for Mule 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.
The file NEWFEATURE of the top directory 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 languages.
For Vietnamese, the Viet-Std Group has kindly translated
some of these documents. Those are under the directory
`doc/viet', but not updated..
6. DISTRIBUTION
Mule is available by anonymous ftp from:
Japanese sites:
etlport.etl.go.jp [192.31.197.99]:/pub/mule
Manager: Ken'ichi HANDA <handa@etl.go.jp>
ftp.mei.co.jp [202.13.88.131]: /archive/free/gnu/emacs/Mule
Manager: Motohide Murakami <murakami@msr.mei.co.jp>
ftp.iij.ad.jp [192.244.176.50]:/pub/misc/mule
Manager: Takamichi MIYOSHI <miyoshi@iij.ad.jp>
U.S. sites:
ftp.cs.buffalo.edu [128.205.32.9]:/pub/mule
Manager: Rafhael Cedeno <cedeno@cs.Buffalo.EDU>
Other foreign sites:
sh.wide.ad.jp [133.4.11.11]:/JAPAN/mule
Manager: Akira KATO <kato@wide.ad.jp>
ftp.funet.fi [128.214.248.6]:/index/mule
Manager: Hannu Aronsson <haa@ftp.funet.fi>
cs.huji.ac.il [132.65.16.10]:/pub/gnu/mule
Manager: The System Group <system@cs.huji.ac.il>
As for a mail service, read the section 8.
Either ftp the complete tar file (mule-2.3.tar.gz), *or* if
you have an unmodified GNU Emacs 19.28 you can ftp just the
patch file (diff-19.28-2.3.gz) and apply that. If you find
a patch with version number higher than 2.3, 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 more ftp sites. If you can kindly
provide this service, please send mail to
mule-request@etl.go.jp.
7. NEWS GROUP AND MAILING LIST
Mule's main discussion is done on the newsgroup
fj.editor.mule in Japanese. For those who can't subscribe
this newsgroup, we provide mail<->news gateway service.
Please send request of this service to mule-request@etl.go.jp.
For those who don't speak Japanese, we are running two
mailing lists:
mule@etl.go.jp (for general discussion)
mule-vn@etl.go.jp (for Vietnamese)
In both of them, main language is English, but you can
send/receive any multilingual text supported by mule.
Before sending mails to the above addresses, you should join
the corresponding mailing list. Please send requests of
subscribing/unsubscribing to:
mule-request@etl.go.jp
saying which mailing list you want to join.
We are willing to create mailing lists specific to the other
languages if there are many requests.
We are running one more mailing list to test new version of
Mule on various platforms before the official release:
mule-jp@etl.go.jp (main language: Japanese)
All mails to the above mailing lists are also sent to
the members of this mailing list.
8. MAIL SERVICE
You can get Mule by sending request to:
mule-by-mail@etl.go.jp
This system analyzes only the Subject field of a mail header.
The acceptable format of Subject is:
Subject: filename mail-address
send the specified file to <mail-address>,
The acceptable `filename' is one of the followings:
------------------------------------------------------------
diff-19.28-2.3 -- Patch for GNU Emacs 19.28, 36 files
diff-19.28-2.3.N -- Nth part of diff-19.28-2.3
-- N should be one of 01, 02 .. 36
patch-2.2.1 -- The 1st patch for Mule Ver.2.2.
ETL.tar -- Fonts for Laint1,Cyrillic,Greek,Thai,Viet..., 3 files
Chinese.tar -- Fonts for Chinese-GB (16/24) , 20 files
Japanese.tar -- Fonts for Japanese-JIS (14/16/24), 25 files
Korean.tar -- Fonts for Korean-KSC (16/24), 18 files
READMEDIR.tar -- Several documents about Mule, 3 files
lisp.tar -- Useful ELISP libraries in contrib directory, 5 files
HELP -- This message
------------------------------------------------------------
For instance, a mail with 'Subject: Chinese.tar me@etl.go.jp'
will send Chinese fonts divided into 20 files to <me@etl.go.jp>.
The description alters on version up of Mule. You'd better
check the correct format by requesting HELP.
------------------------------------------------------------
Russian or Ukrainian sites should ask mail service to
postmaster@ts.kiev.ua, or
nib@ts.kiev.ua,
however, as far as I know, their system is not yet
automated.
9. MISC
9.1 PRINTING UTILITY
To print various characters supported by Mule, we provide a
program `m2ps' which will be installed automatically while
installing mule (just as etags, emacsclient). `m2ps'
converts Mule's text (*internal* coding-system) to
PostScript by using BDF files for getting glyphs of
characters. For more detail, try "man m2ps". If you want
to print a file of other coding-system (e.g. *junet*),
please use `any2ps' which is a front-end of `coco' and
`m2ps' and can handle a text of any coding-system. Read the
first two lines of `any2ps' for the usage.
9.2 CODE CONVERSION LIBRARY
To convert any codes supported by Mule, we provide a program
`coco' which will be installed automatically while
installing mule (just as etags, emacsclient). For more
detail, try "man coco".
9.2 CODE TRANSLATION LIBRARY
Translate character code of Chinese letters among GB, JIS,
KSC, Big5, CNS. Not yet supported.
---
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>
Naoto TAKAHASHI Electrotechnical Lab., JAPAN. <ntakahas@etl.go.jp>
|