NEWS

   1 SEMI NEWS --- history of major-changes.
   2 Copyright (C) 1998 Free Software Foundation, Inc.
   3
   4 * Changes in SEMI 1.4
   5
   6 ** mailcap
   7
   8   mailcap was supported to set up 'mime-acting-condition.
   9
  10   tm-external-method scripts written by born shell were abolished.
  11
  12
  13 ** mime-add-condition
  14
  15   New function to set up 'mime-preview-condition and/or
  16 'mime-acting-condition.
  17
  18
  19 ** signature setting in semi-setup.el
  20
  21   Abolish MUA depended signature setting.
  22
  23   Setting for mail-mode were moved to mail-mime-setup.el.
  24
  25 \f
  26 * Changes in SEMI 1.3
  27
  28 ** mime-acting-condition
  29
  30   Format of variable 'mime-acting-condition was changed from `atype'
  31 to `condition tree'.  Its format is as same as
  32 'mime-preview-condition.
  33
  34   If there are two or more conditions are found when matching, menu
  35 pops up to select method to run.  Selected situation will be added to
  36 example database. (cf. mime-acting-situation-examples-file)
  37
  38 ** New variables
  39
  40 *** mime-view-find-every-acting-situation
  41
  42         Find every available acting-situation if non-nil.
  43
  44 *** mime-acting-situation-examples-file
  45
  46         File name of example about acting-situation demonstrated by
  47         user.
  48
  49 \f
  50 * Changes in SEMI 1.2
  51
  52 ** User setting
  53
  54 *** hooks
  55
  56   'mime-view-plain-text-preview-hook was renamed to
  57 'mime-preview-text/plain-hook.
  58
  59 *** Variable
  60
  61   Variable 'mime-view-childrens-header-showing-Content-Type-list was
  62 abolished.  Please use 'mime-preview-condition instead.
  63
  64 *** API about visible-predicates were abolished
  65
  66   Following functions were abolished:
  67
  68     mime-view-header-visible-p (entity message-info)
  69
  70     mime-view-body-visible-p (entity message-info)
  71
  72     mime-view-entity-separator-visible-p (entity message-info)
  73
  74 Please use 'mime-preview-condition instead.
  75
  76   Function 'mime-view-entity-button-visible-p is not abolished, but it
  77 is obsoleted.
  78
  79 *** mime-preview-condition
  80
  81   Following are added as pre-defined keys:
  82
  83         'childrens-situation    default preview-situation for children
  84         'message-button         to specify to display message-button
  85                                     nil:        default (invisible)
  86                                     'visible:   visible
  87                                     'invisible: invisible
  88         'entity-button          to specify to display entity-button
  89                                     nil:        default (visible)
  90                                     'visible:   visible
  91                                     'invisible: invisible
  92         'header                 to specify to display header
  93                                     nil:        default (invisible)
  94                                     'visible:   visible
  95                                     'invisible: invisible
  96
  97 ** API
  98
  99 *** Interface for body-filter
 100
 101   'mime-view-filter-for-* was renamed to 'mime-preview-filter-for-*.
 102
 103
 104 *** mime-text-decode-body
 105
 106   Function 'mime-decode-text-body was renamed to
 107 'mime-text-decode-body and changed interface.  New interface is
 108 following:
 109
 110         mime-text-decode-body (SITUATION)
 111
 112 SITUATION is preview-situation.  Content-Transfer-Encoding and
 113 MIME-charset are specified in field of it.
 114
 115 \f
 116 * Changes in SEMI 1.1
 117
 118 ** User setting
 119
 120 *** Setting variable about visible body
 121
 122   'mime-view-visible-media-type-list and
 123 'mime-view-content-filter-alist were abolished.  Please use
 124 'mime-preview-condition instead.
 125
 126   Notice that 'mime-preview-condition is not list of
 127 media-type/subtype string nor association-list.  It uses new
 128 data-structure `ctree' (condition-tree; it is introduced to replace
 129 `atype').  Function 'ctree-set-calist-strictly and
 130 'ctree-set-calist-with-default may be useful to modify it (`calist'
 131 (condition-alist) is as same as `atype').
 132
 133
 134 *** API about visible-predicates
 135
 136   Interface of visible-predicates for entity elements were changed.
 137 New interfaces are following:
 138
 139     mime-view-entity-button-visible-p (entity message-info)
 140
 141     mime-view-header-visible-p (entity message-info)
 142
 143     mime-view-body-visible-p (entity message-info)
 144
 145     mime-view-entity-separator-visible-p (entity message-info)
 146
 147
 148 ** API
 149
 150 *** entity representation
 151
 152   Structure 'mime-entity-info was renamed to 'mime-entity.  So various
 153 functions were renamed too.
 154
 155
 156 *** Interface for entity-button generators
 157
 158   Interface of entity-button generators was changed.  New interfaces
 159 is following:
 160
 161     mime-view-insert-entity-button (entity message-info subject)
 162
 163
 164 *** mime-preview-condition and preview-situation
 165
 166   Conditions about preview generation are unified to
 167 'mime-preview-condition.  Namely other variables, such as
 168 'mime-view-visible-media-type-list, 'mime-view-content-filter-alist,
 169 'mime-view-image-converter-alist were abolished.
 170
 171   Preview-situation is generated from entity information, running
 172 environment and 'mime-preview-condition.  These elements are checked
 173 to match with each other. (it is similar to acting-situation)
 174
 175   Format of preview-situation is association-list.  Following key is
 176 pre-defined:
 177
 178         'type                     media-type
 179         'subtype                  media-subtype
 180         'encoding                 content-transfer-encoding
 181         'major-mode               major-mode of MUA
 182         <STRING>                  attribute of Content-Type field.
 183         'body-presentation-method body-presentation-method
 184
 185 If 'body-presentation-method is 'with-filter, 'body-filter is used to
 186 specify body-filter function.  If 'body-presentation-method is
 187 function, it is called to generate presentation of entity body.
 188
 189 Body-filter function 'mime-view-filter-for-image refers 'image-format.
 190
 191 Setting for message/partial button is specified by
 192 'mime-preview-condition instead of hard-coding.
 193
 194
 195 *** Interface for body-filter
 196
 197   Interface of body-filter was changed.  New interfaces is following:
 198
 199     <body-filter> (situation)
 200
 201 Current pre-defined filters are following:
 202
 203         mime-view-filter-for-text/plain (situation)
 204         mime-view-filter-for-text/richtext (situation)
 205         mime-view-filter-for-text/enriched (situation)
 206         mime-view-filter-for-image (situation) ; if available
 207
 208 'mime-view-filter-for-application/postscript was abolished.
 209
 210
 211 *** Format of mime-acting-condition (acting-situation)
 212
 213   Format of `mime-acting-condition' were changed.  `type' and
 214 `subtype' are separated and changed to symbol.
 215
 216
 217 *** Renaming
 218
 219 - mime-view-buffer -> mime-preview-buffer
 220
 221 \f
 222 Local variables:
 223 mode: outline
 224 paragraph-separate: "[  \f]*$"
 225 end: