X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README.en;h=5315343b7f32b355cde3cacacc1ae02122d56cf0;hb=343d7c053a62c8e76eb893a5ca516f5e1ff9606c;hp=9807da9297ef0ce89827803c09c890e7c3af817c;hpb=f8d0107f1538c822c498acbd9046e4569cdd05bb;p=elisp%2Fsemi.git diff --git a/README.en b/README.en index 9807da9..5315343 100644 --- a/README.en +++ b/README.en @@ -1,8 +1,7 @@ [README for SEMI kernel package (English Version)] -by MORIOKA Tomohiko What's SEMI? ------------- +============ SEMI is a library to provide MIME feature for GNU Emacs. MIME is a proposed internet standard for including content and headers other @@ -16,7 +15,6 @@ What's SEMI? 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) @@ -27,13 +25,14 @@ What's SEMI? - 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. @@ -41,29 +40,40 @@ Required environment 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 also does not support Emacs 19.29 to 19.34, XEmacs 19.15 or + XEmacs 20.2, but SEMI may work with them. - SEMI requires APEL (8.7 or later) and FLIM (1.1.0 or later) package. - Please install them before installing it. APEL package is available - at: + SEMI requires APEL (9.22 or later) and FLIM (1.14.2 or later) + package. Please install them before installing it. APEL package is + available at: - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/apel/ + ftp://ftp.m17n.org/pub/mule/apel/ and FLIM package is available at: - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/flim/ + http://www.kanji.zinbun.kyoto-u.ac.jp/~tomo/comp/emacsen/lisp/ + flim/flim-1.14/ - PGP/MIME and application/pgp require mailcrypt or tiny-pgp package. - 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. +Installation +============ +(a) run in expanded place -Installation ------------- + If you don't want to install other directories, please do only + following: + + % 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 @@ -97,13 +107,43 @@ Installation 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 ${archive}/SEMI-CFG. Please read ${archive}/README.en and comments in ${archive}/SEMI-CFG. Initialization --------------- +============== (a) load-path @@ -127,27 +167,92 @@ Initialization Documentation -------------- +============= 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:@cvs.m17n.org:/cvs/root. + + We hope you will join the open development. + + +Authors +======= + +Original authors + + MORIOKA Tomohiko + (the author of mime-view and various parts of SEMI) + UMEDA Masanobu + (the author of mime.el of emacs-mime-tools. mime.el is the + origin of mime-edit.el of SEMI) - bug-tm-en@chamonix.jaist.ac.jp (English) - bug-tm-ja@chamonix.jaist.ac.jp (Japanese) +Other authors - 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 an empty e-mail to + Shuhei KOBAYASHI + (a major author of signature.el and a lot of codes) + MASUTANI Yasuhiro + (anonymous ftp codes of mime-play.el) + OKABE Yasuo + (a major author of mime-partial.el and signature.el) - tm-en-help@chamonix.jaist.ac.jp (English) - tm-ja-help@chamonix.jaist.ac.jp (Japanese) + Steinar Bang + Steven L. Baur + Kevin Broadey + Alastair Burt + Eric Ding + Thierry Emery + Simon Josefsson + Jens Lautenbacher + Carsten Leonhardt + Pekka Marjola + Hisashi Miyashita + Kazuhiro Ohta + Alexandre Oliva + François Pinard + Artur Pioro + Dan Rich + (contribute to evolve mime-image.el with XEmacs) + Katsumi Yamaoka