This file documents tm-edit, a MIME composer for GNU Emacs.
tm-edit is based on mime.el by UMEDA Masanobu
In
There are 2 kinds of tags:
single-part tag represents single part, this form is following:
TYPE/SUBTYPE and PARAMETERS indicates type/subtype and parameters of
ENCODING indicates Content-Transfer-Encoding field. It is optional too.
OPTIONAL-FIELDS is to represent another fields except Content-Type field and Content-Transfer-Encoding field.
multi-part tags represent multi
part. They consist of a pair of
multi-part beginning tag's form is following:
multi-part ending tag's form is following:
A region from multi-part beginning tag to multi-part ending tag is
called as
Operations to make single-part are following:
Operations to make enclosure are following:
There are another operations in mime/editor-mode.
When C-c C-x C-i (mime-editor/insert-file
) is
pressed, tag parameters for inserted file, such as media-type or
encoding, are detected by variable mime-file-types
.
When C-u is followed by it or parameter is not found from the variable, it asks from user. (When C-u is followed by it, detected value is used as default value)
If you want to change default value for file names, please change
variable
Specification of default value of tag for file name of inserted file.
It is a list of following list:
mime-file-types
.
Contents inserted in a message are represented by
If a message is translated by 7bit-through
Similarly, if a message is translated by 8bit-through MTA, there is no need to encode 7bit or 8bit data, but binary data must be encoded to 7bit or 8bit data.
Similarly, I wish ASCII-printable only MTA and code-conversion MTA
disappeared. (^_^;
Maybe there are binary-through MTA, but I think it is not major.
transfer level.
If transfer level of a data is over it, a data is encoded to 7bit.
Currently, 7 or 8 is available. Default value is 7.
In extension plan, EBCDIC will be 5, ASCII printable only will be 6,
binary will be 9. But it will not be implemented.
mime-editor/transfer-level
to represent transfer level.
It is a format called as
It is wrong to use ``raw'' non-ASCII characters in header not to use
encoded-word. Because there are various kinds of coded character set in the Internet, so
we can not distinguish them if
For example, we can not distinguish
However you can not permit to use encoded-word, please set to
following variables:
Association-list to specify field encoding method. Its key is
field-name, value is encoding method.
field-name allows string or
Encoding method allows following:
field-name is searched from string. If it is not found,
Default value of t
meaning any fields.
nil
means
no-conversion, mime
means to convert as encoded-word,
symbol represent MIME charset means to convert as the coded character
set instead of to convert as encoded-word.
t
is used.
mime/field-encoding-method-alist
is
following:
In addition, if you want to specify by coded character set instead of
field, please use
It translate non-ASCII characters in message header of current buffer
into network representation, such as encoded-words.
If code-conversion is non-
It encodes string into encoded-words as a field.
Long lines are folded.
It encodes string into encoded-words.
Long lines are folded.
column specifies start column. If it is omitted, 0 is
used.
mode specifies where string is in. Available
values are
Association-list of symbol represent MIME charset vs. nil,
tm-edit provides PGP encryption, signature and inserting public-key
features based on
This feature requires pgp command and Mailcrypt
package.
If you want to use this feature, please set
If
Format of PGP signature.
It allows
Default value is
Format of PGP encryption.
It allows
Default value is
First of all, I thank UMEDA Masanobu for his work of
I thank members of two tm mailing lists, Japanese and English version.
mime-eword/charset-encoding-alist
.
Functions and variables about header
nil
, field not
encoded by encoded-word is converted by
mime/field-encoding-method-alist
.
text
, comment
,
phrase
. If it is omitted, phrase
is used.
"B"
or "Q"
.
nil
means not to encode as encoded-word.
"B"
means to use B-encoding.
"Q"
means to use Q-encoding.
PGP
pgp-elkins
or
pgp-kazu
to variable
mimed-editor/signing-type
and variable
mime-editor/encrypting-type
.
pgp-elkins
is specified, PGP/MIME is used. If
pgp-kazu
is specified, PGP-kazu is used.
pgp-elkins
or pgp-kazu
.
nil
.
pgp-elkins
or pgp-kazu
.
nil
.
Acknowledgments
Concept Index
Function Index
Variable Index