1 SEMI NEWS --- history of major-changes.
2 Copyright (C) 1998,1999 Free Software Foundation, Inc.
6 ** Requires FLIM 1.13 API
9 ** Don't expect raw-buffer
11 In FLIM 1.13 API, existence of a raw-buffer corresponding to each
12 entity is not guaranteed.
14 *** Now acting-method must not expect to run in raw-buffer
16 Function `mime-play-entity' was changed to permit to run in any buffer
17 (may be called in preview-buffer). So each acting-method is called in
20 *** Don't refer variable `mime-raw-buffer'
22 Preview-buffer's local variable `mime-raw-buffer' is deleted. So
25 *** Don't refer variable `mime-preview-buffer'
27 There are no guarantee about existence of a raw-buffer corresponding
28 to each entity, so don't refer buffer local variables of the
29 raw-buffer, e.g. `mime-preview-buffer'.
32 ** Function `mime-play-entity'
34 Function `mime-play-entity' was renamed from `mime-raw-play-entity'
35 and changed interface.
39 mime-play-entity (entity &optional situation ignored-method)
41 Please use `situation' if you would like to specify `mode' and
45 ** Text property `mime-view-entity-{header|body}'
47 Now mime-view put text property `mime-view-entity-header' and
48 `mime-view-entity-body' in header and body of each entity.
51 ** Behavior change about `mime-display-header-hook'
53 Function `mime-display-entity' runs `mime-display-header-hook' before
56 In addition, now it is cleared that current point means beginning of
57 header when `mime-display-entity' runs `mime-display-header-hook'.
58 Therefore header-presentation-method must not change current point.
61 ** New variable `mime-preview-move-scroll'
63 This variables decides how to scroll in the MIME-View-mode
64 when mime-preview-move-upper, mime-preview-move-previous,
65 mime-preview-move-next is called. Those are bound to `u', `p', `n',
69 * Changes in SEMI 1.12
71 There are no user-visible changes.
73 ** New function `eliminate-top-spaces'
78 * Changes in SEMI 1.11
80 ** New function `mime-edit-decode-message-in-buffer'
82 Add new function `mime-edit-decode-message-in-buffer'. Function
83 `mime-edit-decode-buffer' was abolished.
86 ** Requires FLIM 1.12 API
89 * Changes in SEMI 1.10
91 ** Abolish variable `mime-temp-directory'
93 FLIM 1.11 and SEMI 1.10 use variable `temporary-file-directory'
94 instead of `mime-temp-directory'. So environment variable
95 "MIME_TMP_DIR" and "TM_TMP_DIR" are not effective to specify temporary
96 directory of FLIM and SEMI.
99 ** Abolish function `mime-text-insert-decoded-body'
101 SEMI 1.10 uses function `mime-insert-text-content' of FLIM 1.11 API
102 instead of `mime-text-insert-decoded-body'.
104 Now `mime-view-caesar' does not run `mime-text-decode-hook'.
107 * Changes in SEMI 1.9
109 ** User option `mime-encoding-list'
111 SEMI 1.9 requires FLIM 1.10 API. In FLIM 1.10 API, variable
112 `mime-file-encoding-method-alist' was abolished. If you want to use
113 non-standard Content-Transfer-Encoding to insert a file into sending
114 message, please edit new user option `mime-encoding-list' instead of
115 `mime-file-encoding-method-alist'.
118 ** Constant `mime-user-interface-product'
120 Constant `mime-user-interface-version' was renamed to
121 `mime-user-interface-product'. Notice that data format is changed
124 FLIM 1.10 API provides following macros to access a slot of the new
127 mime-product-name (product)
129 mime-product-version (product)
131 mime-product-code-name (product)
133 Please use them to get elements of the constant
134 `mime-user-interface-product'.
137 * Changes in SEMI 1.8
139 ** Don't use "file" command to detect content of entity
141 Acting-method to detect content of entity was modified not to use
144 Variable `mime-file-content-type-alist' was abolished. Instead of
145 it, new variable `mime-magic-type-alist' is available to customize.
146 It is an alist of regexp about magic-number vs. corresponding
147 media-types. Each element looks like (REGEXP TYPE SUBTYPE). REGEXP
148 is a regular expression to match against the beginning of the content
149 of entity. TYPE is symbol to indicate primary type of media-type.
150 SUBTYPE is symbol to indicate subtype of media-type.
153 ** Abolish external X-Face viewer
156 ** Abolish obsolete utility for *-field-list and *-field-regexp
158 Abolish function `tm:set-fields', `tm:add-fields' and
162 ** Change MUA interface of automatic message/partial combining
164 Abolish variable `mime-view-partial-message-method-alist'.
166 Instead of it, `request-partial-message-method' in acting-situation
167 is available to specify MUA depended implementation.
169 Each element of `mime-view-partial-message-method-alist' were
170 required to display message at current summary line, and its return
171 value were ignored. On the other hand,
172 `request-partial-message-method' is required to return structure of
173 message at current summary line. Format of it is mime-entity.
178 MIME-Edit inserts User-Agent field instaed of X-Emacs field if
179 `mime-edit-insert-user-agent-field' is not nil. Contents of
180 User-Agent is specified by mime-edit-user-agent-value'.
182 X-Emacs field related features were abolished.
185 * Changes in SEMI 1.7
187 ** Header-presentation-method
189 Now MIME-View uses header-presentation-method instead of
192 - abolish variable `mime-view-content-header-filter-alist'
194 - abolish function `mime-view-cut-header'
196 - Rename `mime-view-content-header-filter-hook' to
197 `mime-display-header-hook'
200 ** Abolish `mime-view-ignored-field-regexp'
202 Now mime-view uses `mime-view-ignored-field-list' directly in
203 default header-presentation-method.
206 ** Abolish body filter support
208 Please use body-presentation-method.
213 - Rename `mime-view-following-method-alist' to
214 `mime-preview-following-method-alist'
216 - Rename `mime-method-to-combine-message/partial-pieces' to
217 `mime-combine-message/partial-pieces-automatically'
220 * Changes in SEMI 1.6
222 ** Abolish tm-compatible external method support
224 Abolish tm-compatible external method support. Please use mailcap
225 method instead of it.
228 ** Abolish `mime-edit-signing-type' and `mime-edit-encrypting-type'
230 C-c C-m C-s encloses as "pgp-signed" which means PGP/MIME signature.
232 C-c C-m C-e encloses as "pgp-encrypted" which means PGP/MIME
236 ** New method to detect content of entity
238 Now MIME-View can detect content of entity for
239 application/octet-stream in default setting.
241 It uses "file" command to detect. User can customize
242 `mime-file-content-type-alist' to specify media-type for output of
243 "file" command. It is an alist of "file" output patterns
244 vs. corresponding media-types. Each element looks like (REGEXP TYPE
245 SUBTYPE). REGEXP is pattern for "file" command output. TYPE is
246 symbol to indicate primary type of media-type. SUBTYPE is symbol to
247 indicate subtype of media-type.
250 ** New interface to display message
252 - Function `mime-view-buffer'
253 - Function `mime-view-display-message'
256 ** Change interface of internal playback method
258 Interface of internal playback method was changed to
262 It is as same as interface of body-presentation-method.
265 ** Change interface of `mime-view-entity-button-visible-p'
267 ** Change interface of `mime-view-insert-entity-button'
270 ** `mime-preview-original-major-mode'
272 Abolish variable `mime-preview-original-major-mode'.
274 Please use function `mime-preview-original-major-mode' instead of
278 ** mime-preview-over-to-{previous|next}-method-alist
280 `mime-preview-over-to-{previous|next}-method-alist' were renamed
281 from `mime-view-over-to-{previous|next}-method-alist'.
284 * Changes in SEMI 1.5
288 Add inline text/html preview feature using w3. If
289 `mime-setup-enable-inline-html' is not nil, semi-setup.el sets up it.
292 ** `pgp-elkins' -> `pgp-mime'
294 Rename `pgp-elkins' -> `pgp-mime'. Variable
295 `mime-edit-signing-type' and `mime-edit-encrypting-type' does not
299 ** type-subtype-score
301 Now MIME-View chooses one entity to display body in
302 multipart/alternative. In this mechanism,
303 `mime-view-type-subtype-score-alist' is used to specify priority of
306 Variable `mime-view-type-subtype-score-alist' is alist of
307 TYPE-SUBTYPE vs. SCORE. TYPE-SUBTYPE is cons pair (TYPE . SUBTYPE),
308 symbol TYPE or t. TYPE and SUBTYPE are symbol. `t' means default.
309 SCORE is integer. Larger number is larger priority.
314 Change text presentation mechanism. In anything older than SEMI
315 1.4, text presentation mechanism is based on filter model. However it
316 has design problem about conversion between byte representation and
317 text presentation. So SEMI was changed to use
318 body-presentation-method to display text entity. In this purpose, old
319 text decoding features were abolished and introduces news features
323 ** mime-raw-representation-type and mime-raw-representation-type-alist
325 Abolish `mime-text-decoder' and `mime-text-decoder-alist' because of
326 text presentation mechanism change (cf. previous section). Instead of
327 it, SEMI introduces variable about representation-type of
328 mime-raw-buffer. If it is `binary', mime-raw-buffer is as same as
329 network representation. If it is `cooked', mime-raw-buffer is
332 `mime-raw-representation-type-alist' is an alist of major-mode
333 vs. representation-type. Each element looks like
335 (SYMBOL . REPRESENTATION-TYPE).
337 SYMBOL is major-mode or t. t means default.
339 `mime-raw-representation-type' is a buffer local variable of
340 mime-raw-buffer. If it is non-nil, it overrides
341 `mime-raw-representation-type-alist'.
343 In addition, `mime-raw-buffer-coding-system-alist' was abolished.
344 Because representation-type has enough information.
347 * Changes in SEMI 1.4
351 mailcap was supported to set up 'mime-acting-condition.
353 tm-external-method scripts written by born shell were abolished.
356 ** mime-add-condition
358 New function to set up 'mime-preview-condition and/or
359 'mime-acting-condition.
362 ** signature setting in semi-setup.el
364 Abolish MUA depended signature setting.
366 Setting for mail-mode were moved to mail-mime-setup.el.
369 * Changes in SEMI 1.3
371 ** mime-acting-condition
373 Format of variable 'mime-acting-condition was changed from `atype'
374 to `condition tree'. Its format is as same as
375 'mime-preview-condition.
377 If there are two or more conditions are found when matching, menu
378 pops up to select method to run. Selected situation will be added to
379 example database. (cf. mime-acting-situation-examples-file)
383 *** mime-view-find-every-acting-situation
385 Find every available acting-situation if non-nil.
387 *** mime-acting-situation-examples-file
389 File name of example about acting-situation demonstrated by
393 * Changes in SEMI 1.2
399 'mime-view-plain-text-preview-hook was renamed to
400 'mime-preview-text/plain-hook.
404 Variable 'mime-view-childrens-header-showing-Content-Type-list was
405 abolished. Please use 'mime-preview-condition instead.
407 *** API about visible-predicates were abolished
409 Following functions were abolished:
411 mime-view-header-visible-p (entity message-info)
413 mime-view-body-visible-p (entity message-info)
415 mime-view-entity-separator-visible-p (entity message-info)
417 Please use 'mime-preview-condition instead.
419 Function 'mime-view-entity-button-visible-p is not abolished, but it
422 *** mime-preview-condition
424 Following are added as pre-defined keys:
426 'childrens-situation default preview-situation for children
427 'message-button to specify to display message-button
428 nil: default (invisible)
430 'invisible: invisible
431 'entity-button to specify to display entity-button
432 nil: default (visible)
434 'invisible: invisible
435 'header to specify to display header
436 nil: default (invisible)
438 'invisible: invisible
442 *** Interface for body-filter
444 'mime-view-filter-for-* was renamed to 'mime-preview-filter-for-*.
447 *** mime-text-decode-body
449 Function 'mime-decode-text-body was renamed to
450 'mime-text-decode-body and changed interface. New interface is
453 mime-text-decode-body (SITUATION)
455 SITUATION is preview-situation. Content-Transfer-Encoding and
456 MIME-charset are specified in field of it.
459 * Changes in SEMI 1.1
463 *** Setting variable about visible body
465 'mime-view-visible-media-type-list and
466 'mime-view-content-filter-alist were abolished. Please use
467 'mime-preview-condition instead.
469 Notice that 'mime-preview-condition is not list of
470 media-type/subtype string nor association-list. It uses new
471 data-structure `ctree' (condition-tree; it is introduced to replace
472 `atype'). Function 'ctree-set-calist-strictly and
473 'ctree-set-calist-with-default may be useful to modify it (`calist'
474 (condition-alist) is as same as `atype').
477 *** API about visible-predicates
479 Interface of visible-predicates for entity elements were changed.
480 New interfaces are following:
482 mime-view-entity-button-visible-p (entity message-info)
484 mime-view-header-visible-p (entity message-info)
486 mime-view-body-visible-p (entity message-info)
488 mime-view-entity-separator-visible-p (entity message-info)
493 *** entity representation
495 Structure 'mime-entity-info was renamed to 'mime-entity. So various
496 functions were renamed too.
499 *** Interface for entity-button generators
501 Interface of entity-button generators was changed. New interfaces
504 mime-view-insert-entity-button (entity message-info subject)
507 *** mime-preview-condition and preview-situation
509 Conditions about preview generation are unified to
510 'mime-preview-condition. Namely other variables, such as
511 'mime-view-visible-media-type-list, 'mime-view-content-filter-alist,
512 'mime-view-image-converter-alist were abolished.
514 Preview-situation is generated from entity information, running
515 environment and 'mime-preview-condition. These elements are checked
516 to match with each other. (it is similar to acting-situation)
518 Format of preview-situation is association-list. Following key is
522 'subtype media-subtype
523 'encoding content-transfer-encoding
524 'major-mode major-mode of MUA
525 <STRING> attribute of Content-Type field.
526 'body-presentation-method body-presentation-method
528 If 'body-presentation-method is 'with-filter, 'body-filter is used to
529 specify body-filter function. If 'body-presentation-method is
530 function, it is called to generate presentation of entity body.
532 Body-filter function 'mime-view-filter-for-image refers 'image-format.
534 Setting for message/partial button is specified by
535 'mime-preview-condition instead of hard-coding.
538 *** Interface for body-filter
540 Interface of body-filter was changed. New interfaces is following:
542 <body-filter> (situation)
544 Current pre-defined filters are following:
546 mime-view-filter-for-text/plain (situation)
547 mime-view-filter-for-text/richtext (situation)
548 mime-view-filter-for-text/enriched (situation)
549 mime-view-filter-for-image (situation) ; if available
551 'mime-view-filter-for-application/postscript was abolished.
554 *** Format of mime-acting-condition (acting-situation)
556 Format of `mime-acting-condition' were changed. `type' and
557 `subtype' are separated and changed to symbol.
562 - mime-view-buffer -> mime-preview-buffer
567 paragraph-separate: "[
\f]*$"