+;; -*- coding: utf-8; -*-
[README for SEMI kernel package (English Version)]
-by MORIOKA Tomohiko <morioka@jaist.ac.jp>
-$Id: README.en,v 1.1 1997-04-30 17:39:28 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.1 or later with mule, and Emacs/mule (mule
- merged EMACS; it will become Emacs 20.0).
+ SEMI supports XEmacs 21.1 or later, and GNU Emacs 20.4 or later.
- SEMI does not support EMACS 19.28 or later, XEmacs 19.14 or later,
- XEmacs 20.1 or later without mule, but SEMI may work with them.
+ SEMI does not support anything older than GNU Emacs 19.28 or XEmacs
+ 19.14. In addition, SEMI does not word with byte-indexing Mule
+ implementations, such as Mule 1, Mule 2 and GNU Emacs 20.1/20.2.
- If you use beta versions of XEmacs 20.1, please use the latest
- version and compile with mule support, i.e. use the configure flag
- `--with-mule'.
+ SEMI also does not support Emacs 19.29 to 19.34, XEmacs 19.15 or
+ XEmacs 20.2, but SEMI may work with them.
- If you use EMACS/mule, please use the latest version (GNU MULE
- 19.34.91-delta or later).
+ SEMI requires APEL (10.7 or later) and FLIM (1.14.2 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:
+ http://git.chise.org/elisp/dist/apel/
- ftp://ftp.jaist.ac.jp/pub/GNU/elisp/apel/
+ and FLIM package is available at:
- and MEL package is available at:
+ http://git.chise.org/elisp/dist/flim/flim-1.14/
- ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/libs/
- 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
+
+ % make install LISPDIR=~/share/emacs/lisp
+
+ If `LISPDIR=...' is omitted, site-lisp directory of the specified
+ 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/TM-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 ${archive}/README.en.
- To get started, please read semi/README.en.
+ RFC's 822, 1524, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 and
+ 2049 are available via anonymous ftp:
- RFC's 822, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 and 2049
- are available via anonymous ftp:
- ftp://ds.internic.net/rfc/
+ 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 Lists:
+
+ emacs-mime-en@lists.chise.org (English)
+ emacs-mime-ja@lists.chise.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, please see the descriptions of the following
+ pages:
+
+ http://lists.chise.org/mailman/listinfo/emacs-mime-en (English)
+ http://lists.chise.org/mailman/listinfo/emacs-mime-ja (Japanese)
+
+
+Git based development
+=====================
+
+ The SEMI development sources can be accessed via Git repository.
+ You can get the latest SEMI sources by the following:
+
+ % git clone http://git.chise.org/git/elisp/semi.git
+
+ Or you can view the SEMI repository via WWW at:
+
+ http://git.chise.org/gitweb/?p=elisp/semi.git
+
+ If you would like to join Git based development, please declare it
+ in the Emacs-MIME mailing list at first.
+
+ 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 tm bugs, obtain the latest release of
- tm, and discuss future enhancements to tm. 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>
projects / elisp / semi.git / blobdiff