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