1 [README for SEMI kernel package (English Version)]
6 SEMI is a library to provide MIME feature for GNU Emacs. MIME is a
7 proposed internet standard for including content and headers other
8 than (ASCII) plain text in messages.
10 RFC 2045 : Internet Message Bodies
11 RFC 2046 : Media Types
12 RFC 2047 : Message Header Extensions
13 RFC 2048 : MIME Registration Procedures
14 RFC 2049 : MIME Conformance
16 SEMI has the following features:
18 - MIME message viewer (mime-view-mode) (RFC 2045 .. 2049)
19 - MIME message composer (mime-edit-mode) (RFC 2045 .. 2049)
21 MIME message viewer and composer also support following features:
23 - filename handling by Content-Disposition field (RFC 1806)
24 - PGP/MIME security Multiparts (RFC 2015)
25 - application/pgp (draft-kazu-pgp-mime-00.txt; obsolete)
26 - text/richtext (RFC 1521; obsolete; preview only)
27 - text/enriched (RFC 1896)
28 - External method configuration by mailcap (RFC 1524)
30 Notice that this package does not contain MIME extender for any
31 MUAs. They are released as separated packages.
37 SEMI supports XEmacs 21.1 or later, and GNU Emacs 20.4 or later.
39 SEMI does not support anything older than GNU Emacs 19.28 or XEmacs
40 19.14. In addition, SEMI does not word with byte-indexing Mule
41 implementations, such as Mule 1, Mule 2 and GNU Emacs 20.1/20.2.
43 SEMI also does not support Emacs 19.29 to 19.34, XEmacs 19.15 or
44 XEmacs 20.2, but SEMI may work with them.
46 SEMI requires APEL (10.7 or later) and FLIM (1.14.2 or later)
47 package. Please install them before installing it. APEL package is
50 http://git.chise.org/elisp/dist/apel/
52 and FLIM package is available at:
54 http://git.chise.org/elisp/dist/flim/flim-1.14/
60 (a) run in expanded place
62 If you don't want to install other directories, please do only
67 You can specify the emacs command name, for example
71 If `EMACS=...' is omitted, EMACS=emacs is used.
75 If you want to install other directories, please do following:
79 You can specify the emacs command name, for example
81 % make install EMACS=xemacs
83 If `EMACS=...' is omitted, EMACS=emacs is used.
85 You can specify the prefix of the directory tree for Emacs Lisp
86 programs and shell scripts, for example:
88 % make install PREFIX=~/
90 If `PREFIX=...' is omitted, the prefix of the directory tree of the
91 specified emacs command is used (perhaps /usr/local).
93 For example, if PREFIX=/usr/local and EMACS 19.34 is specified, it
94 will create the following directory tree:
96 /usr/local/share/emacs/19.34/site-lisp/ --- emu
97 /usr/local/share/emacs/site-lisp/apel/ --- APEL
98 /usr/local/share/emacs/site-lisp/flim/ --- FLIM
99 /usr/local/share/emacs/site-lisp/semi/ --- SEMI
101 You can specify site-lisp directory, for example
103 % make install LISPDIR=~/share/emacs/lisp
105 If `LISPDIR=...' is omitted, site-lisp directory of the specified
106 emacs command is used (perhaps /usr/local/share/emacs/site-lisp or
107 /usr/local/lib/xemacs/site-lisp).
109 If the emu modules (included in APEL package) have been installed in
110 the non-standard directory, you should specify where they will be
113 % make install VERSION_SPECIFIC_LISPDIR=~/elisp
115 (c) install as a XEmacs package
117 If you want to install to XEmacs package directory, please do
120 % make install-package
122 You can specify the emacs command name, for example
124 % make install-package XEMACS=xemacs-21
126 If `XEMACS=...' is omitted, XEMACS=xemacs is used.
128 You can specify the package directory, for example:
130 % make install PACKAGEDIR=~/.xemacs
132 If `PACKAGEDIR=...' is omitted, the first existing package
135 Notice that XEmacs package system requires XEmacs 21.0 or later.
139 You can specify other optional settings by editing the file
140 ${archive}/SEMI-CFG. Please read ${archive}/README.en and comments
141 in ${archive}/SEMI-CFG.
149 If you are using Emacs or Mule, please add directory of emu, apel,
150 flim and semi to load-path. If you install by default setting, you
151 can write subdirs.el for example:
153 --------------------------------------------------------------------
154 (normal-top-level-add-to-load-path
155 '("apel" "flim" "semi"))
156 --------------------------------------------------------------------
158 If you are using XEmacs, there are no need of setting about
163 Please insert the following into your ~/.emacs:
171 To get started, please read ${archive}/README.en.
173 RFC's 822, 1524, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 and
174 2049 are available via anonymous ftp:
176 ftp://ftp.merit.edu/internet/documents/rfc/
182 If you write bug-reports and/or suggestions for improvement, please
183 send them to the Emacs-MIME Mailing Lists:
185 emacs-mime-en@lists.chise.org (English)
186 emacs-mime-ja@lists.chise.org (Japanese)
188 Via the Emacs-MIME ML, you can report SEMI bugs, obtain the latest
189 release of SEMI, and discuss future enhancements to SEMI. To join
190 the Emacs-MIME ML, please see the descriptions of the following
193 http://lists.chise.org/mailman/listinfo/emacs-mime-en (English)
194 http://lists.chise.org/mailman/listinfo/emacs-mime-ja (Japanese)
197 CVS based development
198 =====================
200 The SEMI development sources can be accessed via CVS pserver. To
201 check out the SEMI sources, what you should do for the first time
204 % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login
205 CVS password: [CR] # NULL string
207 Then you can get the latest SEMI sources by the following:
209 % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root checkout -r semi-1_14 semi
211 If you would like to join CVS based development, please send mail to
215 with your account name and your public key for ssh. cvsroot is
216 :ext:cvs@cvs.m17n.org:/cvs/root.
218 We hope you will join the open development.
226 MORIOKA Tomohiko <morioka@jaist.ac.jp>
227 (the author of mime-view and various parts of SEMI)
228 UMEDA Masanobu <umerin@mse.kyutech.ac.jp>
229 (the author of mime.el of emacs-mime-tools. mime.el is the
230 origin of mime-edit.el of SEMI)
234 Shuhei KOBAYASHI <shuhei-k@jaist.ac.jp>
235 (a major author of signature.el and a lot of codes)
236 MASUTANI Yasuhiro <masutani@me.es.osaka-u.ac.jp>
237 (anonymous ftp codes of mime-play.el)
238 OKABE Yasuo <okabe@kudpc.kyoto-u.ac.jp>
239 (a major author of mime-partial.el and signature.el)
241 Steinar Bang <sb@metis.no>
242 Steven L. Baur <steve@miranova.com>
243 Kevin Broadey <KevinB@bartley.demon.co.uk>
244 Alastair Burt <burt@dfki.uni-kl.de>
245 Eric Ding <ericding@San-Jose.ate.slb.com>
246 Thierry Emery <Thierry.Emery@aar.alcatel-alsthom.fr>
247 Simon Josefsson <jas@pdc.kth.se>
248 Jens Lautenbacher <jtl@tkm.physik.uni-karlsruhe.de>
249 Carsten Leonhardt <leo@arioch.tng.oche.de>
250 Pekka Marjola <marjola@bilbo.ntc.nokia.com>
251 Hisashi Miyashita <himi@bird.scphys.kyoto-u.ac.jp>
252 Kazuhiro Ohta <ohta@ele.cst.nihon-u.ac.jp>
253 Alexandre Oliva <oliva@dcc.unicamp.br>
254 François Pinard <pinard@iro.umontreal.ca>
255 Artur Pioro <artur@flugor.if.uj.edu.pl>
256 Dan Rich <drich@morpheus.corp.sgi.com>
257 (contribute to evolve mime-image.el with XEmacs)
258 Katsumi Yamaoka <yamaoka@jpl.org>