[README for SEMI kernel package (English Version)]
-by MORIOKA Tomohiko <morioka@jaist.ac.jp>
-$Id: README.en,v 1.5 1998-02-12 11:12:41 morioka Exp $
What's SEMI?
-------------
+============
- SEMI is a library to provide MIME feature for GNU Emacs. It stands
- for "SEMI is Emacs MIME Interfaces". MIME is a proposed internet
- standard for including content and headers other than (ASCII) plain
- text in messages.
+ SEMI is a library to provide MIME feature for GNU Emacs. MIME is a
+ proposed internet standard for including content and headers other
+ than (ASCII) plain text in messages.
RFC 2045 : Internet Message Bodies
RFC 2046 : Media Types
SEMI has the following features:
- - MIME style multilingual header (RFC 2047)
- MIME message viewer (mime-view-mode) (RFC 2045 .. 2049)
- MIME message composer (mime-edit-mode) (RFC 2045 .. 2049)
- application/pgp (draft-kazu-pgp-mime-00.txt; obsolete)
- text/richtext (RFC 1521; obsolete; preview only)
- text/enriched (RFC 1896)
+ - External method configuration by mailcap (RFC 1524)
Notice that this package does not contain MIME extender for any
- MUAs and external methods. They are released as separated packages.
+ MUAs. They are released as separated packages.
Required environment
---------------------
+====================
SEMI supports XEmacs 20.2 or later with mule, and Emacs 20.
19.14. SEMI also does not support Emacs 19.29 to 19.34, XEmacs
19.15 or XEmacs 20.2 without mule, but SEMI may work with them.
- If you use Emacs 20, don't set `enable-multibyte-characters' to
- nil. (Maybe non mule setting requires to modify emu. In addition,
- it is better to use terminal-coding-system feature)
+ SEMI requires APEL (9.20 or later) and FLIM (1.13.1 or later)
+ package. Please install them before installing it. APEL package is
+ available at:
- SEMI requires APEL and MEL package. Please install them before
- installing it. APEL package
- is available at:
+ ftp://ftp.m17n.org/pub/mule/apel/
- ftp://ftp.jaist.ac.jp/pub/GNU/elisp/apel/
+ and FLIM package is available at:
- and MEL package is available at:
+ ftp://ftp.m17n.org/pub/mule/flim/flim-1.13/
- ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/libs/
+ PGP/MIME and application/pgp require mailcrypt or tiny-pgp package.
- Notice that latest version of XEmacs may have latest version of APEL
- and MEL, so you should not install them.
- PGP/MIME and application/pgp require mailcrypt or tiny-pgp package.
+Installation
+============
- The package enriched.el is required to compose text/enriched, so if
- you use Emacs anything 19.28 or older (including official version of
- MULE 2.3), WYSIWYG composing for text/enriched is not available.
+(a) run in expanded place
+ If you don't want to install other directories, please do only
+ following:
-Installation
-------------
+ % make
+
+ You can specify the emacs command name, for example
+
+ % make EMACS=xemacs
+
+ If `EMACS=...' is omitted, EMACS=emacs is used.
+
+(b) make install
+
+ If you want to install other directories, please do following:
% make install
/usr/local/share/emacs/19.34/site-lisp/ --- emu
/usr/local/share/emacs/site-lisp/apel/ --- APEL
- /usr/local/share/emacs/site-lisp/bitmap/ --- BITMAP-MULE
- /usr/local/share/emacs/site-lisp/mu/ --- MU
- /usr/local/share/emacs/site-lisp/mel/ --- MEL
+ /usr/local/share/emacs/site-lisp/flim/ --- FLIM
/usr/local/share/emacs/site-lisp/semi/ --- SEMI
You can specify site-lisp directory, for example
emacs command is used (perhaps /usr/local/share/emacs/site-lisp or
/usr/local/lib/xemacs/site-lisp).
+ If the emu modules (included in APEL package) have been installed in
+ the non-standard directory, you should specify where they will be
+ found, for example:
+
+ % make install VERSION_SPECIFIC_LISPDIR=~/elisp
+
+(c) install as a XEmacs package
+
+ If you want to install to XEmacs package directory, please do
+ following:
+
+ % make install-package
+
+ You can specify the emacs command name, for example
+
+ % make install-package XEMACS=xemacs-21
+
+ If `XEMACS=...' is omitted, XEMACS=xemacs is used.
+
+ You can specify the package directory, for example:
+
+ % make install PACKAGEDIR=~/.xemacs
+
+ If `PACKAGEDIR=...' is omitted, the first existing package
+ directory is used.
+
+ Notice that XEmacs package system requires XEmacs 21.0 or later.
+
+(a,b,c)
+
You can specify other optional settings by editing the file
- semi/SEMI-CFG. Please read semi/README.en and comments in
- semi/SEMI-CFG.
+ ${archive}/SEMI-CFG. Please read ${archive}/README.en and comments
+ in ${archive}/SEMI-CFG.
Initialization
---------------
+==============
(a) load-path
If you are using Emacs or Mule, please add directory of emu, apel,
- bitmap, mu, mel and semi to load-path. If you install by default
- setting, you can write subdirs.el for example:
+ flim and semi to load-path. If you install by default setting, you
+ can write subdirs.el for example:
--------------------------------------------------------------------
(normal-top-level-add-to-load-path
- '("apel" "bitmap" "mu" "mel" "semi"))
+ '("apel" "flim" "semi"))
--------------------------------------------------------------------
If you are using XEmacs, there are no need of setting about
Documentation
--------------
+=============
- To get started, please read semi/README.en.
+ To get started, please read ${archive}/README.en.
- RFC's 822, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 and 2049
- are available via anonymous ftp:
- ftp://ds.internic.net/rfc/
+ RFC's 822, 1524, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 and
+ 2049 are available via anonymous ftp:
+ ftp://ftp.merit.edu/internet/documents/rfc/
-Bug reports
------------
+
+Mailing lists
+=============
If you write bug-reports and/or suggestions for improvement, please
- send them to the tm Mailing List:
+ send them to the EMACS-MIME Mailing List:
+
+ emacs-mime-en@m17n.org (English)
+ emacs-mime-ja@m17n.org (Japanese)
+
+ Via the EMACS-MIME ML, you can report SEMI bugs, obtain the latest
+ release of SEMI, and discuss future enhancements to SEMI. To join
+ the EMACS-MIME ML, send an empty e-mail to
+
+ emacs-mime-en-ctl@m17n.org (English)
+ emacs-mime-ja-ctl@m17n.org (Japanese)
+
+ Notice that you should not send mail to author(s), such as
+ morioka@jaist.ac.jp, directly. Because your problem may occur in
+ other environments (if not, it might be your problem, not bug of
+ SEMI). We should discuss in the EMACS-MIME mailing lists. Anyway
+ direct-mail for authors might be ignored. Please send mail to the
+ EMACS-MIME mailing lists.
+
+
+CVS based development
+=====================
+
+ If you would like to join CVS based development, please send mail to
+
+ cvs@cvs.m17n.org
+
+ with your account name and your public key for ssh. cvsroot is
+ :ext:cvs@cvs.m17n.org:/cvs/root.
+
+ If you cannot use ssh, please send UNIX /etc/passwd style crypted
+ password. you can commit with the cvsroot
+ :pserver:<accountname>@cvs.m17n.org:/cvs/root.
+
+ We hope you will join the open development.
+
+
+Authors
+=======
+
+Original authors
- bug-tm-en@chamonix.jaist.ac.jp (English)
- bug-tm-ja@chamonix.jaist.ac.jp (Japanese)
+ MORIOKA Tomohiko <morioka@jaist.ac.jp>
+ (the author of mime-view and various parts of SEMI)
+ UMEDA Masanobu <umerin@mse.kyutech.ac.jp>
+ (the author of mime.el of emacs-mime-tools. mime.el is the
+ origin of mime-edit.el of SEMI)
- Via the tm ML, you can report SEMI bugs, obtain the latest release
- of SEMI, and discuss future enhancements to SEMI. To join the tm
- ML, send e-mail to
+Other authors
- tm-ja-admin@chamonix.jaist.ac.jp (Japanese)
- tm-en-admin@chamonix.jaist.ac.jp (English)
+ Shuhei KOBAYASHI <shuhei-k@jaist.ac.jp>
+ (a major author of signature.el and a lot of codes)
+ MASUTANI Yasuhiro <masutani@me.es.osaka-u.ac.jp>
+ (anonymous ftp codes of mime-play.el)
+ OKABE Yasuo <okabe@kudpc.kyoto-u.ac.jp>
+ (a major author of mime-partial.el and signature.el)
- Since the user registration is done manually, please write the mail
- body in human-recognizable language (^_^).
+ Steinar Bang <sb@metis.no>
+ Steven L. Baur <steve@miranova.com>
+ Kevin Broadey <KevinB@bartley.demon.co.uk>
+ Alastair Burt <burt@dfki.uni-kl.de>
+ Eric Ding <ericding@San-Jose.ate.slb.com>
+ Thierry Emery <Thierry.Emery@aar.alcatel-alsthom.fr>
+ Simon Josefsson <jas@pdc.kth.se>
+ Jens Lautenbacher <jtl@tkm.physik.uni-karlsruhe.de>
+ Carsten Leonhardt <leo@arioch.tng.oche.de>
+ Pekka Marjola <marjola@bilbo.ntc.nokia.com>
+ Hisashi Miyashita <himi@bird.scphys.kyoto-u.ac.jp>
+ Kazuhiro Ohta <ohta@ele.cst.nihon-u.ac.jp>
+ Alexandre Oliva <oliva@dcc.unicamp.br>
+ François Pinard <pinard@iro.umontreal.ca>
+ Artur Pioro <artur@flugor.if.uj.edu.pl>
+ Dan Rich <drich@morpheus.corp.sgi.com>
+ (contribute to evolve mime-image.el with XEmacs)
+ Katsumi Yamaoka <yamaoka@jpl.org>