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