X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mime-ui-en.texi;h=727105036a5aeda6c9430e1ec64cc39eb89ba784;hb=59c2dc20c261303c6d051416e38f30ab94cceb39;hp=d3c799d768dc644a9acf286460fd757dcd3dc1f2;hpb=989f0e33b1f4aeb51c5ed855f885a4f4f31d727b;p=elisp%2Fsemi.git diff --git a/mime-ui-en.texi b/mime-ui-en.texi index d3c799d..7271050 100644 --- a/mime-ui-en.texi +++ b/mime-ui-en.texi @@ -1,13 +1,13 @@ \input texinfo.tex @setfilename mime-ui-en.info -@settitle{SEMI 1.8 Manual} +@settitle{SEMI 1.14 Manual} @titlepage -@title SEMI 1.8 Manual +@title SEMI 1.14 Manual @author MORIOKA Tomohiko @subtitle 1998/07/03 @end titlepage @node Top, Introduction, (dir), (dir) -@top SEMI 1.8 Manual +@top SEMI 1.14 Manual @ifinfo @@ -30,28 +30,26 @@ This file documents SEMI, a MIME user interface for GNU Emacs. SEMI is a package for GNU Emacs to provide features related with MIME user interface.@refill -SEMI が提供する MIME user interface は MIME-View と MIME-Edit からなりま -す。@refill +SEMI provides two user interfaces: MIME-View and MIME-Edit.@refill - -MIME-View は MIME や STD 11 および『地域化された RFC 822』message を表示 -したり、操作したりするための user interface の中核です。@refill -MIME-Edit は MIME message を生成するための user interface です。@refill +MIME-View is a kernel of user interface to display or operate MIME +messages, STD 11 messages or ``localized RFC 822'' messages.@refill -各 MUA でこれらの機能を利用することにより、高度な MIME 機能を利用するこ -とができます。 +MIME-Edit is a user interface to compose MIME messages.@refill + +Each MUA can use powerful MIME features to combine these features. @node MIME-View, MIME-Edit, Introduction, Top @chapter MIME message viewing -MIME-View は GNU Emacs で動作する汎用的な MIME viewer です。@refill +MIME-View is a MIME viewer for wide use that runs on GNU Emacs.@refill -MIME-View は MIME message を閲覧するための利用者界面 (user interface) -の核であり、この上で presentation-method と呼ばれる表示を作るプログラム -を動かしたり、acting-method と呼ばれる entity の処理プログラムを動かす -ことが可能で、さまざまな種類の entity を扱う事ができるようになっています。 +MIME-View is the kernel of the user interface for browsing MIME +messages. You can start some presentation-method which is a program for +creating some representation, or some acting-method which is a program +for processing the entity. Then you can deal with a variety of entities. @menu @@ -63,44 +61,52 @@ MIME-View は MIME message を閲覧するための利用者界面 (user interface @node Overview of MIME-View, MIME-Preview, MIME-View, MIME-View @section Basic design -Internet の電子書簡・ネットニュースなどの書面 (message) の表現形式は STD -11 に基づいています。STD 11 の書面本体 (message body) は行を唯一の構造と -する簡易文面 (plain text) であり、文字符号も us-ascii と定められています。 -実際には、文字符号を us-ascii の代わりにその言語圏で用いられる文字符号と -した『地域化された STD 11』書面も用いられてきましたが、この場合も書面の -文字符号は１つです。このため、利用者界面 (Message User Agent) は、しばし -ば、byte 列 = us-ascii 文字列、ないしは、byte 列 = その言語圏で用いる文 -字符号の文字列のように見倣してきました。@refill - -しかしながら、MIME では書面は entity を単位とする木構造になり、また、１ -つの書面で複数の文字符号を用いることができます。また、entity の内容は文 -面や絵のような単純に表示可能なものだけでなく、音声や動画などの一定時間再 -生されるようなものや特定のアプリケーションのデータやプログラムのソース、 -あるいは、ftp や mail service の利用法や URL といった形で表された外部参 -照などのさまざまなものが考えらます。このため、表示だけを考えていた STD -11 における利用者界面の単純な延長では MIME の全ての機能を扱うことはでき -ません。つまり、MIME の形式に合わせて復号するだけでは不十分であり、利用 -者との対話的な再生処理を考慮する必要があります。MIME 書面の形式は自動処 -理がしやすく設計されていますが、MIME 書面に含まれる内容の中にはセキュリ -ティー上の問題から自動処理をするべきでないものがあり、こういったものの再 -生に関しては利用者の判断を仰ぐように設計されるべきでしょう。結局、MIME -書面を扱うためには STD 11 および MIME の構文で記述されたメッセージの情報 -交換用表現とその解釈結果である表示画面や再生等の処理を区別して考える必要 -があります。また、利用者との対話的な再生処理が必要です。@refill - -このため、MIME-View は１つの書面に対して、情報交換用表現を格納する -mime-raw-buffer と表示用表現を格納する mime-preview-buffer の２つの -buffer を用います。@refill - -MIME-View は mime-preview-buffer に対して mime-view-mode という MIME -message を閲覧するための mode を提供します。利用者はここで各 entity に -対して操作を行うことができます。 +The representation form of the internet messages in electric letters +or in net news is based on STD 11. The STD 11 message body is a plain +text which consists of lines as its only structure, and the character +code is fixed as us-ascii. Actually, there are ``localized STD 11'' +messages that use some character code in their linguistic range +instead of using us-ascii. Even in that case, the character code in +the message is single. Therefore, Message User Agents have considered +(byte row) = (us-ascii string), or (byte row) = (string in the +character code in the linguistic range).@refill + +Although, the MIME message has the tree structure in entity unit. +And one message can contain multiple character codes. The content of +an entity can be not only a letter or an image that can be displayed +simply, but also can be a voice or an animation that are played for +some time interval, a data for some specific application, a source +code of some program, or an external reference that consists of +the usage of ftp or mail service, or some URL. Therefore the simple +extension of STD 11 user interface, which only consider displaying +the message, cannot treat all of the MIME functionalities. +Then it is not sufficient to decode message along its MIME type, but +it is also required to consider a playback processing through some +dialogue with the user. The format of MIME messages is designed +to easily be passed to automatic processing. But some contents in the +MIME message should not be passed to automatic processing for security +reasons. So it should be designed to ask user in such cases. +After all, in order to deal with MIME message, it is required to +distinguish the representation for information exchange which is +written in STD 11 or MIME construction, and its result +after some interpretation which is a display screen or a playback +process. It is also needed to converse with user for playback +processing.@refill + +Therefore, MIME-View uses two buffers for one document, one is the +mime-raw-buffer that stores the representation for information exchange, +and the other is the mime-preview-buffer that stores the representation +for displaying.@refill + +MIME-View provides a mode in the mime-preview-buffer for reading MIME +message, which is called as mime-view-mode. User can manipulate each +entity there. @node MIME-Preview, mime-view-mode, Overview of MIME-View, MIME-View @section Presentation of mime-preview-buffer -mime-view-mode では各 entity に対して@refill +mime-view-mode displays information about each entity as@refill @example [entity-button] @@ -111,15 +117,15 @@ mime-view-mode では各 entity に対して@refill @end example @noindent -という情報を表示します。これらは条件に従って design を変更したり、表示 -を抑制することもできます。 +You can change their design or inhibit showing some of them, according +to some condition. -以下に、表示例を示します。 +See following example @example -From: morioka@@jaist.ac.jp (守岡 知彦 / MORIOKA Tomohiko) -Subject: Re: 質問？ +From: morioka@@jaist.ac.jp (MORIOKA Tomohiko) +Subject: Re: question? Newsgroups: zxr.message.mime Date: 22 Oct 93 11:02:44 Mime-Version: 1.0 @@ -127,9 +133,9 @@ Organization: Japan Advanced Institute of Science and Technology, Ishikawa, Japan [1 (text/plain)] - MIME-Edit mode における、MIME message の作り方。 + How to compose MIME message in MIME-Edit mode. - C-c C-x ? を押すと help が出てくる。 + C-c C-x ? shows its help. C-c C-x C-t insert a text message. C-c C-x TAB insert a (binary) file. @@ -139,30 +145,31 @@ C-c C-x C-y insert a mail or news message. C-c C-x RET insert a mail message. C-c C-x C-s insert a signature file at end. C-c C-x t insert a new MIME tag. -C-c C-x a enclose as multipart/alternative. -C-c C-x p enclose as multipart/parallel. -C-c C-x m enclose as multipart/mixed. -C-c C-x d enclose as multipart/digest. -C-c C-x s enclose as PGP signed. -C-c C-x e enclose as PGP encrypted. +C-c C-m C-a enclose as multipart/alternative. +C-c C-m C-p enclose as multipart/parallel. +C-c C-m C-m enclose as multipart/mixed. +C-c C-m C-d enclose as multipart/digest. +C-c C-m C-s enclose as PGP signed. +C-c C-m C-e enclose as PGP encrypted. C-c C-x C-k insert PGP public key. -C-c C-x C-p preview editing MIME message. +C-c C-x p preview editing MIME message. ... -って訳で、C-c C-x C-i を押して、挿入したい binary file を指定します。 +therefore, you should type C-c C-x C-i and specify the binary file +which you want to insert. - binary file の MIME encoding には、普通、Base64 を指定します。 + You should select Base64 as MIME encoding for binary file. [2 (image/gif)] [3 (text/plain)] - こんな風に、絵入り message のでき上がり。 + Like above, you can compose the message with image. -〓〓〓〓〓〓〓〓〓〓〓 ロシアン・ティーを一杯。 〓〓〓〓〓〓〓〓〓〓〓 -〓〓〓〓〓 ☆ ジャムではなくマーマレードでもなく蜂蜜で ☆ 〓〓〓〓〓 -〓〓〓〓〓 МОРいОКА ТОМОХИКО 〓〓〓〓〓 -〓〓〓〓〓〓〓 Internet E-mail: 〓〓〓〓〓〓〓 +==================== Take A Cup Of Russian Tea ====================== +========= ** Not With Jam Nor Marmalade But With Honey ** ========== +========= MORIOKA TOMOHIKO ========== +============== Internet E-mail: ============== @end example @@ -178,141 +185,144 @@ C-c C-x C-p preview editing MIME message. @cindex entity-number @cindex entity-button -@strong{entity-button} は entity の先頭にあって、その entity に関する大 -まかな情報を表示する部分です。@refill +@strong{entity-button} is a tag on the top of the entity +which shows brief information of the part.@refill -標準では +Normally, it appears as @example [1.3 test (text/plain)] @end example @noindent -のような感じに表示されます。 -最初の数字は message 中のこの entity の位置を節番号のように表したもので、 -@strong{entity-number} と呼びます。@refill +The number on the head describes the place of the entity in the +message (like the section number) and it is called as +@strong{entity-number}.@refill -２番目の文字列は表題を表します。この情報は、 +The string in the next describes its title. This information is +taken from @enumerate @item -Content-Description field もしくは Subject field に書かれた表題 +Title described in Content-Description field or Subject field @item -Content-Disposition field の filename parameter に書かれた file 名 +File name specified by filename parameter in Content-Disposition field @item -Content-Type field の name parameter に書かれた file 名 +File name specified by name parameter in Content-Type field @item - uuencode の場合の file 名 +File name for uuencode'ing @end enumerate @noindent -から作ります。どれも存在しない場合は空白が表示されます。 +If none of them are specified, displays a blank. -３番目の括弧の中の情報はその entity の media-type/subtype を表します。非 -MIME entity の場合、@code{nil} が表示されます。@refill +The 3rd item in the parenthesis describes media-type/subtype of +the entity. If it is is not MIME entity, it displays @code{nil}. +@refill -この entity-button は entity の内容を象徴する icon のような役割を果た -します。例えば、 +This entity-button plays a role like icon that symbolically +shows the content of the entity. For example, push @kbd{v} on @example [2 (image/gif)] @end example @noindent -の上で @kbd{v} を押せばここに入っている絵が表示されます。 +shows up the image contained there. -また、mouse 操作が可能な場合、entity-button を第２ボタン（3 button -mouse の場合、中央のボタン）で押せば、同様にその絵が表示されます。 +If the mouse operation is possible, you can display the image +by pushing 2nd button (the middle button for 3 button mouse) too. @node entity-header, entity-body, entity-button, MIME-Preview @subsection entity-header @cindex entity-header -@strong{entity-header} はある entity の header を表示する部 -分です（「そのままやんけ」って怒らないで。そういうもんなんです）。 - +@strong{entity-header} is the header of the entity. +(Don't blame me as ``You say nothing more than as it is'', +It is no more than that.) @node entity-body, , entity-header, MIME-Preview @subsection entity-body @cindex entity-body -@strong{entity-body} は part の内容を表示する部分です。@refill +@strong{entity-body} is the content of the part.@refill -これもひねりが足りないですが、まあ、そういうもんです。@refill +Sophistication does not seem enough here also, but it is really such +a thing.@refill -とはいえ、実際には少しひねってます。@refill +Though, it actually be twisted a little.@refill -text entity の場合は charset に応じて code 変換したりしますし、XEmacs で -は image entity を変換しないといけないし。@refill +The text entity is passed to code conversion according to its charset, +and the image entity should be converted on XEmacs.@refill -詳しくはまた後で。 +Details will be described later. @node mime-view-mode, , MIME-Preview, MIME-View @section Operation in mime-preview-buffer -mime-preview-buffer には以下の機能があります。@refill +mime-preview-buffer posesses following functionalities.@refill @table @kbd @item @key{u} -上の part に戻る（message の一番上の part でこれを行なうと Summary -mode に戻る (*1)） +go back to upper part (in the first part of the message, +go back to the Summary mode (*1)) @item @key{p} -前の part に移動する +go to previous part @item @key{M-TAB} -前の part に移動する +go to previous part @item @key{n} -次の part に移動する +go to next part @item @key{TAB} -次の part に移動する +go to next part @item @key{SPC} -scroll up する +scroll up @item @key{M-SPC} -scroll down する +scroll down @item @key{DEL} -scroll down する +scroll down @item @key{RET} -次の行に移動する +go to next line @item @key{M-RET} -前の行に移動する +go to previous line @item @key{v} -part を再生する (*2) +play current part (*2) @item @key{e} -part から file を取り出す (*2) +extract file from current part (*2) @item @key{C-c C-p} -part を印刷する (*2) +print current part (*2) @item @key{mouse-button-2} -preview-buffer 中の mouse button を起動する +start the mouse button in preview-buffer -content-button を押せば、その part が再生される(*2)@refill +on content-button, play current part (*2)@refill -URL-button を押せば、その WWW browser が起動される@refill +on URL-button, start WWW browser@refill @end table @noindent -@strong{[注意]} +@strong{[Notice]} @quotation -(*1) MUA で mime-view の設定をしていない場合、Summary mode には戻りませ -ん。@refill +(*1) Do not go back to Summary mode unless appropriately +configured for mime-view in the MUA.@refill -(*2) 実際の動作は対応する method に依ります。 +(*2) actual behavior depends on the associated method @end quotation @@ -331,6 +341,7 @@ URL-button を押せば、その WWW browser が起動される@refill * other MIME-Edit operations:: Other operations * file-type specification:: How to detect tag for inserted file * transfer level:: +* message/partial sending:: Splitting @end menu @node mime-edit-mode, single-part tags, MIME-Edit, MIME-Edit @@ -442,22 +453,22 @@ Operations to make enclosure are following: @item @key{C-c C-m C-a} Enclose specified region as multipart/alternative. -@item @key{C-c C-x C-p} +@item @key{C-c C-m C-p} Enclose specified region as multipart/parallel. -@item @key{C-c C-x C-m} +@item @key{C-c C-m C-m} Enclose specified region as multipart/mixed. -@item @key{C-c C-x C-d} +@item @key{C-c C-m C-d} Enclose specified region as multipart/digest. -@item @key{C-c C-x C-s} +@item @key{C-c C-m C-s} Digital-sign to specified region. (cf. @ref{PGP}) -@item @key{C-c C-x C-e} +@item @key{C-c C-m C-e} Encrypt to specified region. (cf. @ref{PGP}) -@item @key{C-c C-x C-q} +@item @key{C-c C-m C-q} avoid to encode tags in specified region. In other words, tags is interpreted as such string. (In current version, it may be incomplete. Maybe PGP-signature does not work for this enclosure.) @@ -574,7 +585,7 @@ Example: Specify application/rtf as default media type for -@node transfer level, , file-type specification, MIME-Edit +@node transfer level, message/partial sending, file-type specification, MIME-Edit @section transfer level @cindex transfer level @@ -632,12 +643,43 @@ but it requires to use us-ascii (@ref{(mime-en)us-ascii}) in header. +@node message/partial sending, , transfer level, MIME-Edit +@section Splitting + +@defvar mime-edit-split-message + +Split large message if it is non-nil. +@end defvar + + +@defvar mime-edit-message-default-max-lines + +Default maximum lines of a message. +@end defvar + + +@defvar mime-edit-message-max-lines-alist + +Alist of major-mode vs maximum lines of a message.@refill + +If it is not specified for a major-mode, +@code{mime-edit-message-default-max-lines} is used. +@end defvar + + +@defvar mime-edit-split-blind-field-regexp + +Regular expression to match field-name to be ignored when split sending. +@end defvar + + + @node Various, Concept Index, MIME-Edit, Top @chapter Miscellaneous @menu -* PGP:: +* PGP:: Encryption, Sign * Buttons:: Mouse button * Acting-condition configuration:: Utility for configuration @end menu @@ -651,29 +693,33 @@ mime-edit provides PGP encryption, signature and inserting public-key features based on @strong{PGP/MIME} (RFC 2015) or @strong{PGP-kazu} (draft-kazu-pgp-mime-00.txt).@refill -This feature requires pgp command and pgp interface package, such as -Mailcrypt package (@ref{(mailcrypt)}). +This feature requires your pgp command. -@defvar pgp-function-alist +@defvar pgg-default-scheme -Alist of service names vs. corresponding functions and its filenames. -Each element looks like @code{(SERVICE FUNCTION FILE)}.@refill +Version of PGP or GnuPG command to be used for encryption or sign. +The value should be a symbol. Allowed versions are @code{gpg}, +@code{pgp} or @code{pgp5}.@refill +@end defvar -SERVICE is a symbol of PGP processing. It allows `verify', `decrypt', -`fetch-key', `snarf-keys', `mime-sign', `traditional-sign', `encrypt' or -`insert-key'.@refill -Function is a symbol of function to do specified SERVICE.@refill +@defvar pgg-scheme -FILE is string of filename which has definition of corresponding -FUNCTION. +Version of PGP or GnuPG command to be used for decryption or verification. +The value should be a symbol. Allowed versions are @code{gpg}, +@code{pgp} or @code{pgp5}.@refill @end defvar -@defun pgp-function method +@defvar pgg-insert-url-function -Return function to do service @var{method}. -@end defun +The function to fetch public key from the keyserver. +Use Emacs/W3 by the default setting. To use emacs-w3m +instead, set as follows: +@lisp +(setq pgg-insert-url-function #'w3m-retrieve) +@end lisp +@end defvar