Modify about 'body-filter.
[elisp/semi.git] / NEWS
1 SEMI NEWS --- history of major-changes.
2 Copyright (C) 1998 Free Software Foundation, Inc.
3 \f
4 * Changes in SEMI 1.1
5
6 ** User setting
7
8 *** Setting variable about visible body
9
10   'mime-view-visible-media-type-list and
11 'mime-view-content-filter-alist were abolished.  Please use
12 'mime-preview-condition instead.
13
14   Notice that 'mime-preview-condition is not list of
15 media-type/subtype string nor association-list.  It uses new
16 data-structure `ctree' (condition-tree; it is introduced to replace
17 `atype').  Function 'ctree-set-calist-strictly and
18 'ctree-set-calist-with-default may be useful to modify it (`calist'
19 (condition-alist) is as same as `atype').
20
21
22 *** API about visible-predicates
23
24   Interface of visible-predicates for entity elements were changed.
25 New interfaces are following:
26
27     mime-view-entity-button-visible-p (entity message-info)
28
29     mime-view-header-visible-p (entity message-info)
30
31     mime-view-body-visible-p (entity message-info)
32
33     mime-view-entity-separator-visible-p (entity message-info)
34
35
36 ** API
37
38 *** entity representation
39
40   Structure 'mime-entity-info was renamed to 'mime-entity.  So various
41 functions were renamed too.
42
43
44 *** Interface for entity-button generators
45
46   Interface of entity-button generators was changed.  New interfaces
47 is following:
48
49     mime-view-insert-entity-button (entity message-info subject)
50
51
52 *** mime-preview-condition and preview-situation
53
54   Conditions about preview generation are unified to
55 'mime-preview-condition.  Namely other variables, such as
56 'mime-view-visible-media-type-list, 'mime-view-content-filter-alist,
57 were abolished.
58
59   Preview-situation is generated from entity information, running
60 environment and 'mime-preview-condition.  These elements are checked
61 to match with each other. (it is similar to acting-situation)
62
63   Format of preview-situation is association-list.  Following key is
64 pre-defined:
65
66         'type                     media-type
67         'subtype                  media-subtype
68         'encoding                 content-transfer-encoding
69         'major-mode               major-mode of MUA
70         <STRING>                  attribute of Content-Type field.
71         'body-presentation-method body-presentation-method
72
73 If 'body-presentation-method is 'with-filter, 'body-filter is used to
74 specify body-filter function.  If 'body-presentation-method is
75 function, it is called to generate presentation of entity body.
76
77 Setting for message/partial button is specified by
78 'mime-preview-condition instead of hard-coding.
79
80
81 *** Interface for body-filter
82
83   Interface of body-filter was changed.  New interfaces is following:
84
85     <body-filter> (situation)
86
87 Current pre-defined filters are following:
88
89         mime-view-filter-for-text/plain (situation)
90         mime-view-filter-for-text/richtext (situation)
91         mime-view-filter-for-text/enriched (situation)
92         mime-view-filter-for-image (situation) ; if available
93
94 'mime-view-filter-for-application/postscript was abolished.
95
96
97 *** Format of mime-acting-condition (acting-situation)
98
99   Format of `mime-acting-condition' were changed.  `type' and
100 `subtype' are separated and changed to symbol.
101
102
103 *** Renaming
104
105 - mime-view-buffer -> mime-preview-buffer
106
107 \f
108 Local variables:
109 mode: outline
110 paragraph-separate: "[  \f]*$"
111 end: