X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README.en;h=9465ad0888bb155f33244071004def96d90ce4ca;hb=375b33ded71db73ca3a0be9f5d66358a046fea09;hp=9807da9297ef0ce89827803c09c890e7c3af817c;hpb=f8d0107f1538c822c498acbd9046e4569cdd05bb;p=elisp%2Fsemi.git diff --git a/README.en b/README.en index 9807da9..9465ad0 100644 --- a/README.en +++ b/README.en @@ -1,8 +1,8 @@ +;; -*- coding: utf-8; -*- [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 +16,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,43 +26,54 @@ 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. + SEMI supports XEmacs 21.1 or later, and GNU Emacs 20.4 or later. - SEMI does not support anything older than Emacs 19.28 or XEmacs - 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. + 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 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 (10.7 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/ + http://git.chise.org/elisp/dist/apel/ and FLIM package is available at: - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/flim/ + http://git.chise.org/elisp/dist/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,87 @@ 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 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 + + 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