-[README for MEL (English Version)]
-by MORIOKA Tomohiko <morioka@jaist.ac.jp>
-$Id: README.en,v 1.1 1997-04-29 11:47:35 morioka Exp $
+[README for FLIM (English Version)]
-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-b.el --- base64 (b-encoding) encoder/decoder
- 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 --- MIME library
+
+ mime-def.el --- Definitions about MIME format
+
+ 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
+
+ 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:
- ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/alpha/
+ ftp://ftp.jaist.ac.jp/pub/GNU/elisp/apel/
(1-a) run in expanded place
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
-
- 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 region START to END of current buffer using base64.
-
-Command base64-decode-region (start end)
-
- Decode region START to END of current buffer using base64.
-
-Command quoted-printable-encode-region (start end)
-
- Encode region START to END of current buffer using quoted-printable.
+ /usr/local/share/emacs/site-lisp/flim/ --- FLIM
-Command quoted-printable-decode-region (start end)
+ You can specify site-lisp directory, for example
- Decode region START to END of current buffer using quoted-printable.
+ % make install LISPDIR=~/share/emacs/lisp
-Command uuencode-encode-region (start end)
+ 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).
- 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)
-
- Insert base64 encoded file.
-
-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 emacs command name, for example
- Encode STRING as base64 and return it.
+ % make install-package XEMACS=xemacs-21
-Function base64-decode-string (STRING)
+ If `XEMACS=...' is omitted, XEMACS=xemacs is used.
- Decode STRING as base64 and return it.
+ You can specify the package directory, for example:
-Function q-encoding-encode-string (STRING &optional MODE)
+ % make install PACKAGEDIR=~/.xemacs
- Encode STRING as Q-encoding of encoded-word.
- 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 as Q-encoding of encoded-word.
-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
bug-tm-en@chamonix.jaist.ac.jp (English)
bug-tm-ja@chamonix.jaist.ac.jp (Japanese)
- 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
-
- tm-ja-admin@chamonix.jaist.ac.jp (Japanese)
- tm-en-admin@chamonix.jaist.ac.jp (English)
+ Via the tm ML, you can report FLIM bugs, obtain the latest release
+ of FLIM, and discuss future enhancements to FLIM. To join the tm ML,
+ send an empty e-mail to
- Since the user registration is done manually, please write the mail
- body in human-recognizable language (^_^).
+ tm-en-help@chamonix.jaist.ac.jp (English)
+ tm-ja-help@chamonix.jaist.ac.jp (Japanese)