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