1 SEMI NEWS --- history of major-changes.
2 Copyright (C) 1998,1999 Free Software Foundation, Inc.
6 ** PGP 5.0i and GnuPG are now supported for PGP/MIME
8 You can select the various PGP or GnuPG commands by the user option
9 `pgg-default-scheme' or `pgg-scheme'. The former is for encrypting and
10 signing, the latter could be bound for controlling which command is
11 used to process the incoming PGP armors. Note that Mailcrypt is not
12 needed anymore. A user interface for editing or viewing has never
13 changed. Note also that `pgp-function' and `pgp-functions-alist' are
14 abolished in this version.
17 ** Requires FLIM 1.13 API
20 ** Don't expect raw-buffer
22 In FLIM 1.13 API, existence of a raw-buffer corresponding to each
23 entity is not guaranteed.
25 *** Now acting-method must not expect to run in raw-buffer
27 Function `mime-play-entity' was changed to permit to run in any buffer
28 (may be called in preview-buffer). So each acting-method is called in
31 *** Don't refer variable `mime-raw-buffer'
33 Preview-buffer's local variable `mime-raw-buffer' is deleted. So
36 *** Don't refer variable `mime-preview-buffer'
38 There are no guarantee about existence of a raw-buffer corresponding
39 to each entity, so don't refer buffer local variables of the
40 raw-buffer, e.g. `mime-preview-buffer'.
43 ** Function `mime-play-entity'
45 Function `mime-play-entity' was renamed from `mime-raw-play-entity'
46 and changed interface.
50 mime-play-entity (entity &optional situation ignored-method)
52 Please use `situation' if you would like to specify `mode' and
56 ** Text property `mime-view-entity-{header|body}'
58 Now mime-view put text property `mime-view-entity-header' and
59 `mime-view-entity-body' in header and body of each entity.
62 ** Behavior change about `mime-display-header-hook'
64 Function `mime-display-entity' runs `mime-display-header-hook' before
67 In addition, now it is cleared that current point means beginning of
68 header when `mime-display-entity' runs `mime-display-header-hook'.
69 Therefore header-presentation-method must not change current point.
72 ** New variable `mime-preview-move-scroll'
74 This variables decides how to scroll in the MIME-View-mode
75 when mime-preview-move-upper, mime-preview-move-previous,
76 mime-preview-move-next is called. Those are bound to `u', `p', `n',
80 * Changes in SEMI 1.12
82 There are no user-visible changes.
84 ** New function `eliminate-top-spaces'
89 * Changes in SEMI 1.11
91 ** New function `mime-edit-decode-message-in-buffer'
93 Add new function `mime-edit-decode-message-in-buffer'. Function
94 `mime-edit-decode-buffer' was abolished.
97 ** Requires FLIM 1.12 API
100 * Changes in SEMI 1.10
102 ** Abolish variable `mime-temp-directory'
104 FLIM 1.11 and SEMI 1.10 use variable `temporary-file-directory'
105 instead of `mime-temp-directory'. So environment variable
106 "MIME_TMP_DIR" and "TM_TMP_DIR" are not effective to specify temporary
107 directory of FLIM and SEMI.
110 ** Abolish function `mime-text-insert-decoded-body'
112 SEMI 1.10 uses function `mime-insert-text-content' of FLIM 1.11 API
113 instead of `mime-text-insert-decoded-body'.
115 Now `mime-view-caesar' does not run `mime-text-decode-hook'.
118 * Changes in SEMI 1.9
120 ** User option `mime-encoding-list'
122 SEMI 1.9 requires FLIM 1.10 API. In FLIM 1.10 API, variable
123 `mime-file-encoding-method-alist' was abolished. If you want to use
124 non-standard Content-Transfer-Encoding to insert a file into sending
125 message, please edit new user option `mime-encoding-list' instead of
126 `mime-file-encoding-method-alist'.
129 ** Constant `mime-user-interface-product'
131 Constant `mime-user-interface-version' was renamed to
132 `mime-user-interface-product'. Notice that data format is changed
135 FLIM 1.10 API provides following macros to access a slot of the new
138 mime-product-name (product)
140 mime-product-version (product)
142 mime-product-code-name (product)
144 Please use them to get elements of the constant
145 `mime-user-interface-product'.
148 * Changes in SEMI 1.8
150 ** Don't use "file" command to detect content of entity
152 Acting-method to detect content of entity was modified not to use
155 Variable `mime-file-content-type-alist' was abolished. Instead of
156 it, new variable `mime-magic-type-alist' is available to customize.
157 It is an alist of regexp about magic-number vs. corresponding
158 media-types. Each element looks like (REGEXP TYPE SUBTYPE). REGEXP
159 is a regular expression to match against the beginning of the content
160 of entity. TYPE is symbol to indicate primary type of media-type.
161 SUBTYPE is symbol to indicate subtype of media-type.
164 ** Abolish external X-Face viewer
167 ** Abolish obsolete utility for *-field-list and *-field-regexp
169 Abolish function `tm:set-fields', `tm:add-fields' and
173 ** Change MUA interface of automatic message/partial combining
175 Abolish variable `mime-view-partial-message-method-alist'.
177 Instead of it, `request-partial-message-method' in acting-situation
178 is available to specify MUA depended implementation.
180 Each element of `mime-view-partial-message-method-alist' were
181 required to display message at current summary line, and its return
182 value were ignored. On the other hand,
183 `request-partial-message-method' is required to return structure of
184 message at current summary line. Format of it is mime-entity.
189 MIME-Edit inserts User-Agent field instaed of X-Emacs field if
190 `mime-edit-insert-user-agent-field' is not nil. Contents of
191 User-Agent is specified by mime-edit-user-agent-value'.
193 X-Emacs field related features were abolished.
196 * Changes in SEMI 1.7
198 ** Header-presentation-method
200 Now MIME-View uses header-presentation-method instead of
203 - abolish variable `mime-view-content-header-filter-alist'
205 - abolish function `mime-view-cut-header'
207 - Rename `mime-view-content-header-filter-hook' to
208 `mime-display-header-hook'
211 ** Abolish `mime-view-ignored-field-regexp'
213 Now mime-view uses `mime-view-ignored-field-list' directly in
214 default header-presentation-method.
217 ** Abolish body filter support
219 Please use body-presentation-method.
224 - Rename `mime-view-following-method-alist' to
225 `mime-preview-following-method-alist'
227 - Rename `mime-method-to-combine-message/partial-pieces' to
228 `mime-combine-message/partial-pieces-automatically'
231 * Changes in SEMI 1.6
233 ** Abolish tm-compatible external method support
235 Abolish tm-compatible external method support. Please use mailcap
236 method instead of it.
239 ** Abolish `mime-edit-signing-type' and `mime-edit-encrypting-type'
241 C-c C-m C-s encloses as "pgp-signed" which means PGP/MIME signature.
243 C-c C-m C-e encloses as "pgp-encrypted" which means PGP/MIME
247 ** New method to detect content of entity
249 Now MIME-View can detect content of entity for
250 application/octet-stream in default setting.
252 It uses "file" command to detect. User can customize
253 `mime-file-content-type-alist' to specify media-type for output of
254 "file" command. It is an alist of "file" output patterns
255 vs. corresponding media-types. Each element looks like (REGEXP TYPE
256 SUBTYPE). REGEXP is pattern for "file" command output. TYPE is
257 symbol to indicate primary type of media-type. SUBTYPE is symbol to
258 indicate subtype of media-type.
261 ** New interface to display message
263 - Function `mime-view-buffer'
264 - Function `mime-view-display-message'
267 ** Change interface of internal playback method
269 Interface of internal playback method was changed to
273 It is as same as interface of body-presentation-method.
276 ** Change interface of `mime-view-entity-button-visible-p'
278 ** Change interface of `mime-view-insert-entity-button'
281 ** `mime-preview-original-major-mode'
283 Abolish variable `mime-preview-original-major-mode'.
285 Please use function `mime-preview-original-major-mode' instead of
289 ** mime-preview-over-to-{previous|next}-method-alist
291 `mime-preview-over-to-{previous|next}-method-alist' were renamed
292 from `mime-view-over-to-{previous|next}-method-alist'.
295 * Changes in SEMI 1.5
299 Add inline text/html preview feature using w3. If
300 `mime-setup-enable-inline-html' is not nil, semi-setup.el sets up it.
303 ** `pgp-elkins' -> `pgp-mime'
305 Rename `pgp-elkins' -> `pgp-mime'. Variable
306 `mime-edit-signing-type' and `mime-edit-encrypting-type' does not
310 ** type-subtype-score
312 Now MIME-View chooses one entity to display body in
313 multipart/alternative. In this mechanism,
314 `mime-view-type-subtype-score-alist' is used to specify priority of
317 Variable `mime-view-type-subtype-score-alist' is alist of
318 TYPE-SUBTYPE vs. SCORE. TYPE-SUBTYPE is cons pair (TYPE . SUBTYPE),
319 symbol TYPE or t. TYPE and SUBTYPE are symbol. `t' means default.
320 SCORE is integer. Larger number is larger priority.
325 Change text presentation mechanism. In anything older than SEMI
326 1.4, text presentation mechanism is based on filter model. However it
327 has design problem about conversion between byte representation and
328 text presentation. So SEMI was changed to use
329 body-presentation-method to display text entity. In this purpose, old
330 text decoding features were abolished and introduces news features
334 ** mime-raw-representation-type and mime-raw-representation-type-alist
336 Abolish `mime-text-decoder' and `mime-text-decoder-alist' because of
337 text presentation mechanism change (cf. previous section). Instead of
338 it, SEMI introduces variable about representation-type of
339 mime-raw-buffer. If it is `binary', mime-raw-buffer is as same as
340 network representation. If it is `cooked', mime-raw-buffer is
343 `mime-raw-representation-type-alist' is an alist of major-mode
344 vs. representation-type. Each element looks like
346 (SYMBOL . REPRESENTATION-TYPE).
348 SYMBOL is major-mode or t. t means default.
350 `mime-raw-representation-type' is a buffer local variable of
351 mime-raw-buffer. If it is non-nil, it overrides
352 `mime-raw-representation-type-alist'.
354 In addition, `mime-raw-buffer-coding-system-alist' was abolished.
355 Because representation-type has enough information.
358 * Changes in SEMI 1.4
362 mailcap was supported to set up 'mime-acting-condition.
364 tm-external-method scripts written by born shell were abolished.
367 ** mime-add-condition
369 New function to set up 'mime-preview-condition and/or
370 'mime-acting-condition.
373 ** signature setting in semi-setup.el
375 Abolish MUA depended signature setting.
377 Setting for mail-mode were moved to mail-mime-setup.el.
380 * Changes in SEMI 1.3
382 ** mime-acting-condition
384 Format of variable 'mime-acting-condition was changed from `atype'
385 to `condition tree'. Its format is as same as
386 'mime-preview-condition.
388 If there are two or more conditions are found when matching, menu
389 pops up to select method to run. Selected situation will be added to
390 example database. (cf. mime-acting-situation-examples-file)
394 *** mime-view-find-every-acting-situation
396 Find every available acting-situation if non-nil.
398 *** mime-acting-situation-examples-file
400 File name of example about acting-situation demonstrated by
404 * Changes in SEMI 1.2
410 'mime-view-plain-text-preview-hook was renamed to
411 'mime-preview-text/plain-hook.
415 Variable 'mime-view-childrens-header-showing-Content-Type-list was
416 abolished. Please use 'mime-preview-condition instead.
418 *** API about visible-predicates were abolished
420 Following functions were abolished:
422 mime-view-header-visible-p (entity message-info)
424 mime-view-body-visible-p (entity message-info)
426 mime-view-entity-separator-visible-p (entity message-info)
428 Please use 'mime-preview-condition instead.
430 Function 'mime-view-entity-button-visible-p is not abolished, but it
433 *** mime-preview-condition
435 Following are added as pre-defined keys:
437 'childrens-situation default preview-situation for children
438 'message-button to specify to display message-button
439 nil: default (invisible)
441 'invisible: invisible
442 'entity-button to specify to display entity-button
443 nil: default (visible)
445 'invisible: invisible
446 'header to specify to display header
447 nil: default (invisible)
449 'invisible: invisible
453 *** Interface for body-filter
455 'mime-view-filter-for-* was renamed to 'mime-preview-filter-for-*.
458 *** mime-text-decode-body
460 Function 'mime-decode-text-body was renamed to
461 'mime-text-decode-body and changed interface. New interface is
464 mime-text-decode-body (SITUATION)
466 SITUATION is preview-situation. Content-Transfer-Encoding and
467 MIME-charset are specified in field of it.
470 * Changes in SEMI 1.1
474 *** Setting variable about visible body
476 'mime-view-visible-media-type-list and
477 'mime-view-content-filter-alist were abolished. Please use
478 'mime-preview-condition instead.
480 Notice that 'mime-preview-condition is not list of
481 media-type/subtype string nor association-list. It uses new
482 data-structure `ctree' (condition-tree; it is introduced to replace
483 `atype'). Function 'ctree-set-calist-strictly and
484 'ctree-set-calist-with-default may be useful to modify it (`calist'
485 (condition-alist) is as same as `atype').
488 *** API about visible-predicates
490 Interface of visible-predicates for entity elements were changed.
491 New interfaces are following:
493 mime-view-entity-button-visible-p (entity message-info)
495 mime-view-header-visible-p (entity message-info)
497 mime-view-body-visible-p (entity message-info)
499 mime-view-entity-separator-visible-p (entity message-info)
504 *** entity representation
506 Structure 'mime-entity-info was renamed to 'mime-entity. So various
507 functions were renamed too.
510 *** Interface for entity-button generators
512 Interface of entity-button generators was changed. New interfaces
515 mime-view-insert-entity-button (entity message-info subject)
518 *** mime-preview-condition and preview-situation
520 Conditions about preview generation are unified to
521 'mime-preview-condition. Namely other variables, such as
522 'mime-view-visible-media-type-list, 'mime-view-content-filter-alist,
523 'mime-view-image-converter-alist were abolished.
525 Preview-situation is generated from entity information, running
526 environment and 'mime-preview-condition. These elements are checked
527 to match with each other. (it is similar to acting-situation)
529 Format of preview-situation is association-list. Following key is
533 'subtype media-subtype
534 'encoding content-transfer-encoding
535 'major-mode major-mode of MUA
536 <STRING> attribute of Content-Type field.
537 'body-presentation-method body-presentation-method
539 If 'body-presentation-method is 'with-filter, 'body-filter is used to
540 specify body-filter function. If 'body-presentation-method is
541 function, it is called to generate presentation of entity body.
543 Body-filter function 'mime-view-filter-for-image refers 'image-format.
545 Setting for message/partial button is specified by
546 'mime-preview-condition instead of hard-coding.
549 *** Interface for body-filter
551 Interface of body-filter was changed. New interfaces is following:
553 <body-filter> (situation)
555 Current pre-defined filters are following:
557 mime-view-filter-for-text/plain (situation)
558 mime-view-filter-for-text/richtext (situation)
559 mime-view-filter-for-text/enriched (situation)
560 mime-view-filter-for-image (situation) ; if available
562 'mime-view-filter-for-application/postscript was abolished.
565 *** Format of mime-acting-condition (acting-situation)
567 Format of `mime-acting-condition' were changed. `type' and
568 `subtype' are separated and changed to symbol.
573 - mime-view-buffer -> mime-preview-buffer
578 paragraph-separate: "[
\f]*$"