diff preface.roff @ 23:1e4afeb34da7

Rework in the preface.
author markus schnalke <meillo@marmaro.de>
date Tue, 08 May 2012 17:23:02 +0200
parents 3ef5449c1175
children 9be9b47eb52d
line wrap: on
line diff
--- a/preface.roff	Mon May 07 17:27:57 2012 +0200
+++ b/preface.roff	Tue May 08 17:23:02 2012 +0200
@@ -1,81 +1,126 @@
 .H0 "Preface" no
 
+.P
+MH is a set of mail handling tools with a common concept, like
+the Unix toolchest is a set of file handling tools with a common
+concept. nmh is the currently most popular implementation of an
+MH-like mail handling system.
+
+
 .H1 "How the Fun Began" no
 .P
-I have discovered nmh in XXX. I used to use mutt, like many
-command line-attracted Unix users. Nmh had convinced me conceptually
-at once. Unfortunately, setting it up to a convenient state became a
-tendious task. Learning its different model of email handling had,
-in contrast, been relatively easy. Learning to use MH if you are used
-to monolithic mail clients is like learning vi if you are used to
-modeless editors.
-Once having nmh set up, using it was joy because of its conceptional
-elegance and scripting capabilities, but on the other hand it was
+I have discovered nmh in September 2009. At that time I used to use mutt,
+like many command line-attracted Unix users do.
+Conceptually nmh had convinced me at once and learning
+its different model of email handling had been relatively easy.
+The change was like
+managing files in the Unix shell when you are used to graphical file
+managers, or like learning vi when you are used to modeless editors.
+The change was not trivial but as I was convinced by the concepts and
+already managed my files with shell tools and edited with vi, not to
+difficult either.
+In contrast, setting nmh up to a convenient state became a tendious task
+that took several months.
+.P
+Once having nmh arranged as wished, using it was joy because of its
+conceptional elegance and scripting capabilities.
+On the other hand, however, it still was
 inconvenient in handling attachments, non-ASCII character encodings,
-and similar stuff. I found it wrong to require more and more scripts
-and configuration to have it act the expected way. In being a
-software developer, I wanted to improve the situation.
+and similar features of modern emailing.
+My setup required more and more scripts and additional configuration
+to have nmh act the way I expected it to behave, where my
+expectations were rather common to modern emailing than exceptionel.
+In being a software developer, I wanted to improve the situation.
 .P
 In Spring 2010, I asked on the nmh-workers mailing list for the
-possibility to have a Google Summer of Code project on nmh. Being a
-student, this appeared attractive to me. Eventually, it had not been
-possible, but the nmh community started to move. In these months
-nmh's future was discussed and I became part of a ``Does nmh need an
-MTA'' discussion. There, my opinion differed from the opinion of
-most others.
+possibility to offer a Google Summer of Code project on nmh.
+Participating in the development this way appeared attractive to me,
+especially as it would have been possible to have the project
+accepted at university. Although the nmh community
+generally had been positive on the
+suggestion, eventually it had not been possible to manage the
+administrative work. Though my proposal had started the nmh community
+to move. In the following weeks, goals for nmh's future were discussed
+on the list. During the discussions, I became involved in the
+question whether nmh should be an MTA. (Thread subject:
+``should nmh be an MTA or an MUA?''.)
+In this point, my opinion differed from the opinion of most others
+as I voted for the MTA facility of nmh to be removed.
 .P
-As it hadn't been possible to work on nmh in a way that would be
+Being not able to work on nmh in a way that would be
 accepted as part of my official studies, I needed to get my credit
