README.en

   1 [README for WEMI kernel package (English Version)]
   2
   3 What's WEMI?
   4 ============
   5
   6   WEMI is a branch of SEMI kernel package using widget.  It is a
   7   library to provide MIME feature for GNU Emacs based on SEMI API.
   8   Namely it contains whole features of SEMI thus it is a replacement
   9   of SEMI.
  10
  11   MIME is a proposed internet standard for including content and
  12   headers other than (ASCII) plain text in messages.
  13
  14         RFC 2045 : Internet Message Bodies
  15         RFC 2046 : Media Types
  16         RFC 2047 : Message Header Extensions
  17         RFC 2048 : MIME Registration Procedures
  18         RFC 2049 : MIME Conformance
  19
  20   WEMI has the following features:
  21
  22         - MIME message viewer   (mime-view-mode) (RFC 2045 .. 2049)
  23         - MIME message composer (mime-edit-mode) (RFC 2045 .. 2049)
  24
  25   MIME message viewer and composer also support following features:
  26
  27         - filename handling by Content-Disposition field (RFC 1806)
  28         - PGP/MIME security Multiparts (RFC 2015)
  29         - application/pgp (draft-kazu-pgp-mime-00.txt; obsolete)
  30         - text/richtext (RFC 1521; obsolete; preview only)
  31         - text/enriched (RFC 1896)
  32         - External method configuration by mailcap (RFC 1524)
  33
  34   Notice that this package does not contain MIME extender for any
  35   MUAs.  They are released as separated packages.
  36
  37
  38 Required environment
  39 ====================
  40
  41   WEMI supports XEmacs 20.3 or later with mule, and Emacs 20.2.
  42
  43   WEMI does not support anything older than Emacs 19.28 or XEmacs
  44   19.14.  WEMI also does not support Emacs 19.29 to 19.34, XEmacs
  45   19.15 or XEmacs 20.2 without mule, but WEMI may work with them.
  46
  47   If you use Emacs 20, don't set `enable-multibyte-characters' to
  48   nil. (Maybe non mule setting requires to modify emu.  In addition,
  49   it is better to use terminal-coding-system feature)
  50
  51   SEMI requires APEL (8.7 or later) and FLIM (1.3.0 or later) package.
  52   Please install them before installing it.  APEL package is available
  53   at:
  54
  55         ftp://ftp.jaist.ac.jp/pub/GNU/elisp/apel/
  56
  57   and FLIM package is available at:
  58
  59         ftp://ftp.jaist.ac.jp/pub/GNU/elisp/flim/
  60
  61   PGP/MIME and application/pgp require mailcrypt or tiny-pgp package.
  62
  63   The package enriched.el is required to compose text/enriched, so if
  64   you use Emacs anything 19.28 or older (including official version of
  65   MULE 2.3), WYSIWYG composing for text/enriched is not available.
  66
  67
  68 Installation
  69 ============
  70
  71         % make install
  72
  73   You can specify the emacs command name, for example
  74
  75         % make install EMACS=xemacs
  76
  77   If `EMACS=...' is omitted, EMACS=emacs is used.
  78
  79   You can specify the prefix of the directory tree for Emacs Lisp
  80   programs and shell scripts, for example:
  81
  82         % make install PREFIX=~/
  83
  84   If `PREFIX=...' is omitted, the prefix of the directory tree of the
  85   specified emacs command is used (perhaps /usr/local).
  86
  87   For example, if PREFIX=/usr/local and EMACS 19.34 is specified, it
  88   will create the following directory tree:
  89
  90         /usr/local/share/emacs/19.34/site-lisp/  --- emu
  91         /usr/local/share/emacs/site-lisp/apel/   --- APEL
  92         /usr/local/share/emacs/site-lisp/flim/   --- FLIM
  93         /usr/local/share/emacs/site-lisp/semi/   --- SEMI
  94
  95   You can specify site-lisp directory, for example
  96
  97         % make install LISPDIR=~/share/emacs/lisp
  98
  99   If `LISPDIR=...' is omitted, site-lisp directory of the specified
 100   emacs command is used (perhaps /usr/local/share/emacs/site-lisp or
 101   /usr/local/lib/xemacs/site-lisp).
 102
 103   You can specify other optional settings by editing the file
 104   ${archive}/SEMI-CFG.  Please read ${archive}/README.en and comments
 105   in ${archive}/SEMI-CFG.
 106
 107
 108 Initialization
 109 ==============
 110
 111 (a) load-path
 112
 113   If you are using Emacs or Mule, please add directory of emu, apel,
 114   flim and semi to load-path.  If you install by default setting, you
 115   can write subdirs.el for example:
 116
 117   --------------------------------------------------------------------
 118   (normal-top-level-add-to-load-path
 119    '("apel" "flim" "semi"))
 120   --------------------------------------------------------------------
 121
 122   If you are using XEmacs, there are no need of setting about
 123   load-path.
 124
 125 (b) mime-setup
 126
 127   Please insert the following into your ~/.emacs:
 128
 129         (load "mime-setup")
 130
 131
 132 Documentation
 133 =============
 134
 135   To get started, please read ${archive}/README.en.
 136
 137   RFC's 822, 1524, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 and
 138   2049 are available via anonymous ftp:
 139
 140         ftp://ftp.merit.edu/internet/documents/rfc/
 141
 142
 143 Mailing lists
 144 =============
 145
 146   If you write bug-reports and/or suggestions for improvement, please
 147   send them to the tm Mailing List:
 148
 149         bug-tm-en@chamonix.jaist.ac.jp  (English)
 150         bug-tm-ja@chamonix.jaist.ac.jp  (Japanese)
 151
 152   Via the tm ML, you can report WEMI bugs, obtain the latest release
 153   of WEMI, and discuss future enhancements to WEMI.  To join the tm
 154   ML, send an empty e-mail to
 155
 156         tm-en-help@chamonix.jaist.ac.jp (English)
 157         tm-ja-help@chamonix.jaist.ac.jp (Japanese)
 158
 159   Notice that you should not send mail to author(s), such as
 160   morioka@jaist.ac.jp, directly.  Because your problem may occur in
 161   other environments (if not, it might be your problem, not bug of
 162   SEMI).  We should discuss in the tm mailing lists.  Anyway
 163   direct-mail for authors might be ignored.  Please send mail to the
 164   tm mailing lists.
 165
 166
 167 CVS based development
 168 =====================
 169
 170   If you would like to join CVS based development, please send mail to
 171
 172         cvs@chamonix.jaist.ac.jp
 173
 174   with your account name and UNIX style crypted password.  We hope you
 175   will join the open development.
 176
 177
 178 Authors
 179 =======
 180
 181 Original authors
 182
 183     MORIOKA Tomohiko <morioka@jaist.ac.jp>
 184         (the author of mime-view and various parts of SEMI)
 185     UMEDA Masanobu <umerin@mse.kyutech.ac.jp>
 186         (the author of mime.el of emacs-mime-tools.  mime.el is the
 187         origin of mime-edit.el of SEMI)
 188
 189 Other authors
 190
 191     Shuhei KOBAYASHI  <shuhei-k@jaist.ac.jp>
 192         (a major author of signature.el and a lot of codes)
 193     MASUTANI Yasuhiro <masutani@me.es.osaka-u.ac.jp>
 194         (anonymous ftp codes of mime-play.el)
 195     OKABE Yasuo <okabe@kudpc.kyoto-u.ac.jp>
 196         (a major author of mime-partial.el and signature.el)
 197
 198     Steinar Bang <sb@metis.no>
 199     Steven L. Baur <steve@miranova.com>
 200     Kevin Broadey <KevinB@bartley.demon.co.uk>
 201     Alastair Burt <burt@dfki.uni-kl.de>
 202     Eric Ding <ericding@San-Jose.ate.slb.com>
 203     Thierry Emery <Thierry.Emery@aar.alcatel-alsthom.fr>
 204     Simon Josefsson <jas@pdc.kth.se>
 205     Jens Lautenbacher <jtl@tkm.physik.uni-karlsruhe.de>
 206     Carsten Leonhardt <leo@arioch.tng.oche.de>
 207     Pekka Marjola <marjola@bilbo.ntc.nokia.com>
 208     Hisashi Miyashita <himi@bird.scphys.kyoto-u.ac.jp>
 209     Kazuhiro Ohta <ohta@ele.cst.nihon-u.ac.jp>
 210     Alexandre Oliva <oliva@dcc.unicamp.br>
 211     François Pinard <pinard@iro.umontreal.ca>
 212     Artur Pioro <artur@flugor.if.uj.edu.pl>
 213     Dan Rich <drich@morpheus.corp.sgi.com>
 214         (contribute to evolve mime-image.el with XEmacs)
 215     Katsumi Yamaoka <yamaoka@ga.sony.co.jp>