X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README.en;h=d8770da81d94fb9e2525d0b4eddcba1cd0b00481;hb=59c2dc20c261303c6d051416e38f30ab94cceb39;hp=85bcbf59425c59fc24a6db0f019e5119846dc3cd;hpb=9b8800418cf7ed6a1dd5b59c13f99251597974f6;p=elisp%2Fsemi.git diff --git a/README.en b/README.en index 85bcbf5..d8770da 100644 --- a/README.en +++ b/README.en @@ -1,14 +1,11 @@ [README for SEMI kernel package (English Version)] -by MORIOKA Tomohiko -$Id: README.en,v 1.1 1997-04-30 17:39:28 morioka Exp $ What's SEMI? ------------- +============ - SEMI is a library to provide MIME feature for GNU Emacs. It stands - for "SEMI is Emacs MIME Interfaces". MIME is a proposed internet - standard for including content and headers other than (ASCII) plain - text in messages. + SEMI is a library to provide MIME feature for GNU Emacs. MIME is a + proposed internet standard for including content and headers other + than (ASCII) plain text in messages. RFC 2045 : Internet Message Bodies RFC 2046 : Media Types @@ -18,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) @@ -29,46 +25,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.1 or later with mule, and Emacs/mule (mule - merged EMACS; it will become Emacs 20.0). + SEMI supports XEmacs 21.1 or later, and GNU Emacs 20.4 or later. - SEMI does not support EMACS 19.28 or later, XEmacs 19.14 or later, - XEmacs 20.1 or later 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 beta versions of XEmacs 20.1, please use the latest - version and compile with mule support, i.e. use the configure flag - `--with-mule'. + SEMI also does not support Emacs 19.29 to 19.34, XEmacs 19.15 or + XEmacs 20.2, but SEMI may work with them. - If you use EMACS/mule, please use the latest version (GNU MULE - 19.34.91-delta or later). + 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: - SEMI requires APEL and MEL package. Please install them before - installing it. APEL package - is available at: + ftp://ftp.m17n.org/pub/mule/apel/ - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/apel/ + and FLIM package is available at: - and MEL package is available at: + http://www.kanji.zinbun.kyoto-u.ac.jp/~tomo/comp/emacsen/lisp/ + flim/flim-1.14/ - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/libs/ +Installation +============ - PGP/MIME and application/pgp require mailcrypt or tiny-pgp package. +(a) run in expanded place - 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. + If you don't want to install other directories, please do only + following: + % make -Installation ------------- + 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 @@ -91,28 +95,64 @@ Installation /usr/local/share/emacs/19.34/site-lisp/ --- emu /usr/local/share/emacs/site-lisp/apel/ --- APEL - /usr/local/share/emacs/site-lisp/bitmap/ --- BITMAP-MULE - /usr/local/share/emacs/site-lisp/mu/ --- MU - /usr/local/share/emacs/site-lisp/mel/ --- MEL + /usr/local/share/emacs/site-lisp/flim/ --- FLIM /usr/local/share/emacs/site-lisp/semi/ --- SEMI + You can specify site-lisp directory, for example + + % make install LISPDIR=~/share/emacs/lisp + + If `LISPDIR=...' is omitted, site-lisp directory of the specified + 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 - semi/SEMI-CFG. Please read semi/README.en and comments in - semi/TM-CFG. + ${archive}/SEMI-CFG. Please read ${archive}/README.en and comments + in ${archive}/SEMI-CFG. Initialization --------------- +============== (a) load-path If you are using Emacs or Mule, please add directory of emu, apel, - bitmap, mu, mel and semi to load-path. If you install by default - setting, you can write subdirs.el for example: + flim and semi to load-path. If you install by default setting, you + can write subdirs.el for example: -------------------------------------------------------------------- (normal-top-level-add-to-load-path - '("apel" "bitmap" "mu" "mel" "semi")) + '("apel" "flim" "semi")) -------------------------------------------------------------------- If you are using XEmacs, there are no need of setting about @@ -126,30 +166,105 @@ Initialization Documentation -------------- +============= + + To get started, please read ${archive}/README.en. - To get started, please read semi/README.en. + RFC's 822, 1524, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 and + 2049 are available via anonymous ftp: - RFC's 822, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 and 2049 - are available via anonymous ftp: - ftp://ds.internic.net/rfc/ + 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 e-mail to + + emacs-mime-en-ctl@m17n.org (English) + emacs-mime-ja-ctl@m17n.org (Japanese) + + containing + + subscribe YOUR NAME + + in its contents. + + 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 +===================== + + The SEMI development sources can be accessed via CVS pserver. To + check out the SEMI sources, what you should do for the first time + is: + + % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login + CVS password: [CR] # NULL string + + Then you can get the latest SEMI sources by the following: + + % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root checkout -r semi-1_14 semi + + 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. + + We hope you will join the open development. + + +Authors +======= + +Original authors - bug-tm-en@chamonix.jaist.ac.jp (English) - bug-tm-ja@chamonix.jaist.ac.jp (Japanese) + 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) - Via the tm ML, you can report tm bugs, obtain the latest release of - tm, and discuss future enhancements to tm. To join the tm ML, send - e-mail to +Other authors - tm-ja-admin@chamonix.jaist.ac.jp (Japanese) - tm-en-admin@chamonix.jaist.ac.jp (English) + 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) - Since the user registration is done manually, please write the mail - body in human-recognizable language (^_^). + 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