-points in some other way. But half a year later I was back. Starting
-in Summer 2010, I took one semester off to travel through Latin America.
-Within this time, I needed to do practical computer work for three
-months. Richard Sandelman, an active nmh user, made it possible for
-me to work on nmh during this time. Juan Granda, from Santiago del
-Estero in Argentina, provided a computer and Internet connection.
-Within these three month, I became familiar with nmh's code base and
-its community. I learned how things work. Quickly it was obvious that
-I wouldn't succeed to improve on the non-ASCII character encoding
-problems, as this is one of the most intricate parts of the system.
-Instead I improved code as I read through it. I found minor bugs in
-the code and could improve the documentation. When I started with
+points with some other project.
+Half a year later, starting in August 2010,
+I took one semester off to travel through Latin America.
+Within this time, I had to do practical computer work for three
+months.
+This brought me back to nmh.
+Richard Sandelman, an active nmh user, made it possible for
+me to work on nmh. Juan Granda, living in Santiago del
+Estero in Argentina, provided a computer and Internet connection for
+my work.
+Within the three month, I became familiar with nmh's code base and
+its community. I learned how things work. Quickly it became obvious that
+I wouldn't succeed with my main goal, to improve the character
+encoding handling within the project. One obvious problem is the missing
+transfer decoding of the quoted text in replies.
+As this is one of the most intricate parts of the system, the goal
+was simply too difficult to reach.
+Instead I improved the code as I read through it. I found minor bugs
+for which I proposed fixes to the community. Also I
+could improve the documentation. When I started with
 larger code changes, I had to discover that the community's wish for
 compatibility was stronger than its wish for convenient
-out-of-the-box setups. This lead to long discussions, again. Finally,
-I understand their point of view, but it's not mine.
-At the end of my three-month project, I had became familiar with
-nmh's code base and community, I had improved both a bit, and I still
-was convinced that I wanted to go on with it.
+out-of-the-box setups \(en in contrast with my opinion.
+This lead to long discussions, again.
+I came to understand their point of view, but it simply is not mine.
 .P
-Another half a year later, I needed a topic for my master's thesis.
-Now it was clear: I wanted to work on nmh. No, not exactly nmh,
+At the end of my three-month project, I had become familiar with
+nmh's code base and its community. I had improved the project a bit
+and I still was convinced that I wanted to go on with that.
+.P
+Another half a year later, the end of my studies came within reach.
+I needed a topic for my master's thesis.
+There was no question: I wanted to work on nmh.
+But well, not exactly on nmh,
 because I had accepted that the nmh community has different goals
-than I have. The won't be much progress if generally different opinions
-lead to long discussions. After careful thought, I had decided to
-start an experimental version of nmh. I wanted to go my way and see
-where it would lead to. Time would tell if it would prove successful.
-Nmh would hardly be hurt by my work, but could profit from my
-experiences later.
+than I have. This would result in long discussions and thus few progress.
+After careful thought, I decided to start an experimental version of nmh.
+I wanted to follow my own ideas of how nmh should look like. I wanted
+to see where that would lead to. I wanted to compare the result of my
+work to the present state of nmh. Time should prove me successful or
+not.
+Nmh would hardly be hurt by my work as I would not interfere with
+them. But nmh could profit from my experiences.
 .P
-When I started to work on mmh, my experimental version, in Fall 2011,
-activity in nmh rose suddenly. While I was working on mmh, XXX were
-working on nmh. After long years of idleing, nmh was actively
-developed again. That was a good sign. My own work went in parallel
-and unrelated. Today, my experimental version became de facto a fork.
-The mail storage, however, is still compatible.
+I started to work on my experimental version, which I call
+\fImmh\fP (for \fImeillo's mail handler\fP), in Fall 2011.
+In December, when I announced that I would work on an experimental
+version, the activity in nmh suddenly rose. Suddently the community
+started to move.
+After long years of mostly idling, nmh became actively developed again.
+What a great result!
+Hence, while I was working on mmh, the community was working on nmh
+too. My own work went in parallel and mostly unrelated.
+.P
+Because of several circumstances, my experimental version is rather
+a fork today, although this may change again in the future.
 
 
-.H1 "Naming Conventions" no
+.H1 "Organization" no
 .P
-There are three different versions of MH available currently: original MH,
-nmh, and mmh. Following is a description how the terms are used.
-.P
-.B MH
-(Mail Handler).
-Used for any MH-like mail systems, namely the original MH, nmh, and mmh.
+foo
+
+.H1 "Conventions" no
 .P
 .B "Mail client" .
 Synonym for MUA. The part of the mail software the user directly
 interacts with.
+.P
+
+.H1 "Acknowledgments" no
+.P
+foo
 
 
 .\" End or Preface. Start of the normal text.