tm 6.9
[elisp/tm.git] / rel-6eng.ol
1 * changed points of tm-view
2
3   Internal structure of tm-view 6.* is changed from tm-view 5.21, such 
4 as, data structures, symbol names. I write main differences between tm 
5 5.21.
6
7 ** internal structure
8
9 *** content-info
10
11   Buffer local variable of article buffer `mime/content-list', which
12 memorizes content structres of message in article buffer, is renamed
13 to `mime::article/content-info', and data structure is changed.
14
15   Old data structure ``content-list'' used in buffer local variable
16 `mime/content-list' was a following list:
17
18         content-list = (Ba Ea children)
19
20                 Ba: point-min of this content in article buffer
21                 Ea: point-max of this content in article buffer
22                 children: content-list's list of contents included in
23                           this content. nil when this content is not
24                           multipart
25
26
27   New data structure ``content-info'' used in buffer local variable
28 `mime::article/content-info' is following vector:
29
30         content-info
31          = [point-min point-max type parameters encoding children]
32
33                 point-min:  point-min of this content in article buffer
34                 point-max:  point-max of this content in article buffer
35                             (This value is not equal Ea.
36                              point-max = Ea + 1)
37                 type:       content-type/subtype of this content
38                 parameters: assoc-list which represents parameters of
39                             Content-Type field of this content
40                 encoding:   Content-Transfer-Encoding of this content
41                 children:   content-info's list of contents included
42                             in this content. nil when this content is
43                             not multipart
44
45
46   In tm-view 5.21, this data structure was generated and referenced by
47 list processing functions (basic lisp functions) dynamically. In
48 tm-view 6.*, however, it is generated by generator function
49 `mime::make-content-info', and it is referenced by reference functions
50 mime::content-info/FOO (FOO = { point-min | point-max | type |
51 parameters | encoding | children }).
52
53
54 *** preview-content-info
55
56   Buffer local variable of preview buffer
57 `mime/preview-flat-content-list', which memorizes content structres of
58 message in preview buffer, is renamed to `mime::preview/content-list,
59 and data structure is changed.
60
61   Old data structure used in buffer local variable
62 `mime/preview-flat-content-list' was a list which elements are
63 following list:
64
65         (Bp Ep buf Ba Ea)
66
67                 Bp: point-min of this content in preview buffer
68                 Ep: point-max of this content in preview buffer
69                 buf: article buffer for this content
70                 Ba: point-min of this content in article buffer
71                 Ea: point-max of this content in article buffer
72
73
74   New data structure ``preview-content-info'' used in buffer local
75 variable `mime::preview/content-list'' is a list which elements are
76 following vector:
77
78         [Bp Ep buf cinfo]
79
80                 Bp: point-min of this content in preview buffer
81                 Ep: point-max of this content in preview buffer
82                 buf: article buffer for this content
83                 cinfo: content-info which represents this content
84
85
86   In tm-view 5.21, this data structure was generated and referenced by
87 list processing functions (basic lisp functions) dynamically. In
88 tm-view 6.*, however, it is generated by generator function
89 `mime::make-preview-content-info', and it is referenced by reference
90 functions mime::preview-content-info/FOO (FOO = { Bp | Ep | buf |
91 cinfo }).
92
93
94 *** etc
95
96 - parser is changed
97
98 - naming rule is changed
99
100 - buffer local variable in article buffer `mime/preview-buffer' is
101   renamed to `mime::article/preview-buffer'
102
103 - function `mime/exit-view-mode' is renamed to `mime-viewer/kill-buffer'
104
105 - command functions of mime/viewer-mode are renamed from mime/FOO to
106   mime-viewer/FOO. (ex. `mime/up-content' --> `mime-viewer/up-content')
107
108 - command function `mime/quit-view-mode' is renamed to `mime-viewer/quit'
109
110 - etc...
111
112
113 ** variables
114
115 (1) variable `mime/content-filter-alist' is renamed to
116     `mime-viewer/content-filter-alist'
117
118 (2) variable `mime/make-content-subject-function' is renamed to
119     `mime-viewer/content-subject-function' and arguments are changed
120
121 (3) variable `mime/make-content-header-filter' is renamed to
122     `mime-viewer/content-header-filter-function'
123
124 (4) variable `mime/default-showing-Content-Type-list' is renamed to
125     `mime-viewer/default-showing-Content-Type-list'
126
127 (5) variable `mime/go-to-top-node-method-alist' is renamed to
128     `mime-viewer/quitting-method-alist' and changed initial value
129     because of changes between tm-view 5.21 and tm-view 6.*.
130
131
132 ** new variables
133
134 *** mime-viewer/childrens-header-showing-Content-Type-list
135
136   list of content-type/subtype whose children's header should be
137 displayed.
138
139   This variable is used in function
140 `mime-viewer/default-content-header-filter-function' which defined as
141 default value of variable
142 `mime-viewer/content-header-filter-function'. Therefore if you set
143 another function, it may not work this variable.
144
145
146 *** mime-viewer/ignored-field-list
147
148   list of field-name which is not displayed when header is displayed.
149
150   This variable is used in function
151 `mime-viewer/default-content-header-filter-function' which defined as
152 default value of variable
153 `mime-viewer/content-header-filter-function'. Therefore if you set
154 another function, it may not work this variable.