X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README.en;h=8ded08484bc919ea22fbdd6d703266819656cb12;hb=refs%2Fheads%2Fchao-1_14;hp=e57637ca4804f6d13e4d2c409dcdff18722a3085;hpb=7128995d0abb664f9a8609ced0eaccad8246a262;p=elisp%2Fflim.git diff --git a/README.en b/README.en index e57637c..8ded084 100644 --- a/README.en +++ b/README.en @@ -1,30 +1,48 @@ -[README for MEL (English Version)] -by MORIOKA Tomohiko -$Id: README.en,v 1.9 1998-01-11 17:47:18 morioka Exp $ +[README for FLIM (English Version)] +by MORIOKA Tomohiko -What's MEL +What's FLIM =========== - MEL stands for "MIME Encoding Library". It consists of following + FLIM is a library to provide basic features about message + representation or encoding. It consists of following modules: - mel.el --- main module - mel-dl.el --- base64 (b-encoding) encoder/decoder - (for Emacs 20 with dynamic loading support) - mel-b.el --- base64 (b-encoding) encoder/decoder - (for other emacsen) - mel-q.el --- quoted-printable and q-encoding encoder/decoder - mel-u.el --- unofficial module for uuencode - mel-g.el --- unofficial module for gzip64 + std11.el --- STD 11 (RFC 822) parser and utility + + mime.el --- to provide various services about MIME-entities + + mime-def.el --- Definitions about MIME format + + mime-parse.el --- MIME parser + + mel.el --- MIME encoder/decoder + mel-b-dl.el --- base64 (B-encoding) encoder/decoder + (for Emacs 20 with dynamic loading support) + mel-b-ccl.el --- base64 (B-encoding) encoder/decoder + (using CCL) + mel-b-en.el --- base64 (B-encoding) encoder/decoder + (for other emacsen) + mel-q-ccl.el --- quoted-printable and Q-encoding + encoder/decoder (using CCL) + mel-q.el --- quoted-printable and Q-encoding + encoder/decoder + mel-u.el --- unofficial backend for uuencode + mel-g.el --- unofficial backend for gzip64 + + eword-decode.el --- encoded-word decoder + eword-encode.el --- encoded-word encoder + + mailcap.el --- mailcap parser and utility Installation ============ -(0) before installing it, please install APEL package. APEL package - is available at: +(0) before installing it, please install APEL (9.22 or later) package. + APEL package is available at: - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/apel/ + ftp://ftp.m17n.org/pub/mule/apel/ (1-a) run in expanded place @@ -35,7 +53,7 @@ Installation You can specify the emacs command name, for example - % make install EMACS=xemacs + % make EMACS=xemacs If `EMACS=...' is omitted, EMACS=emacs is used. @@ -52,7 +70,7 @@ Installation If `EMACS=...' is omitted, EMACS=emacs is used. You can specify the prefix of the directory tree for Emacs Lisp - programs and shell scripts, for example: + programs, for example: % make install PREFIX=~/ @@ -62,7 +80,7 @@ Installation For example, if PREFIX=/usr/local and EMACS 19.34 is specified, it will create the following directory tree: - /usr/local/share/emacs/site-lisp/mel/ --- MEL + /usr/local/share/emacs/site-lisp/flim/ --- FLIM You can specify site-lisp directory, for example @@ -72,194 +90,70 @@ Installation emacs command is used (perhaps /usr/local/share/emacs/site-lisp or /usr/local/lib/xemacs/site-lisp). - You can specify other optional settings by editing the file - MEL-CFG. Please read comments in it. - - -load-path (for Emacs or MULE) -============================= - - If you are using Emacs or Mule, please add directory of MEL to - load-path. If you install by default setting, you can write - subdirs.el for example: - - -------------------------------------------------------------------- - (normal-top-level-add-to-load-path '("apel" "mel")) - -------------------------------------------------------------------- - - If you are using XEmacs, there are no need of setting about - load-path. - - -How to use -========== - -Region ------- - -Command mime-encode-region (START END ENCODING) - - Encode region START to END of current buffer using ENCODING. - -Command mime-decode-region (start end encoding) - - Decode region START to END of current buffer using ENCODING. - -Command base64-encode-region (start end) - - Encode current region by base64. - START and END are buffer positions. - - This function calls internal base64 encoder if size of region is - smaller than `base64-internal-encoding-limit', otherwise it calls - external base64 encoder specified by `base64-external-encoder'. In - this case, you must install the program (maybe mmencode included in - metamail or XEmacs package). - -Command base64-decode-region (start end) - - Decode current region by base64. - START and END are buffer positions. - - This function calls internal base64 decoder if size of region is - smaller than `base64-internal-decoding-limit', otherwise it calls - external base64 decoder specified by `base64-external-decoder'. In - this case, you must install the program (maybe mmencode included in - metamail or XEmacs package). - -Command quoted-printable-encode-region (start end) - - Encode current region by quoted-printable. - START and END are buffer positions. + 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: - This function calls internal quoted-printable encoder if size of - region is smaller than `quoted-printable-internal-encoding-limit', - otherwise it calls external quoted-printable encoder specified by - `quoted-printable-external-encoder'. In this case, you must install - the program (maybe mmencode included in metamail or XEmacs package). + % make install VERSION_SPECIFIC_LISPDIR=~/elisp -Command quoted-printable-decode-region (start end) + Following make target is available to find what files are parts of + emu / APEL package, and where are directories to install them: - Decode current region by quoted-printable. - START and END are buffer positions. + % make what-where LISPDIR=~/elisp VERSION_SPECIFIC_LISPDIR=~/elisp - This function calls internal quoted-printable decoder if size of - region is smaller than `quoted-printable-internal-decoding-limit', - otherwise it calls external quoted-printable decoder specified by - `quoted-printable-external-decoder'. In this case, you must install - the program (maybe mmencode included in metamail or XEmacs package). - -Command uuencode-encode-region (start end) - - Encode region START to END of current buffer using uuencode. - -Command uuencode-decode-region (start end) - - Decode region START to END of current buffer using uuencode. - -Command gzip64-encode-region (start end) - - Encode region START to END of current buffer using x-gzip64. - -Command gzip64-decode-region (start end) - - Decode region START to END of current buffer using x-gzip64. - -Variable mime-encoding-method-alist - - Alist of encoding vs. corresponding method to encode region. - Each element looks like (STRING . FUNCTION) or (STRING . nil). - STRING is content-transfer-encoding. - FUNCTION is region encoder and nil means not to encode. - -Variable mime-decoding-method-alist - - Alist of encoding vs. corresponding method to decode region. - Each element looks like (STRING . FUNCTION). - STRING is content-transfer-encoding. - FUNCTION is region decoder. - -File ----- - -Command mime-insert-encoded-file (FILENAME ENCODING) - - Insert file FILENAME encoded by ENCODING format. - -Command base64-insert-encoded-file (FILENAME) - - Encode contents of file FILENAME to base64, and insert the result. - - It calls external base64 encoder specified by - `base64-external-encoder'. So you must install the program (maybe - mmencode included in metamail or XEmacs package). - -Command quoted-printable-insert-encoded-file (FILENAME) - - Insert quoted-printable encoded file. - -Command uuencode-insert-encoded-file (FILENAME) - - Insert uuencode encoded file. - -Command gzip64-insert-encoded-file (FILENAME) - - Insert gzip64 encoded file. + You can specify other optional settings by editing the file + FLIM-CFG. Please read comments in it. -Variable mime-file-encoding-method-alist +(1-c) install as a XEmacs package - Alist of encoding vs. corresponding method to insert encoded file. - Each element looks like (STRING . FUNCTION). - STRING is content-transfer-encoding. - FUNCTION is function to insert encoded file. + If you want to install to XEmacs package directory, please do + following: -String ------- + % make install-package -Function base64-encode-string (STRING) + You can specify the XEmacs command name, for example - Encode STRING to base64, and return the result. + % make install-package XEMACS=xemacs-21 -Function base64-decode-string (STRING) + If `XEMACS=...' is omitted, XEMACS=xemacs is used. - Decode STRING which is encoded in base64, and return the result. + You can specify the package directory, for example: -Function q-encoding-encode-string (STRING &optional MODE) + % make install PACKAGEDIR=~/.xemacs - Encode STRING to Q-encoding of encoded-word, and return the result. - MODE allows `text', `comment', `phrase' or nil. Default value is - `phrase'. + If `PACKAGEDIR=...' is omitted, the first existing package + directory is used. -Function q-encoding-decode-string (STRING) + Notice that XEmacs package system requires XEmacs 21.0 or later. - Decode STRING which is encoded in Q-encoding and return the result. -Function base64-encoded-length (STRING) +load-path (for Emacs or MULE) +============================= - Return length of base64 encoded STRING. + If you are using Emacs or Mule, please add directory of FLIM to + load-path. If you install by default setting, you can write + subdirs.el for example: -Function q-encoded-length (STRING &optional MODE) + -------------------------------------------------------------------- + (normal-top-level-add-to-load-path '("apel" "flim")) + -------------------------------------------------------------------- - Return length of Q-encoding encoded STRING. - MODE allows `text', `comment', `phrase' or nil. Default value is - `phrase'. + If you are using XEmacs, there are no need of setting about + load-path. Bug reports =========== If you write bug-reports and/or suggestions for improvement, please - send them to the tm Mailing List: - - bug-tm-en@chamonix.jaist.ac.jp (English) - bug-tm-ja@chamonix.jaist.ac.jp (Japanese) + send them to the EMACS-MIME Mailing List: - Via the tm ML, you can report MEL bugs, obtain the latest release of - MEL, and discuss future enhancements to MEL. To join the tm ML, send - e-mail to + emacs-mime-en@m17n.org (English) + emacs-mime-ja@m17n.org (Japanese) - tm-ja-admin@chamonix.jaist.ac.jp (Japanese) - tm-en-admin@chamonix.jaist.ac.jp (English) + Via the EMACS-MIME ML, you can report FLIM bugs, obtain the latest + release of FLIM, and discuss future enhancements to FLIM. To join + the EMACS-MIME ML, send an empty e-mail to - Since the user registration is done manually, please write the mail - body in human-recognizable language (^_^). + emacs-mime-en-ctl@m17n.org (English) + emacs-mime-ja-ctl@m17n.org (Japanese)