1
;; -*- coding: utf-8; -*-
2
[README for SEMI kernel package (English Version)]
7
SEMI is a library to provide MIME feature for GNU Emacs. MIME is a
8
proposed internet standard for including content and headers other
9
than (ASCII) plain text in messages.
11
RFC 2045 : Internet Message Bodies
12
RFC 2046 : Media Types
13
RFC 2047 : Message Header Extensions
14
RFC 2048 : MIME Registration Procedures
15
RFC 2049 : MIME Conformance
17
SEMI has the following features:
19
- MIME message viewer (mime-view-mode) (RFC 2045 .. 2049)
20
- MIME message composer (mime-edit-mode) (RFC 2045 .. 2049)
22
MIME message viewer and composer also support following features:
24
- filename handling by Content-Disposition field (RFC 1806)
25
- PGP/MIME security Multiparts (RFC 2015)
26
- application/pgp (draft-kazu-pgp-mime-00.txt; obsolete)
27
- text/richtext (RFC 1521; obsolete; preview only)
28
- text/enriched (RFC 1896)
29
- External method configuration by mailcap (RFC 1524)
31
Notice that this package does not contain MIME extender for any
32
MUAs. They are released as separated packages.
38
SEMI supports XEmacs 21.1 or later, and GNU Emacs 20.4 or later.
40
SEMI does not support anything older than GNU Emacs 19.28 or XEmacs
41
19.14. In addition, SEMI does not word with byte-indexing Mule
42
implementations, such as Mule 1, Mule 2 and GNU Emacs 20.1/20.2.
44
SEMI also does not support Emacs 19.29 to 19.34, XEmacs 19.15 or
45
XEmacs 20.2, but SEMI may work with them.
47
SEMI requires APEL (10.7 or later) and FLIM (1.14.2 or later)
48
package. Please install them before installing it. APEL package is
51
http://git.chise.org/elisp/dist/apel/
53
and FLIM package is available at:
55
http://git.chise.org/elisp/dist/flim/flim-1.14/
61
(a) run in expanded place
63
If you don't want to install other directories, please do only
68
You can specify the emacs command name, for example
72
If `EMACS=...' is omitted, EMACS=emacs is used.
76
If you want to install other directories, please do following:
80
You can specify the emacs command name, for example
82
% make install EMACS=xemacs
84
If `EMACS=...' is omitted, EMACS=emacs is used.
86
You can specify the prefix of the directory tree for Emacs Lisp
87
programs and shell scripts, for example:
89
% make install PREFIX=~/
91
If `PREFIX=...' is omitted, the prefix of the directory tree of the
92
specified emacs command is used (perhaps /usr/local).
94
For example, if PREFIX=/usr/local and EMACS 19.34 is specified, it
95
will create the following directory tree:
97
/usr/local/share/emacs/19.34/site-lisp/ --- emu
98
/usr/local/share/emacs/site-lisp/apel/ --- APEL
99
/usr/local/share/emacs/site-lisp/flim/ --- FLIM
100
/usr/local/share/emacs/site-lisp/semi/ --- SEMI
102
You can specify site-lisp directory, for example
104
% make install LISPDIR=~/share/emacs/lisp
106
If `LISPDIR=...' is omitted, site-lisp directory of the specified
107
emacs command is used (perhaps /usr/local/share/emacs/site-lisp or
108
/usr/local/lib/xemacs/site-lisp).
110
If the emu modules (included in APEL package) have been installed in
111
the non-standard directory, you should specify where they will be
114
% make install VERSION_SPECIFIC_LISPDIR=~/elisp
116
(c) install as a XEmacs package
118
If you want to install to XEmacs package directory, please do
121
% make install-package
123
You can specify the emacs command name, for example
125
% make install-package XEMACS=xemacs-21
127
If `XEMACS=...' is omitted, XEMACS=xemacs is used.
129
You can specify the package directory, for example:
131
% make install PACKAGEDIR=~/.xemacs
133
If `PACKAGEDIR=...' is omitted, the first existing package
136
Notice that XEmacs package system requires XEmacs 21.0 or later.
140
You can specify other optional settings by editing the file
141
${archive}/SEMI-CFG. Please read ${archive}/README.en and comments
142
in ${archive}/SEMI-CFG.
150
If you are using Emacs or Mule, please add directory of emu, apel,
151
flim and semi to load-path. If you install by default setting, you
152
can write subdirs.el for example:
154
--------------------------------------------------------------------
155
(normal-top-level-add-to-load-path
156
'("apel" "flim" "semi"))
157
--------------------------------------------------------------------
159
If you are using XEmacs, there are no need of setting about
164
Please insert the following into your ~/.emacs:
172
To get started, please read ${archive}/README.en.
174
RFC's 822, 1524, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 and
175
2049 are available via anonymous ftp:
177
ftp://ftp.merit.edu/internet/documents/rfc/
183
If you write bug-reports and/or suggestions for improvement, please
184
send them to the Emacs-MIME Mailing Lists:
186
emacs-mime-en@lists.chise.org (English)
187
emacs-mime-ja@lists.chise.org (Japanese)
189
Via the Emacs-MIME ML, you can report SEMI bugs, obtain the latest
190
release of SEMI, and discuss future enhancements to SEMI. To join
191
the Emacs-MIME ML, please see the descriptions of the following
194
http://lists.chise.org/mailman/listinfo/emacs-mime-en (English)
195
http://lists.chise.org/mailman/listinfo/emacs-mime-ja (Japanese)
198
Git based development
199
=====================
201
The SEMI development sources can be accessed via Git repository.
202
You can get the latest SEMI sources by the following:
204
% git clone http://git.chise.org/git/elisp/semi.git
206
Or you can view the SEMI repository via WWW at:
208
http://git.chise.org/gitweb/?p=elisp/semi.git
210
If you would like to join Git based development, please declare it
211
in the Emacs-MIME mailing list at first.
213
We hope you will join the open development.
221
MORIOKA Tomohiko <morioka@jaist.ac.jp>
222
(the author of mime-view and various parts of SEMI)
223
UMEDA Masanobu <umerin@mse.kyutech.ac.jp>
224
(the author of mime.el of emacs-mime-tools. mime.el is the
225
origin of mime-edit.el of SEMI)
229
Shuhei KOBAYASHI <shuhei-k@jaist.ac.jp>
230
(a major author of signature.el and a lot of codes)
231
MASUTANI Yasuhiro <masutani@me.es.osaka-u.ac.jp>
232
(anonymous ftp codes of mime-play.el)
233
OKABE Yasuo <okabe@kudpc.kyoto-u.ac.jp>
234
(a major author of mime-partial.el and signature.el)
236
Steinar Bang <sb@metis.no>
237
Steven L. Baur <steve@miranova.com>
238
Kevin Broadey <KevinB@bartley.demon.co.uk>
239
Alastair Burt <burt@dfki.uni-kl.de>
240
Eric Ding <ericding@San-Jose.ate.slb.com>
241
Thierry Emery <Thierry.Emery@aar.alcatel-alsthom.fr>
242
Simon Josefsson <jas@pdc.kth.se>
243
Jens Lautenbacher <jtl@tkm.physik.uni-karlsruhe.de>
244
Carsten Leonhardt <leo@arioch.tng.oche.de>
245
Pekka Marjola <marjola@bilbo.ntc.nokia.com>
246
Hisashi Miyashita <himi@bird.scphys.kyoto-u.ac.jp>
247
Kazuhiro Ohta <ohta@ele.cst.nihon-u.ac.jp>
248
Alexandre Oliva <oliva@dcc.unicamp.br>
249
François Pinard <pinard@iro.umontreal.ca>
250
Artur Pioro <artur@flugor.if.uj.edu.pl>
251
Dan Rich <drich@morpheus.corp.sgi.com>
252
(contribute to evolve mime-image.el with XEmacs)
253
Katsumi Yamaoka <yamaoka@jpl.org>