From 3a0c3c6b4426acb20de2b1fbb3db4482b1bf7779 Mon Sep 17 00:00:00 2001 From: yamaoka Date: Wed, 9 Oct 2002 11:13:52 +0000 Subject: [PATCH] Synch with the semi-1_14 branch. --- mime-ui-en.sgml | 148 +++++++++++++++++++++++++++++-------------------------- mime-ui-en.texi | 105 +++++++++++++++++++++------------------ 2 files changed, 135 insertions(+), 118 deletions(-) diff --git a/mime-ui-en.sgml b/mime-ui-en.sgml index bbfe92b..5426417 100644 --- a/mime-ui-en.sgml +++ b/mime-ui-en.sgml @@ -34,50 +34,57 @@ Each MUA can use powerful MIME features to combine these features.

MIME message viewing MIME-View

-MIME-View は GNU Emacs で動作する汎用的な MIME viewer です。 +MIME-View is a MIME viewer for wide use that runs on GNU Emacs.

-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.

Basic design Overview of MIME-View

-Internet の電子書簡・ネットニュースなどの書面 (message) の表現形式は -STD 11 に基づいています。STD 11 の書面本体 (message body) は行を唯一の -構造とする簡易文面 (plain text) であり、文字符号も us-ascii と定められ -ています。実際には、文字符号を us-ascii の代わりにその言語圏で用いられ -る文字符号とした『地域化された STD 11』書面も用いられてきましたが、こ -の場合も書面の文字符号は１つです。このため、利用者界面 (Message User -Agent) は、しばしば、byte 列 = us-ascii 文字列、ないしは、byte 列 = そ -の言語圏で用いる文字符号の文字列のように見倣してきました。 -

-しかしながら、MIME では書面は entity を単位とする木構造になり、また、 -１つの書面で複数の文字符号を用いることができます。また、entity の内容 -は文面や絵のような単純に表示可能なものだけでなく、音声や動画などの一定 -時間再生されるようなものや特定のアプリケーションのデータやプログラムの -ソース、あるいは、ftp や mail service の利用法や URL といった形で表さ -れた外部参照などのさまざまなものが考えらます。このため、表示だけを考え -ていた STD 11 における利用者界面の単純な延長では MIME の全ての機能を扱 -うことはできません。つまり、MIME の形式に合わせて復号するだけでは不十 -分であり、利用者との対話的な再生処理を考慮する必要があります。MIME 書 -面の形式は自動処理がしやすく設計されていますが、MIME 書面に含まれる内 -容の中にはセキュリティー上の問題から自動処理をするべきでないものがあり、 -こういったものの再生に関しては利用者の判断を仰ぐように設計されるべきで -しょう。結局、MIME 書面を扱うためには STD 11 および MIME の構文で記述 -されたメッセージの情報交換用表現とその解釈結果である表示画面や再生等の -処理を区別して考える必要があります。また、利用者との対話的な再生処理が -必要です。 -

-このため、MIME-View は１つの書面に対して、情報交換用表現を格納する -mime-raw-buffer と表示用表現を格納する mime-preview-buffer の２つの -buffer を用います。 -

-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). +

+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. +

+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. +

+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.

Presentation of mime-preview-buffer @@ -143,10 +150,10 @@ which you want to insert. Like above, you can compose the message with image. -〓〓〓〓〓〓〓〓〓〓〓 ロシアン・ティーを一杯。 〓〓〓〓〓〓〓〓〓〓〓 -〓〓〓〓〓 ☆ ジャムではなくマーマレードでもなく蜂蜜で ☆ 〓〓〓〓〓 -〓〓〓〓〓 МОРいОКА ТОМОХИКО 〓〓〓〓〓 -〓〓〓〓〓〓〓 Internet E-mail: <morioka@jaist.ac.jp> 〓〓〓〓〓〓〓 +==================== Take A Cup Of Russian Tea ====================== +========= ** Not With Jam Nor Marmalade But With Honey ** ========== +========= MORIOKA TOMOHIKO ========== +============== Internet E-mail: <morioka@@jaist.ac.jp> ============== @@ -201,20 +208,21 @@ by pushing 2nd button (the middle button for 3 button mouse) too. entity-header

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.)

entity-body entity-body

entity-body is the content of the part.

-これもひねりが足りないですが、まあ、そういうもんです。 +Sophistication does not seem enough here also, but it is really such +a thing.

-とはいえ、実際には少しひねってます。 +Though, it actually be twisted a little.

-text entity の場合は charset に応じて code 変換したりしますし、XEmacs -では image entity を変換しないといけないし。 +The text entity is passed to code conversion according to its charset, +and the image entity should be converted on XEmacs.

Details will be described later. @@ -222,54 +230,54 @@ Details will be described later.

Operation in mime-preview-buffer mime-view-mode

-mime-preview-buffer には以下の機能があります。 +mime-preview-buffer posesses following functionalities.

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)) -p前の part に移動する +pgo to previous part -M-TAB前の part に移動する +M-TABgo to previous part -n次の part に移動する +ngo to next part -TAB次の part に移動する +TABgo to next part -SPCscroll up する +SPCscroll up -M-SPCscroll down する +M-SPCscroll down -DELscroll down する +DELscroll down -RET次の行に移動する +RETgo to next line -M-RET前の行に移動する +M-RETgo to previous line -vpart を再生する (*2) +vplay current part (*2) -epart から file を取り出す (*2) +eextract file from current part (*2) -C-c C-ppart を印刷する (*2) +C-c C-pprint current part (*2) mouse-button-2 -preview-buffer 中の mouse button を起動する +start the mouse button in preview-buffer

-content-button を押せば、その part が再生される(*2) +on content-button, play current part (*2)

-URL-button を押せば、その WWW browser が起動される +on URL-button, start WWW browser

- +

-(*1) MUA で mime-view の設定をしていない場合、Summary mode には戻りま -せん。 +(*1) Do not go back to Summary mode unless appropriately +configured for mime-view in the MUA.

-(*2) 実際の動作は対応する method に依ります。 +(*2) actual behavior depends on the associated method diff --git a/mime-ui-en.texi b/mime-ui-en.texi index 3f11370..773716f 100644 --- a/mime-ui-en.texi +++ b/mime-ui-en.texi @@ -32,7 +32,7 @@ user interface.@refill SEMI provides two user interfaces: MIME-View and MIME-Edit.@refill - + MIME-View is a kernel of user interface to display or operate MIME messages, STD 11 messages or ``localized RFC 822'' messages.@refill @@ -44,12 +44,12 @@ 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 @@ -61,38 +61,46 @@ 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 @@ -158,10 +166,10 @@ which you want to insert. 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 @@ -232,8 +240,8 @@ by pushing 2nd button (the middle button for 3 button mouse) too. @cindex 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 @@ -241,12 +249,13 @@ by pushing 2nd button (the middle button for 3 button mouse) too. @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. -- 1.7.10.4