X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README.en;h=9465ad0888bb155f33244071004def96d90ce4ca;hb=refs%2Fheads%2Fmaster;hp=8a1b3302e6d2944822c73a04ba58ed4a2d9e1f94;hpb=106415d7d7a2a3077977339ec32f6a5d1850f62a;p=elisp%2Fsemi.git diff --git a/README.en b/README.en index 8a1b330..9465ad0 100644 --- a/README.en +++ b/README.en @@ -1,14 +1,12 @@ +;; -*- coding: utf-8; -*- [README for SEMI kernel package (English Version)] -by MORIOKA Tomohiko -$Id: README.en,v 1.5 1998-02-12 11:12:41 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 +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) @@ -29,46 +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 and MEL 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 MEL package is available at: + and FLIM package is available at: - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/libs/ + http://git.chise.org/elisp/dist/flim/flim-1.14/ - Notice that latest version of XEmacs may have latest version of APEL - and MEL, so you should not install them. - PGP/MIME and application/pgp require mailcrypt or tiny-pgp package. +Installation +============ - 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. +(a) run in expanded place + If you don't want to install other directories, please do only + following: -Installation ------------- + % 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 @@ -91,9 +96,7 @@ 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 @@ -104,23 +107,53 @@ 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 - semi/SEMI-CFG. Please read semi/README.en and comments in - semi/SEMI-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 @@ -134,30 +167,87 @@ 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 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 - 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 SEMI bugs, obtain the latest release - of SEMI, and discuss future enhancements to SEMI. 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