docs/master

changeset 197:05a243dffaca

Added refs to the Preface; splitted the bib.
author markus schnalke <meillo@marmaro.de>
date Thu, 12 Jul 2012 00:39:41 +0200
parents a75de0da2fb7
children 9ed707d62150
files bib discussion.roff intro.roff mail.bib makefile preface.roff web.bib
diffstat 7 files changed, 264 insertions(+), 146 deletions(-) [+]
line diff
     1.1 --- a/bib	Thu Jul 12 00:19:09 2012 +0200
     1.2 +++ b/bib	Thu Jul 12 00:39:41 2012 +0200
     1.3 @@ -1,7 +1,3 @@
     1.4 -%L web:nmh
     1.5 -%T Website of nmh
     1.6 -%O \f(CW\s-1 http://nmh.nongnu.org\s0
     1.7 -
     1.8  %A Markus Schnalke
     1.9  %T masqmail
    1.10  %I Ulm University of Applied Sciences
    1.11 @@ -17,17 +13,22 @@
    1.12  %O \f(CW\s-1 http://marmaro.de/docs/studium/unix-phil/\s0
    1.13  %K term paper
    1.14  
    1.15 +%L CS2012-04
    1.16  %A Markus Schnalke
    1.17  %T mmh
    1.18 -%I CCC Ulm ChaosSeminar
    1.19 -%D 2012
    1.20 -%O \f(CW\s-1 http://ulm.ccc.de/ChaosSeminar/2012/04_mmh\s0
    1.21 +%S ChaosSeminar
    1.22 +%I CCC Ulm
    1.23 +%D April 2012
    1.24 +%O \f(CW\s-1 http://ulm.ccc.de/ChaosSeminar/2012/04_mmh \s0
    1.25  
    1.26 -%L WP:UP
    1.27 -%A Wikipedia, The Free Encyclopedia
    1.28 -%T Unix philosophy
    1.29 -%D Version of 2010-03-21 17:20 UTC
    1.30 -%O \f(CW\s-1 http://en.wikipedia.org/w/index.php?title=Unix_philosophy&oldid=351189719\s0
    1.31 +%L GPN12
    1.32 +%A Markus Schnalke
    1.33 +%T meillo's mail handler
    1.34 +%S Gulaschprogrammiernacht 12
    1.35 +%I Entropia e.V. CCC Karlsruhe
    1.36 +%D June 2012
    1.37 +%O \f(CW\s-1 https://entropia.de/GPN12:meillo%27s_mail_handler \s0
    1.38 +%K gpn mmh
    1.39  
    1.40  %A Michael S. Mahoney
    1.41  %T The UNIX Oral History Project
    1.42 @@ -60,12 +61,6 @@
    1.43  %D 1999
    1.44  %O \s-1ISBN\s0: 0-201-61586-X
    1.45  
    1.46 -%L ISO\^9126
    1.47 -%I International Organization for Standardization
    1.48 -%T ISO Standard 9126: Software Engineering \(en Product Quality, part 1
    1.49 -%C Geneve
    1.50 -%D 2001
    1.51 -
    1.52  %A Jason Aughenbaugh
    1.53  %A Jonathan Jessup
    1.54  %A Nicholas Spicher
    1.55 @@ -121,20 +116,6 @@
    1.56  %P mail(1)
    1.57  %O \f(CW\s-1 http://cm.bell-labs.com/cm/cs/who/dmr/pdfs/man12.pdf\s0
    1.58  
    1.59 -%L MH
    1.60 -%A \s-1MH\s0/nmh workers
    1.61 -%T \s-1MH\s0/nmh Documentation
    1.62 -%P mh-profile(5), mh-sequence(5)
    1.63 -%O Distributed with nmh-1.3. Online in possibly different versions:
    1.64 -	\f(CW\s-1 http://linux.die.net/man/5/mh-profile\s0
    1.65 -	http://linux.die.net/man/5/mh-sequence
    1.66 -%K manual pages man page
    1.67 -
    1.68 -%A Gunnar Ritter
    1.69 -%T mail, Mail, mailx, nail-history notes
    1.70 -%D 2007
    1.71 -%O \f(CW\s-1 http://heirloom.sourceforge.net/mailx_history.html\s0
    1.72 -
    1.73  %A Willis H. Ware
    1.74  %T RAND and the Information Evolution: A History in Essays and Vignettes
    1.75  %D 2008
    1.76 @@ -159,37 +140,6 @@
    1.77  %O \s-1ISBN\s0: 0-13-516972-0 
    1.78  %K korn shell
    1.79  
    1.80 -%L mail:\|mta-mua
    1.81 -%H Thread with the subjects:
    1.82 -%J nmh-workers mailing list
    1.83 -%T nmh\ @\ gsoc'', ``external MTA'' and
    1.84 -	``should nmh be an MTA or an MUA?
    1.85 -%D January 2010
    1.86 -%O \h'\\n(.xu-5n' \f(CW\s-1 http://www.mail-archive.com/nmh-workers@nongnu.org/msg01876.html\s0
    1.87 -
    1.88 -%L mail:\|mmh-ann
    1.89 -%A Markus Schnalke
    1.90 -%J nmh-workers mailing list
    1.91 -%T Experimental version: mmh
    1.92 -%D December 8 2011
    1.93 -%O \h'\\n(.xu-5n' \f(CW\s-1 http://www.mail-archive.com/nmh-workers@nongnu.org/msg02503.html\s0
    1.94 -%K mmh announce
    1.95 -
    1.96 -%L mail:\|edginess
    1.97 -%A Paul Vixie
    1.98 -%J nmh-workers mailing list
    1.99 -%T edginess
   1.100 -%D December 26 2011
   1.101 -%O \h'\\n(.xu-5n' \f(CW\s-1 http://www.mail-archive.com/nmh-workers@nongnu.org/msg02582.html\s0
   1.102 -
   1.103 -%L mail:\|attach
   1.104 -%A Markus Schnalke
   1.105 -%J nmh-workers mailing list
   1.106 -%T [patch] snapshot of my MIME handling improvments
   1.107 -%D November 13 2010
   1.108 -%O \h'\\n(.xu-5n' \f(CW\s-1http://lists.nongnu.org/archive/html/nmh-workers/2010-11/msg00111.html\s0
   1.109 -%K attachment proposal
   1.110 -
   1.111  %A Brian W. Kernighan
   1.112  %A Dennis M. Ritchie
   1.113  %T The C Programming Language
   1.114 @@ -279,15 +229,3 @@
   1.115  %C New York
   1.116  %K saint exupery
   1.117  
   1.118 -%L web:\|wolter
   1.119 -%A Jan Wolter
   1.120 -%T DBM Hash Libraries
   1.121 -%B Unix Incompatibility Notes
   1.122 -%D 2000\(en2004
   1.123 -%O \f(CW\s-1http://www.unixpapa.com/incnote/dbm.html\s0
   1.124 -
   1.125 -%L web:\|rickert
   1.126 -%A Neil Rickert
   1.127 -%T Neil Rickert's mh (nmh) scripts
   1.128 -%O \f(CW\s-1 http://faculty.cs.niu.edu/~rickert/mh/\s0
   1.129 -%K mhsign mhpgp
     2.1 --- a/discussion.roff	Thu Jul 12 00:19:09 2012 +0200
     2.2 +++ b/discussion.roff	Thu Jul 12 00:39:41 2012 +0200
     2.3 @@ -3535,7 +3535,7 @@
     2.4  ignores the profile, as quoted by Jeffrey Honig,
     2.5  would have become possible:
     2.6  .[
     2.7 -nmh-workers post profile
     2.8 +nmh-workers honig post profile
     2.9  .]
    2.10  .QS
    2.11  when you run mh commands in a script, you want all the defaults to be
     3.1 --- a/intro.roff	Thu Jul 12 00:19:09 2012 +0200
     3.2 +++ b/intro.roff	Thu Jul 12 00:39:41 2012 +0200
     3.3 @@ -1,6 +1,7 @@
     3.4  .RN 1
     3.5 +.H0 "Introduction
     3.6 +.Id introduction
     3.7  
     3.8 -.H0 "Introduction
     3.9  .P
    3.10  MH is a set of mail handling tools with a common concept, similar to
    3.11  the Unix tool chest, which is a set of file handling tools with a common
    3.12 @@ -16,10 +17,10 @@
    3.13  
    3.14  
    3.15  .H1 "MH \(en the Mail Handler
    3.16 +.Id mh
    3.17  .P
    3.18  MH is a conceptual email system design and its concrete implementation.
    3.19  Notably, MH had started as a design proposal at RAND Corporation,
    3.20 -.\" XXX ref to rand corp.
    3.21  where the first implementation followed later.
    3.22  In spirit, MH is similar to Unix, which
    3.23  influenced the world more in being a set of system design concepts
    3.24 @@ -68,6 +69,7 @@
    3.25  However, the development was revived in December 2011
    3.26  and stayed busy since then.
    3.27  
    3.28 +
    3.29  .U2 "Concepts
    3.30  .P
    3.31  MH consists of a set of tools, each covering a specific task of
    3.32 @@ -174,7 +176,8 @@
    3.33  one needs to know the reasons behind them.
    3.34  This section explains the background.
    3.35  .P
    3.36 -MH predates the Internet; it comes from times before networking was universal,
    3.37 +MH predates the Internet;
    3.38 +it comes from times before networking was universal,
    3.39  it comes from times when emailing was small, short and simple.
    3.40  Then it grew, spread and adapted to the changes email went through.
    3.41  Its core-concepts, however, remained the same.
    3.42 @@ -235,24 +238,25 @@
    3.43  
    3.44  .H1 "mmh
    3.45  .P
    3.46 -.\" XXX which version did I ``fork''?
    3.47  I started to work on my experimental version in October 2011,
    3.48 -at a time when there had been no more than three commits to nmh
    3.49 -since the beginning of the year.
    3.50 +basing my work on nmh version \fInmh-1.3-dev\fP.
    3.51 +At that time no more than three commits were made to nmh
    3.52 +since the beginning of the year, the latest one being
    3.53 +.Ci a01a41d031c796b526329a4170eb23f0ac93b949
    3.54 +on 2011-04-13.
    3.55  In December, when I announced my work in progress on the
    3.56  nmh-workers mailing list,
    3.57  .[
    3.58  nmh-workers mmh announce December
    3.59  .]
    3.60 -nmh's community became active, too.
    3.61 +nmh's community became active, all of a sudden.
    3.62  This movement was heavily pushed by Paul Vixie's ``edginess'' comment.
    3.63  .[
    3.64  nmh-workers vixie edginess
    3.65  .]
    3.66  After long years of stagnation, nmh became actively developed again.
    3.67 -Hence, while I was working on mmh, the community was once more working
    3.68 -on nmh, in parallel.
    3.69 -.\" XXX interaction between nmh and mmh
    3.70 +Hence, while I was working on mmh, the community was working on nmh,
    3.71 +in parallel.
    3.72  .P
    3.73  The name \fImmh\fP may stand for \fImodern mail handler\fP,
    3.74  because the project tries to modernize nmh.
    3.75 @@ -310,8 +314,9 @@
    3.76  Today's pre-packaged software components encourage this model.
    3.77  Mmh is a way to go for this approach.
    3.78  .P
    3.79 -It is worthwhile to fork nmh for the development of mmh, because
    3.80 -the two projects focus on different goals and differ in fundamental questions.
    3.81 +It is worthwhile to fork nmh for the development of mmh,
    3.82 +because the two projects focus on different goals and differ in
    3.83 +fundamental questions.
    3.84  The nmh community's reluctance regarding change conflicts
    3.85  with my strong desire for it.
    3.86  In developing a separate experimental version new approaches can
    3.87 @@ -329,53 +334,53 @@
    3.88  .P
    3.89  Any effort needs to be targeted towards a specific goal
    3.90  in order to be successful.
    3.91 -Following is a description of imagined typical mmh users.
    3.92 -Mmh should satisfy their needs.
    3.93 -.\" XXX  Remove the next sentence?
    3.94 +Therefore, a description of an imagined typical mmh user follows.
    3.95 +Mmh should satisfy his needs.
    3.96  Actually, as mmh is my personal version of MH, this is a description
    3.97  of myself.
    3.98 +Writing software for oneself is a reliable way to produce software
    3.99 +that matches the user's desires.
   3.100  .P
   3.101 -The target users of mmh like Unix and its philosophy.
   3.102 -They appreciate to use programs that are conceptionally appealing.
   3.103 -They are familiar with the command line and enjoy its power.
   3.104 -They are at least capable of shell scripting and want to improve their
   3.105 +The target user of mmh likes Unix and its philosophy.
   3.106 +He appreciates to use programs that are conceptionally appealing.
   3.107 +He is familiar with the command line and enjoys its power.
   3.108 +He is capable of shell scripting and wants to improve his
   3.109  productivity by scripting the mail system.
   3.110 -They use modern email features, such as attachments,
   3.111 +He uses modern email features, such as attachments,
   3.112  non-ASCII text, digital signatures and message encryption in a natural way.
   3.113 -They are able to setup email system components besides mmh,
   3.114 -and actually like to have the choice to pick the ones they prefer.
   3.115 -They have a reasonably modern operating system that complies to the
   3.116 +He is able to set up mail system components,
   3.117 +and like to have the choice to pick the ones he prefers.
   3.118 +He has a reasonably modern operating system that complies to the
   3.119  POSIX and ANSI C standards.
   3.120  .P
   3.121 -The typical users invoke mmh commands directly in an interactive
   3.122 -shell session, but they use them to automate mail handling tasks as well.
   3.123 -Likely, they run their mail setup on a server machine,
   3.124 -to which they connect via ssh.
   3.125 -They might also have local mmh installations on their workstations,
   3.126 -where they tend to work with mmh directly in the shell instead
   3.127 +The typical user invokes mmh commands directly in an interactive
   3.128 +shell session, but he uses them to automate mail handling tasks as well.
   3.129 +Likely, he runs his mail setup on a server machine,
   3.130 +to which he connects via ssh.
   3.131 +He might also have a local mmh installation on his workstation.
   3.132 +Still, he tend to use mmh directly in the shell instead
   3.133  of using graphical front-ends.
   3.134 -They definitely want to be flexible and thus be able to change
   3.135 -their setup to suit their needs.
   3.136 +He definitely wants to be flexible and thus be able to change
   3.137 +his setup to suit his needs.
   3.138  .P
   3.139 -.\" XXX themself vs. themselves
   3.140 -Typical mmh users are programmers themselves.
   3.141 -They like to, occasionally, take the opportunity of Free Software to put
   3.142 -hands on and get involved in the software they use.
   3.143 -Hence, they like small and clean code bases and care for code quality.
   3.144 -In general, they believe that:
   3.145 +The typical mmh user is a programmer.
   3.146 +He likes to, occasionally, take the opportunity of free software to put
   3.147 +hands on and get involved in the software he uses.
   3.148 +In consequence, he likes small and clean code bases and cares for
   3.149 +code quality.
   3.150 +In general, he believes that:
   3.151  .BU
   3.152 -Elegance \(en i.e. simplicity, clarity and generality \(en
   3.153 -is most important.
   3.154 +The elegance of source code is most important.
   3.155  .BU
   3.156 -Concepts are more important than the concrete implementation.
   3.157 +Concepts are more important than concrete implementations.
   3.158  .BU
   3.159 -Code optimizations for anything but readability should be avoided
   3.160 -if possible.
   3.161 +Code optimizations for anything but readability should be avoided.
   3.162  .BU
   3.163  Having a lot of choice is bad.
   3.164  .BU
   3.165  Removed code is debugged code.
   3.166  
   3.167 +
   3.168  .U2 "Goals
   3.169  .P
   3.170  The general goals for the mmh project are the following:
     4.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     4.2 +++ b/mail.bib	Thu Jul 12 00:39:41 2012 +0200
     4.3 @@ -0,0 +1,48 @@
     4.4 +
     4.5 +%L mail:\|mta-mua
     4.6 +%H Thread with the subjects:
     4.7 +%J nmh-workers mailing list
     4.8 +%T nmh\ @\ gsoc'', ``external MTA'' and
     4.9 +	``should nmh be an MTA or an MUA?
    4.10 +%D January 2010
    4.11 +%O \h'\\n(.xu-5n' \f(CW\s-1 http://www.mail-archive.com/nmh-workers@nongnu.org/msg01876.html\s0
    4.12 +
    4.13 +%L mail:\|mmh-ann
    4.14 +%A Markus Schnalke
    4.15 +%J nmh-workers mailing list
    4.16 +%T Experimental version: mmh
    4.17 +%D December 8 2011
    4.18 +%O \h'\\n(.xu-5n' \f(CW\s-1 http://www.mail-archive.com/nmh-workers@nongnu.org/msg02503.html\s0
    4.19 +%K mmh announce
    4.20 +
    4.21 +%L mail:\|edginess
    4.22 +%A Paul Vixie
    4.23 +%J nmh-workers mailing list
    4.24 +%T edginess
    4.25 +%D December 26 2011
    4.26 +%O \h'\\n(.xu-5n' \f(CW\s-1 http://www.mail-archive.com/nmh-workers@nongnu.org/msg02582.html\s0
    4.27 +
    4.28 +%L mail:\|attach
    4.29 +%A Markus Schnalke
    4.30 +%J nmh-workers mailing list
    4.31 +%T [patch] snapshot of my MIME handling improvments
    4.32 +%D November 13 2010
    4.33 +%O \h'\\n(.xu-5n' \f(CW\s-1http://lists.nongnu.org/archive/html/nmh-workers/2010-11/msg00111.html\s0
    4.34 +%K attachment proposal
    4.35 +
    4.36 +%L mail:\|levine
    4.37 +%A David Levine
    4.38 +%J nmh-workers mailing list
    4.39 +%T nmh `post' doesn't read profile, fileproc ignored
    4.40 +%D January 4 2012
    4.41 +%O \h'\\n(.xu-5n' \f(CW\s-1 http://lists.nongnu.org/archive/html/nmh-workers/2012-01/msg00016.html \s0
    4.42 +%K post profile reading
    4.43 +
    4.44 +%L mail:\|honig
    4.45 +%A Jeffrey Honig
    4.46 +%J nmh-workers mailing list
    4.47 +%T nmh `post' doesn't read profile, fileproc ignored
    4.48 +%D January 2 2012
    4.49 +%O \h'\\n(.xu-5n' \f(CW\s-1 http://lists.nongnu.org/archive/html/nmh-workers/2012-01/msg00005.html \s0
    4.50 +%K post profile reading
    4.51 +
     5.1 --- a/makefile	Thu Jul 12 00:19:09 2012 +0200
     5.2 +++ b/makefile	Thu Jul 12 00:39:41 2012 +0200
     5.3 @@ -2,12 +2,13 @@
     5.4  CHAPS = style front.roff dedication.roff toc.roff \
     5.5  	preface.roff intro.roff discussion.roff summary.roff tools.roff \
     5.6  	refs.roff official.roff colophon.roff
     5.7 +BIB = bib *.bib
     5.8  PDFFLAGS = -sPAPERSIZE=a4 -dPDFSETTINGS=/prepress
     5.9 -REFER = refer -n -p bib -p rfcs -e -P -sLAD -l,2 -k
    5.10 +REFER = refer -n -p bib -p mail.bib -p web.bib -e -P -sLAD -l,2 -k
    5.11  
    5.12  all: $(NAME).ps
    5.13  
    5.14 -$(NAME).ps: $(CHAPS) makefile bib rfcs toc.ig refs.ig
    5.15 +$(NAME).ps: $(CHAPS) makefile $(BIB) toc.ig refs.ig
    5.16  	export TROFFONTS=fonts;\
    5.17  	soelim $(CHAPS) | $(REFER) | \
    5.18  		tbl | grap | pic | troff -Tps -ms 2>err.ig | dpost >$@
     6.1 --- a/preface.roff	Thu Jul 12 00:19:09 2012 +0200
     6.2 +++ b/preface.roff	Thu Jul 12 00:39:41 2012 +0200
     6.3 @@ -1,12 +1,23 @@
     6.4  .H0 "Preface" no
     6.5  
     6.6  .P
     6.7 -I have discovered the mail client \fInmh\fP in fall 2009.
     6.8 -At that time I used \fImutt\fP, as many advanced Unix users do.
     6.9 +I have discovered the mail client \fInmh\fP
    6.10 +.[
    6.11 +nmh website homepage
    6.12 +.]
    6.13 +in fall 2009.
    6.14 +At that time I used \fImutt\fP,
    6.15 +.[
    6.16 +mutt website
    6.17 +.]
    6.18 +as many advanced Unix users do.
    6.19  When I read about nmh, its concepts convinced me at once.
    6.20  The transition from mutt to nmh was similar to beginning with
    6.21  file management in the Unix shell when being used to the
    6.22  \fImidnight commander\fP,
    6.23 +.[
    6.24 +midnight commander website
    6.25 +.]
    6.26  or like starting with vi when being used to modeless editors.
    6.27  Such a change is not trivial, but, in being convinced by the
    6.28  concepts and by having done similar transitions for file management
    6.29 @@ -22,8 +33,19 @@
    6.30  expectations were rather common for modern emailing.
    6.31  As a computer scientist and programmer, I wanted to improve the situation.
    6.32  .P
    6.33 -In spring 2010, I sent a message to the \fInmh-workers\fP mailing list,
    6.34 -asking for the possibility to offer a Google Summer of Code project for me.
    6.35 +In spring 2010, I sent a message
    6.36 +.[
    6.37 +nmh-workers gsoc
    6.38 +.]
    6.39 +to the \fInmh-workers\fP mailing list,
    6.40 +.[
    6.41 +nmh-workers mailing list website
    6.42 +.]
    6.43 +asking for the possibility to offer a Google Summer of Code
    6.44 +.[
    6.45 +google summer of code website
    6.46 +.]
    6.47 +project for me.
    6.48  Participating in the development of nmh in this manner appeared attractive
    6.49  to me, because I would have been able to work full time on nmh.
    6.50  Although the nmh community had reacted generally positive to the suggestion,
    6.51 @@ -35,7 +57,7 @@
    6.52  .[
    6.53  nmh-workers thread mta mua
    6.54  .]
    6.55 -I argued for the MTA of nmh to be removed.
    6.56 +I argued for the Mail Transfer Agent of nmh to be removed.
    6.57  In this fundamental question,
    6.58  my opinion differed from the opinion of most others.
    6.59  Sadly, besides the discussions, hardly any real work was done.
    6.60 @@ -48,7 +70,7 @@
    6.61  This brought me back to nmh.
    6.62  Richard Sandelman, an active nmh user, took care of the official basis.
    6.63  Juan Granda, an Argentine free software developer,
    6.64 -provided a computer with Internet connection.
    6.65 +organized a computer with Internet connection.
    6.66  Thanks to them, I was able to work on nmh during my three-month
    6.67  stay in Santiago del Estero, Argentina.
    6.68  Quickly it became obvious that I would not succeed with my main goal,
    6.69 @@ -60,7 +82,7 @@
    6.70  Instead, I improved the code base as I read through it.
    6.71  I found minor bugs for which I proposed fixes.
    6.72  Additionally, I improved the documentation in minor ways.
    6.73 -When I started with larger code changes,
    6.74 +When I started to work on larger code changes,
    6.75  I had to discover that the community was reluctant to change.
    6.76  Its wish for compatibility was much stronger than its
    6.77  wish for convenient out-of-the-box setups \(en in contrast to my opinion.
    6.78 @@ -72,14 +94,15 @@
    6.79  and I still was convinced that I wanted to continue to do so.
    6.80  .P
    6.81  Another half year later, the end of my studies came within reach.
    6.82 -I needed a topic for my master's thesis.
    6.83 +I needed to choose a topic for my master's thesis.
    6.84  Without question, I wanted to work on nmh.
    6.85  But not exactly on nmh, because I had accepted that its
    6.86  community has different goals than I have.
    6.87  Working on nmh would result in much discussion and, in consequence,
    6.88  little progress.
    6.89  After careful thought, I decided to start an experimental version of nmh.
    6.90 -I wanted to implement my own ideas of how an MH-like system should look like.
    6.91 +I wanted to implement my own ideas of how an MH-like system should
    6.92 +look like.
    6.93  I wanted to create a usable alternative version to be compared with
    6.94  the present state of nmh.
    6.95  Eventually, my work would be proven successful or not.
    6.96 @@ -88,8 +111,11 @@
    6.97  .U2 "Focus of this Document
    6.98  .P
    6.99  This document explains the design goals and implementation decisions
   6.100 -for mmh.
   6.101 -.\" XXX mmh taucht hier zum ersten mal auf.
   6.102 +for mmh,
   6.103 +.[
   6.104 +mmh website homepage
   6.105 +.]
   6.106 +an experimental version of nmh.
   6.107  It discusses technical, historical, social and philosophical considerations.
   6.108  On the technical side, this document
   6.109  explains how an existing project was streamlined by removing rough edges
   6.110 @@ -114,7 +140,8 @@
   6.111  .P
   6.112  The reader is expected to be familiar with Unix, C and emailing.
   6.113  Good Unix shell knowledge is required, because MH relies fundamentally
   6.114 -on the shell. Without the power of the shell, MH becomes a motorcycle
   6.115 +on the shell.
   6.116 +Without the power of the shell, MH becomes a motorcycle
   6.117  without winding roads: boring.
   6.118  Introductions to Unix and its shell can be found in \fIThe UNIX Programming
   6.119  Environment\fP by Kernighan and Pike
   6.120 @@ -145,9 +172,13 @@
   6.121  because large parts of the source code are old.
   6.122  The reader is expected to know the format of email messages and
   6.123  the structure of email transfer systems, at least on a basic level.
   6.124 -It's advisable to have cross-read the RFCs 821 and 822.
   6.125 -Furthermore, basic understanding of MIME is good to have.
   6.126 +It's advisable to have cross-read RFC\|821 and RFC\|822.
   6.127 +Furthermore, basic understanding of MIME (RFC\|2045\(en2049)
   6.128 +is good to have.
   6.129  The Wikipedia provides good introduction-level information about email.
   6.130 +.[
   6.131 +wikipedia email
   6.132 +.]
   6.133  .P
   6.134  Frequent references to the Unix philosophy will be made.
   6.135  Gancarz has tried to sum it up in his book
   6.136 @@ -169,11 +200,12 @@
   6.137  .[
   6.138  why unix phil still matters schnalke
   6.139  .]
   6.140 -by myself
   6.141 -provides an overview on the philosophy, including a case study of MH.
   6.142 +by myself provides an overview on the philosophy,
   6.143 +including a case study of MH.
   6.144  .P
   6.145 -Although a brief introduction to MH is provided in Chapter 1, the reader
   6.146 -is encouraged to have a look at the \fIMH Book\fP
   6.147 +Although a brief introduction to MH is provided in Section
   6.148 +.Cf mh ,
   6.149 +the reader is encouraged to have a look at
   6.150  \fIMH & nmh: Email for Users & Programmers\fP by Jerry Peek.
   6.151  .[
   6.152  peek mh
   6.153 @@ -204,8 +236,8 @@
   6.154  a look into the future of the mmh project.
   6.155  .P
   6.156  .I "Italic font
   6.157 -is used to emphasize new terms, and to name software projects and
   6.158 -man pages.
   6.159 +is used to emphasize new terms, and for names of software projects,
   6.160 +literature, and man pages.
   6.161  .CW "Constant width font
   6.162  is used to denote names of programs, files,
   6.163  functions, command lines, code excrepts, program input and output.
   6.164 @@ -216,18 +248,31 @@
   6.165  .Pn cat ,
   6.166  which is in section one of the Unix manual.
   6.167  Internet technologies are specified by \fIRequests for Comments\fP (RFCs).
   6.168 -Throughout the document, they are referenced in this way ``RFC\|822''.
   6.169 +Throughout the document, they are referenced as ``RFC\|821''.
   6.170  A list of relevant RFCs is located at the end of the document.
   6.171 -References to literature are printed in backets, like
   6.172 +Literature is cited in backets, such as
   6.173  .[ ``[
   6.174  kernighan pike unix programming env
   6.175 -.]]'', within the text.
   6.176 -The full references are collected at the end of the document.
   6.177 +.]]''.
   6.178 +Citations of email messages and websites are in the same style
   6.179 +but distinguished by a prefix.
   6.180 +For example:
   6.181 +.[ ``[
   6.182 +website mmh
   6.183 +.]]''
   6.184 +and
   6.185 +.[ ``[
   6.186 +nmh-workers mmh announce
   6.187 +.]]''.
   6.188 +All references are collected at the end of the document.
   6.189  .P
   6.190  This document describes practical programming work.
   6.191 -The code of mmh is managed by the
   6.192 +The code of mmh is managed with the
   6.193  .Pn git
   6.194  version control system.
   6.195 +.[
   6.196 +git website
   6.197 +.]
   6.198  All code changes were checked in.
   6.199  In the discussions, references to corresponding code changes are printed
   6.200  as ``\c
   6.201 @@ -239,9 +284,15 @@
   6.202  replacing `\f(CWXXX\fP' with the concrete hash value or any unique prefix.
   6.203  In this example:
   6.204  .Cl "git show 1a2b3c4" .
   6.205 -At the time of writing, changesets can be looked up online this way:
   6.206 +At the time of writing, changesets can be looked up online at:
   6.207  .CW "http://git.marmaro.de/?p=mmh;a=commitdiff;h=XXX" .
   6.208  But as we all know, URIs are always at risk to change.
   6.209 +.P
   6.210 +Whenever lines of code were determined, David A. Wheeler's \fIsloccount\fP
   6.211 +.[
   6.212 +sloccount website
   6.213 +.]
   6.214 +was used to measure the amount in a comparable way.
   6.215  
   6.216  
   6.217  .U2 "Acknowledgments
     7.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     7.2 +++ b/web.bib	Thu Jul 12 00:39:41 2012 +0200
     7.3 @@ -0,0 +1,75 @@
     7.4 +
     7.5 +%L web:\|wolter
     7.6 +%A Jan Wolter
     7.7 +%T DBM Hash Libraries
     7.8 +%B Unix Incompatibility Notes
     7.9 +%D 2000\(en2004
    7.10 +%O \f(CW\s-1http://www.unixpapa.com/incnote/dbm.html\s0
    7.11 +
    7.12 +%L web:\|rickert
    7.13 +%T Neil Rickert's mh (nmh) scripts
    7.14 +%O \f(CW\s-1 http://faculty.cs.niu.edu/~rickert/mh/\s0
    7.15 +%K mhsign mhpgp
    7.16 +
    7.17 +%L web:\|nmh
    7.18 +%H Website of
    7.19 +%T nmh
    7.20 +%O \f(CW\s-1 http://nmh.nongnu.org \s0
    7.21 +%K homepage
    7.22 +
    7.23 +%L web:\|mmh
    7.24 +%H Website of
    7.25 +%T mmh
    7.26 +%O \f(CW\s-1 http://marmaro.de/prog/mmh/ \s0
    7.27 +%K homepage
    7.28 +
    7.29 +%L web:\|mutt
    7.30 +%H Website of
    7.31 +%T mutt
    7.32 +%O \f(CW\s-1 http://www.mutt.org \s0
    7.33 +
    7.34 +%L web:\|git
    7.35 +%H Website of
    7.36 +%T git
    7.37 +%O \f(CW\s-1 http://git-scm.com \s0
    7.38 +
    7.39 +%L web:\|sloccount
    7.40 +%H Website of
    7.41 +%T sloccount
    7.42 +%O \f(CW\s-1 http://www.dwheeler.com/sloccount/ \s0
    7.43 +
    7.44 +%L web:\|wp-email
    7.45 +%T Email
    7.46 +%A Wikipedia
    7.47 +%O \f(CW\s-1 http://en.wikipedia.org/wiki/Email \s0
    7.48 +
    7.49 +%L web:\|gsoc
    7.50 +%H Website of
    7.51 +%T Google Summer of Code
    7.52 +%O \f(CW\s-1 http://code.google.com/soc/ \s0
    7.53 +%K gsoc
    7.54 +
    7.55 +%L web:\|mc
    7.56 +%H Website of
    7.57 +%T midnight commander
    7.58 +%O \f(CW\s-1 http://code.google.com/soc/ \s0
    7.59 +
    7.60 +%L web:\|UP
    7.61 +%A Wikipedia, The Free Encyclopedia
    7.62 +%T Unix philosophy
    7.63 +%D Version of 2010-03-21 17:20 UTC
    7.64 +%O \f(CW\s-1 http://en.wikipedia.org/wiki/Unix_philosophy \s0
    7.65 +
    7.66 +%L web:\|mailx
    7.67 +%A Gunnar Ritter
    7.68 +%T mail, Mail, mailx, nail-history notes
    7.69 +%D 2007
    7.70 +%O \f(CW\s-1 http://heirloom.sourceforge.net/mailx_history.html \s0
    7.71 +
    7.72 +%L web:\|nmh-workers
    7.73 +%H Website of
    7.74 +%T nmh-workers mailing list
    7.75 +%O \f(CW\s-1 https://lists.nongnu.org/mailman/listinfo/nmh-workers\s0.
    7.76 +	Alternative mailing list archive:
    7.77 +	\f(CW\s-1 http://www.mhonarc.org/archive/html/nmh-workers/ \s0
    7.78 +