# HG changeset patch # User markus schnalke # Date 1342372595 -7200 # Node ID 1fa5a74bf1380aecc3657927a9372ae1dac6773d # Parent 2427d1dadb57ed7fda990808d5d0c28c6a2569bd Reworked References structure: Collect them all in one Chapter. Have list of websites separately. diff -r 2427d1dadb57 -r 1fa5a74bf138 discussion.roff --- a/discussion.roff Sun Jul 15 18:42:08 2012 +0200 +++ b/discussion.roff Sun Jul 15 19:16:35 2012 +0200 @@ -75,19 +75,8 @@ Instead, the aspects of email should be covered by multiple projects, which then can be combined to form a complete system. Excellent implementations for the various aspects of email already exist. -Just to name three examples: Postfix -.[ -postfix website -.] -is a specialized MTA, Procmail -.[ -procmail website -.] -is a specialized MDA, and Fetchmail -.[ -fetchmail website -.] -is a specialized MRA. +Just to name three examples: Postfix is a specialized MTA, Procmail +is a specialized MDA, and Fetchmail is a specialized MRA. I believe that it is best to use such specialized tools instead of providing the same function once more as a side component. .P @@ -126,9 +115,6 @@ Focusing on one mail agent role only, is motivated by Eric Allman's experience with Sendmail. He identified the limitation of Sendmail -.[ -sendmail website -.] to the MTA task as one reason for its success: .[ [ costales sendmail @@ -164,11 +150,7 @@ It must read the message from the standard input, extract the recipient addresses from the message header, and hand the message over to the MSA. -For example, a wrapper script for qmail -.[ -qmail website -.] -would be: +For example, a wrapper script for qmail would be: .VS #!/bin/sh exec qmail-inject # ignore command line arguments @@ -312,39 +294,11 @@ Also, the popular MSAs and MRAs have large communities and a lot of available documentation. -Choices for MSAs range from small forwarders such as -.[ -ssmtp website -.] -and, -.[ -nullmailer website -.] -over mid-size MTAs including -.[ -masqmail website -.] -and, -.[ -dma dragonfly mail agent website -.] -up to full-featured MTAs as for instance. -.[ -postfix website -.] -MRAs are provided for example by -.[ [ -fetchmail website -.] -.[ -getmail website -.] -.[ -mpop website -.] -.[ -fdm website -.]]. +Choices for MSAs range from small forwarders such as \fIssmtp\fP and +\fInullmailer\fP, over mid-size MTAs including \fImasqmail\fP and +\fIdma\fP, up to full-featured MTAs as for instance \fIPostfix\fP. +MRAs are provided for example by \fIfetchmail\fP, \fIgetmail\fP, +\fImpop\fP, and \fIfdm\fP. .H2 "Non-MUA Tools @@ -904,9 +858,6 @@ .Sw --disable-mhe was removed when the MH-E support was reworked. MH-E is the Emacs front-end to MH. -.[ -mh-e emacs website -.] It requires MH to provide minor additional functions. The .Sw --disable-mhe @@ -2414,10 +2365,7 @@ .Pn mhsign handles the signing and encrypting part. It comprises about 250 lines of shell code and interfaces between -.Pn gnupg " -.[ -gnupg website -.] +.Pn gnupg and the MH system. It was meant to be invoked manually at the WhatNow prompt, but in mmh, .Pn send diff -r 2427d1dadb57 -r 1fa5a74bf138 intro.roff --- a/intro.roff Sun Jul 15 18:42:08 2012 +0200 +++ b/intro.roff Sun Jul 15 19:16:35 2012 +0200 @@ -269,17 +269,10 @@ following my visions and preferences. (My login name is \fImeillo\fP.) This project model was inspired by \fIdwm\fP, -.[ -dwm website -.] which is Anselm Garbe's personal window manager \(en targeted to satisfy Garbe's personal needs whenever conflicts appear. Dwm has retained its lean elegance and its focused character, whereas -its community-driven predecessor \fIwmii\fP -.[ -wmii website -.] -had grown fat over time. +its community-driven predecessor \fIwmii\fP had grown fat over time. The development of mmh should remain focused. diff -r 2427d1dadb57 -r 1fa5a74bf138 makefile --- a/makefile Sun Jul 15 18:42:08 2012 +0200 +++ b/makefile Sun Jul 15 19:16:35 2012 +0200 @@ -1,7 +1,7 @@ NAME = thesis CHAPS = style front.roff dedication.roff toc.roff \ preface.roff intro.roff discussion.roff summary.roff tools.roff \ - refs.roff rfcs.roff official.roff colophon.roff + refs.roff official.roff colophon.roff BIB = bib *.bib PDFFLAGS = -sPAPERSIZE=a4 -dPDFSETTINGS=/prepress REFER = refer -n -p bib -p mail.bib -p web.bib -e -P -sLAD -l,2 -k diff -r 2427d1dadb57 -r 1fa5a74bf138 preface.roff --- a/preface.roff Sun Jul 15 18:42:08 2012 +0200 +++ b/preface.roff Sun Jul 15 19:16:35 2012 +0200 @@ -2,22 +2,13 @@ .P I have discovered the mail client \fInmh\fP -.[ -nmh website homepage -.] in fall 2009. At that time I used \fImutt\fP, -.[ -mutt website -.] as many advanced Unix users do. When I read about nmh, its concepts convinced me at once. The transition from mutt to nmh was similar to beginning with file management in the Unix shell when being used to the \fImidnight commander\fP, -.[ -midnight commander website -.] or like starting with vi when being used to modeless editors. Such a change is not trivial, but, in being convinced by the concepts and by having done similar transitions for file management @@ -112,9 +103,6 @@ .P This document explains the design goals and implementation decisions for mmh, -.[ -mmh website homepage -.] an experimental version of nmh. It discusses technical, historical, social and philosophical considerations. On the technical side, this document @@ -257,14 +245,13 @@ Citations of email messages and websites are distinguished by ``mail:'' and ``web:'' prefixes. All references are collected at the end of the document. +The websites of the software projects mentioned are collected +in a list in the appendix. .P This document describes practical programming work. The code of mmh is managed with the .Pn git version control system. -.[ -git website -.] All code changes were checked in. In the discussions, references to corresponding code changes are printed as ``\c @@ -281,14 +268,9 @@ But as we all know, URIs are always at risk to change. .P Whenever lines of code were determined, David A. Wheeler's \fIsloccount\fP -.[ -sloccount website -.] was used to measure the amount in a comparable way. .U2 "Acknowledgments .P -To be written at the very end. -.P -XXX FIXME +.\"so thanks diff -r 2427d1dadb57 -r 1fa5a74bf138 refs.roff --- a/refs.roff Sun Jul 15 18:42:08 2012 +0200 +++ b/refs.roff Sun Jul 15 19:16:35 2012 +0200 @@ -3,3 +3,91 @@ .[ $LIST$ .] + + + +.H1 "Requests for Comments" no +.sp + +.IP RFC\|821 +.I "Simple Mail Transfer Protocol", +August 1982. + +.IP RFC\|822 +.I "Standard for the Format of ARPA Internet Text Messages", +August 1982. + +.IP RFC\|1864 +.I "The Content-MD5 Header Field", +October 1995. + +.IP RFC\|2045 +.I "Multipurpose Internet Mail Extensions (MIME) Part One: \ + Format of Internet Message Bodies" , +November 1996. + +.IP RFC\|2046 +.I "Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types" , +November 1996. + +.IP RFC\|2047 +.I "MIME (Multipurpose Internet Mail Extensions) Part Three: \ + Message Header Extensions for Non-ASCII Text" , +November 1996. + +.IP RFC\|2048 +.I "Multipurpose Internet Mail Extensions (MIME) Part Four: \ + Registration Procedures" , +November 1996. + +.IP RFC\|2049 +.I "Multipurpose Internet Mail Extensions (MIME) Part Five: \ + Conformance Criteria and Examples" , +November 1996. + +.IP RFC\|2822 +.I "Internet Message Format", +April 2001. + +.IP RFC\|3156 +.I "MIME Security with OpenPGP", +August 2001. + +.IP RFC\|4880 +.I "OpenPGP Message Format", +November 2007. + + + + + + +.H1 "Websites of Software Projects" no +.sp + +.TS +; +lfI lfU. +dma https://github.com/corecode/dma +dwm http://dwm.suckless.org +fdm http://fdm.sourceforge.net +fetchmail http://www.fetchmail.info +getmail http://pyropus.ca/software/getmail/ +git http://git-scm.com +gnupg http://www.gnupg.org +masqmail http://marmaro.de/prog/masqmail/ +midnight commander http://www.gnu.org/software/mc/ +MH-E http://mh-e.sourceforge.net +mmh http://marmaro.de/prog/mmh/ +mpop http://mpop.sourceforge.net +mutt http://www.mutt.org +nmh http://nmh.nongnu.org +nullmailer http://untroubled.org/nullmailer/ +Postfix http://www.postfix.org +procmail http://www.procmail.org +qmail http://cr.yp.to/qmail.html +Sendmail http://www.sendmail.com +sloccount http://www.dwheeler.com/sloccount/ +ssmtp http://packages.qa.debian.org/s/ssmtp.html +wmii http://wmii.suckless.org +.TE diff -r 2427d1dadb57 -r 1fa5a74bf138 rfcs.roff --- a/rfcs.roff Sun Jul 15 18:42:08 2012 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,65 +0,0 @@ -.H- "Requests for Comments -.P -RFCs document the Internet. They are published by the -.I "Internet Engineering Task Force -(IETF). -Any particular RFC is located at: -.VS -http://www.ietf.org/rfc/rfcNNNN.txt -VE -The placeholder `\fLNNNN\fP' needs to be replaced with the four-digit -number of the RFC. -RFC\|821, for example, can be found at -.Fn http://www.ietf.org/rfc/rfc0821.txt . -.P -The following list of contains all RFCs referenced in this document. -.sp - -.IP RFC\|821 -.I "Simple Mail Transfer Protocol", -August 1982. - -.IP RFC\|822 -.I "Standard for the Format of ARPA Internet Text Messages", -August 1982. - -.IP RFC\|1864 -.I "The Content-MD5 Header Field", -October 1995. - -.IP RFC\|2045 -.I "Multipurpose Internet Mail Extensions (MIME) Part One: \ - Format of Internet Message Bodies" , -November 1996. - -.IP RFC\|2046 -.I "Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types" , -November 1996. - -.IP RFC\|2047 -.I "MIME (Multipurpose Internet Mail Extensions) Part Three: \ - Message Header Extensions for Non-ASCII Text" , -November 1996. - -.IP RFC\|2048 -.I "Multipurpose Internet Mail Extensions (MIME) Part Four: \ - Registration Procedures" , -November 1996. - -.IP RFC\|2049 -.I "Multipurpose Internet Mail Extensions (MIME) Part Five: \ - Conformance Criteria and Examples" , -November 1996. - -.IP RFC\|2822 -.I "Internet Message Format", -April 2001. - -.IP RFC\|3156 -.I "MIME Security with OpenPGP", -August 2001. - -.IP RFC\|4880 -.I "OpenPGP Message Format", -November 2007. - diff -r 2427d1dadb57 -r 1fa5a74bf138 web.bib --- a/web.bib Sun Jul 15 18:42:08 2012 +0200 +++ b/web.bib Sun Jul 15 19:16:35 2012 +0200 @@ -5,33 +5,6 @@ %O \fU http://\:faculty.cs.niu.edu/\:~rickert/\:mh/ %K mhsign mhpgp -%L web:\|nmh -%H Website of -%T nmh -%O \fU http://\:nmh.nongnu.org -%K homepage - -%L web:\|mmh -%H Website of -%T mmh -%O \fU http://\:marmaro.de/\:prog/\:mmh/ -%K homepage - -%L web:\|mutt -%H Website of -%T mutt -%O \fU http://\:www.mutt.org - -%L web:\|git -%H Website of -%T git -%O \fU http://\:git-scm.com - -%L web:\|sloccount -%H Website of -%T sloccount -%O \fU http://\:www.dwheeler.com/\:sloccount/ - %L web:\|email %T Email %A Wikipedia @@ -43,23 +16,12 @@ %O \fU http://\:code.google.com/\:soc/ %K gsoc -%L web:\|mc -%H Website of -%T midnight commander -%O \fU http://\:www.gnu.org/\:software/\:mc/ - %L web:\|UP %A Wikipedia, The Free Encyclopedia %T Unix philosophy %D Version of 2010-03-21 17:20 UTC %O \fU http://\:en.wikipedia.org/\:wiki/\:Unix_philosophy -%L web:\|mailx -%A Gunnar Ritter -%T mail, Mail, mailx, nail-history notes -%D 2007 -%O \fU http://\:heirloom.sourceforge.net/\:mailx_history.html - %L web:\|nmh-workers %H Website of %T nmh-workers mailing list @@ -76,83 +38,3 @@ %T History of MH %O \fU http://rand-mh.sourceforge.net/book/overall/hiofmh.html %K website - -%L web:\|dwm -%H Website of -%T dwm -%O \fU http://\:dwm.suckless.org - -%L web:\|wmii -%H Website of -%T wmii -%O \fU http://\:wmii.suckless.org - -%L web:\|postfix -%H Website of -%T Postfix -%O \fU http://\:www.postfix.org - -%L web:\|procmail -%H Website of -%T Procmail -%O \fU http://\:www.procmail.org - -%L web:\|fetchmail -%H Website of -%T Fetchmail -%O \fU http://\:www.fetchmail.info - -%L web:\|sendmail -%H Website of -%T Sendmail -%O \fU http://\:www.sendmail.com - -%L web:\|qmail -%H Website of -%T qmail -%O \fU http://\:cr.yp.to/\:qmail.html - -%L web:\|dma -%H Website of -%T dma, the DragonFly Mail Agent -%O \fU https://github.com/corecode/dma - -%L web:\|mpop -%H Website of -%T mpop -%O \fU http://mpop.sourceforge.net - -%L web:\|getmail -%H Website of -%T getmail -%O \fU http://pyropus.ca/software/getmail/ - -%L web:\|fdm -%H Website of -%T fdm -%O \fU http://fdm.sourceforge.net - -%L web:\|masqmail -%H Website of -%T masqmail -%O \fU http://marmaro.de/prog/masqmail/ - -%L web:\|nullmailer -%H Website of -%T nullmailer -%O \fU http://untroubled.org/nullmailer/ - -%L web:\|ssmtp -%H Website of -%T ssmtp -%O \fU http://packages.qa.debian.org/s/ssmtp.html - -%L web:\|mh-e -%H Website of -%T MH-E, the Emacs Interface to the MH Mail System -%O \fU http://mh-e.sourceforge.net - -%L web:\|gpg -%H Website of -%T GnuPG -%O \fU http://www.gnupg.org