X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README.en;h=b42396fb9105008d2aad8c1a5f385aecee149a72;hb=a0b108d58d36fff037f8d27eb9a2a91a7d518b9c;hp=195ab83d737ff94d93445ba1cd13f892960279ea;hpb=60a497d821b17de756ffcd2c25bb331a6ebf4fb8;p=elisp%2Fflim.git diff --git a/README.en b/README.en index 195ab83..b42396f 100644 --- a/README.en +++ b/README.en @@ -1,4 +1,5 @@ [README for FLIM (English Version)] +by MORIOKA Tomohiko What's FLIM =========== @@ -9,23 +10,28 @@ What's FLIM std11.el --- STD 11 (RFC 822) parser and utility - mime.el --- MIME library + mime.el --- to provide various services about MIME-entities - mime-def.el --- Definitions about MIME format + mime-def.el --- Definitions about MIME format - mime-parse.el --- MIME parser + mime-parse.el --- MIME parser - mel.el --- MIME encoder/decoder - 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 + 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 + eword-decode.el --- encoded-word decoder + eword-encode.el --- encoded-word encoder mailcap.el --- mailcap parser and utility @@ -33,10 +39,10 @@ What's FLIM Installation ============ -(0) before installing it, please install APEL package. APEL package - is available at: +(0) before installing it, please install APEL (9.21 or later) package. + APEL package is available at: - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/apel/ + ftp://ftp.etl.go.jp/pub/mule/apel/ (1-a) run in expanded place @@ -47,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. @@ -64,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=~/ @@ -84,177 +90,56 @@ 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 - FLIM-CFG. Please read comments in it. - - -load-path (for Emacs or MULE) -============================= - - 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: - - -------------------------------------------------------------------- - (normal-top-level-add-to-load-path '("apel" "flim")) - -------------------------------------------------------------------- - - 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. - - 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). - -Command quoted-printable-decode-region (start end) + 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: - Decode current region by quoted-printable. - START and END are buffer positions. + % make install 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). + Following make target is available to find what files are parts of + emu / APEL package, and where are directories to install them: -Command uuencode-encode-region (start end) + % make what-where LISPDIR=~/elisp VERSION_SPECIFIC_LISPDIR=~/elisp - 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