docs/master

view summary.roff @ 172:6800d594b2b7

hgignore: This change is not related to the document itself.
author markus schnalke <meillo@marmaro.de>
date Tue, 10 Jul 2012 17:20:21 +0200
parents 5c01017be420
children 4c7db172fb59
line source
1 .H0 "Summary
2 .P
3 This document describes and explains my work on mmh.
4 I have streamlined the project by removing programs, facilities
5 and options that diverted from the main task of mmh, being a MUA.
6 I have modernized the code base removing obsolete functions and
7 activating modern features per default.
8 Further more, I improved the style by refactoring clumpsy code
9 and by defining or exploiting clear concepts.
10 All my work was motivated by Antoine de Saint Exupery's well-known
11 statement:
12 .[
13 antoine de saint exupery: Wind, Sand and Stars (1939)
14 .]
15 .QS
16 It seems that perfection is attained not when there is nothing
17 more to add, but when there is nothing more to remove.
18 .QE
19 .P
20 In contrast to the common expectations, I have hardly added new features.
21 I regard my improvements in selecting the relevant set of existing
22 features and exploiting the concepts more thoroughly.
23 I believe, the result is a system simpler and clearer for both
24 developing and using, without lacking important functionality.
27 .U2 "Outlook
28 .P
29 The work done during the project is not finished.
30 Several tasks are left to do.
31 .P
32 MIME handling is the most complex part of mmh and it requires
33 general rework.
34 The changes already done to it build upon the existing structure.
35 Yet, MIME support is not truly integrated.
36 For instance, accessing messages and accessing MIME parts of messages
37 have inherently different concepts, although a single concept should
38 cover both.
39 The sequence notation should provide a way to address MIME parts directly.
40 Furthermore, the sequence notation should be made more powerful in general.
41 For instance, it is currently not possible to access the second last
42 message in a given sequence.
43 Displaying messages with
44 .Pn show
45 requires further rework.
46 Encrypted messages, for example, should be decoded automatically
47 and digital signatures should be verified on-the-fly.
48 The whole task should be aligned with the common behavior of other
49 mail clients.
50 MH's unique features should not be lost, but the default should become
51 less surprising.
52 Transfer-decoding of the quoted text in replys and encoding of non-ASCII
53 characters in message header fields like
54 .Hd Subject
55 remain unsolved.
56 .P
57 Some of mmh's tools were hardly touched during my work.
58 Among them are
59 .Pn dist ,
60 .Pn rcvdist ,
61 .Pn mark ,
62 .Pn pick ,
63 and
64 .Pn sortm .
65 Related to
66 .Pn sortm ,
67 a threaded message view is completely missing to mmh, yet.
68 .Pn pick
69 could be enhanced by message indexing.
70 These fields are worthwhile for research.
71 .P
72 The features most often asked for are Maildir and IMAP support.
73 Yet, both of them collide with MH in the same fundamental way as
74 different filesystem approaches would collide with Unix.
75 Nevertheless, an abstraction layer could provide a mapping from such
76 storage back-ends to the MH storage format.
77 Or the mmh toolchest could be reworked to operate on a generic back-end,
78 making the MH storage format only one of many possible back-ends.
79 Research in this area is highly appreciated.
80 .\" XXX targeting the right problems?!
81 .P
82 Nmh has a testing framework that supported the developers by detecting
83 several subtle bugs.
84 All refactoring in mmh had been done without the safety net of a test
85 framework.
86 Hence, experience warns that the probability for subtle bugs lurking
87 in the code base is high.
88 Nmh's test framework should be adjusted to mmh and extended.
89 .\" XXX path notation; signing and encrypting
92 .U2 "Relationship to nmh
93 .P
94 The mmh project started as an experimental version of nmh because the
95 nmh community did not welcome my changes in the mainline version.
96 To not slow my work down by the need to convince the community in
97 discussions for each step I liked to take,
98 I started to create an experimental version to convicce by demonstration
99 of the result.
100 .\" behind closed doors; talks I've given
101 My worked on mmh was independent of the nmh community.
102 This enabled me to follow my vision straightly and thus produce
103 a result of greater pureness.
104 .P
105 Mmh shall be considered an inspiration for the future development of nmh.
106 It shall show identify weak part of nmh and suggest possible
107 improvements by change.
108 It shall present a lean appearance that is simpler to understand
109 and work with for developers and users.
110 By all means shall my work on mmh improve nmh in some way.
111 Improving nmh directly in the way I wanted was impossible for me
112 due to personal and community-related circumstances.
113 The mmh project is my way to offer my gifts though.
114 .P
115 During my work on mmh, the community of nmh suddenly became very active.
116 They have worked on nmh in parallel to my work on mmh.
117 There was no collaberation in our work, except that I have pulled some
118 changes from nmh to mmh.
119 Our work was motivated partly by similar and partly by different aims.
120 Although some changes are common among both projects,
121 fundamental differences exist.
122 My experimental version thus more and more felt like being a fork.
123 I am undecided how I like to have it.
124 Yet, I am strongly convinced that most of the decisions taken in mmh
125 were good to achieve my goals and I like to push the project even
126 farther in this direction.
129 .U2 "Weaknesses of My Work
130 .P
131 not targeting on the right problems (maildir, imap)
133 .P
134 refactoring requires testing, automated testing
136 .P
137 communication with nmh.
138 worked behind closed doors, but no:
139 talks I've given
141 .P
142 focus on myself.
143 But: If good for me then also good for others.