docs/master

changeset 223:1fa5a74bf138

Reworked References structure: Collect them all in one Chapter. Have list of websites separately.
author markus schnalke <meillo@marmaro.de>
date Sun, 15 Jul 2012 19:16:35 +0200
parents 2427d1dadb57
children b0e83cfde2bf
files discussion.roff intro.roff makefile preface.roff refs.roff rfcs.roff web.bib
diffstat 7 files changed, 102 insertions(+), 274 deletions(-) [+]
line diff
     1.1 --- a/discussion.roff	Sun Jul 15 18:42:08 2012 +0200
     1.2 +++ b/discussion.roff	Sun Jul 15 19:16:35 2012 +0200
     1.3 @@ -75,19 +75,8 @@
     1.4  Instead, the aspects of email should be covered by multiple projects,
     1.5  which then can be combined to form a complete system.
     1.6  Excellent implementations for the various aspects of email already exist.
     1.7 -Just to name three examples: Postfix
     1.8 -.[
     1.9 -postfix website
    1.10 -.]
    1.11 -is a specialized MTA, Procmail
    1.12 -.[
    1.13 -procmail website
    1.14 -.]
    1.15 -is a specialized MDA, and Fetchmail
    1.16 -.[
    1.17 -fetchmail website
    1.18 -.]
    1.19 -is a specialized MRA.
    1.20 +Just to name three examples: Postfix is a specialized MTA, Procmail
    1.21 +is a specialized MDA, and Fetchmail is a specialized MRA.
    1.22  I believe that it is best to use such specialized tools instead of
    1.23  providing the same function once more as a side component.
    1.24  .P
    1.25 @@ -126,9 +115,6 @@
    1.26  Focusing on one mail agent role only, is motivated by Eric Allman's
    1.27  experience with Sendmail.
    1.28  He identified the limitation of Sendmail
    1.29 -.[
    1.30 -sendmail website
    1.31 -.]
    1.32  to the MTA task as one reason for its success:
    1.33  .[ [
    1.34  costales sendmail
    1.35 @@ -164,11 +150,7 @@
    1.36  It must read the message from the standard input, extract the
    1.37  recipient addresses from the message header, and hand the message
    1.38  over to the MSA.
    1.39 -For example, a wrapper script for qmail
    1.40 -.[
    1.41 -qmail website
    1.42 -.]
    1.43 -would be:
    1.44 +For example, a wrapper script for qmail would be:
    1.45  .VS
    1.46  #!/bin/sh
    1.47  exec qmail-inject  # ignore command line arguments
    1.48 @@ -312,39 +294,11 @@
    1.49  Also, the popular MSAs and MRAs have large communities and a lot
    1.50  of available documentation.
    1.51  
    1.52 -Choices for MSAs range from small forwarders such as
    1.53 -.[
    1.54 -ssmtp website
    1.55 -.]
    1.56 -and,
    1.57 -.[
    1.58 -nullmailer website
    1.59 -.]
    1.60 -over mid-size MTAs including
    1.61 -.[
    1.62 -masqmail website
    1.63 -.]
    1.64 -and,
    1.65 -.[
    1.66 -dma dragonfly mail agent website
    1.67 -.]
    1.68 -up to full-featured MTAs as for instance.
    1.69 -.[
    1.70 -postfix website
    1.71 -.]
    1.72 -MRAs are provided for example by
    1.73 -.[ [
    1.74 -fetchmail website
    1.75 -.]
    1.76 -.[
    1.77 -getmail website
    1.78 -.]
    1.79 -.[
    1.80 -mpop website
    1.81 -.]
    1.82 -.[
    1.83 -fdm website
    1.84 -.]].
    1.85 +Choices for MSAs range from small forwarders such as \fIssmtp\fP and
    1.86 +\fInullmailer\fP, over mid-size MTAs including \fImasqmail\fP and
    1.87 +\fIdma\fP, up to full-featured MTAs as for instance \fIPostfix\fP.
    1.88 +MRAs are provided for example by \fIfetchmail\fP, \fIgetmail\fP,
    1.89 +\fImpop\fP, and \fIfdm\fP.
    1.90  
    1.91  
    1.92  .H2 "Non-MUA Tools
    1.93 @@ -904,9 +858,6 @@
    1.94  .Sw --disable-mhe
    1.95  was removed when the MH-E support was reworked. 
    1.96  MH-E is the Emacs front-end to MH.
    1.97 -.[
    1.98 -mh-e emacs website
    1.99 -.]
   1.100  It requires MH to provide minor additional functions.
   1.101  The
   1.102  .Sw --disable-mhe
   1.103 @@ -2414,10 +2365,7 @@
   1.104  .Pn mhsign
   1.105  handles the signing and encrypting part.
   1.106  It comprises about 250 lines of shell code and interfaces between
   1.107 -.Pn gnupg "
   1.108 -.[
   1.109 -gnupg website
   1.110 -.]
   1.111 +.Pn gnupg
   1.112  and the MH system.
   1.113  It was meant to be invoked manually at the WhatNow prompt, but in mmh,
   1.114  .Pn send
     2.1 --- a/intro.roff	Sun Jul 15 18:42:08 2012 +0200
     2.2 +++ b/intro.roff	Sun Jul 15 19:16:35 2012 +0200
     2.3 @@ -269,17 +269,10 @@
     2.4  following my visions and preferences.
     2.5  (My login name is \fImeillo\fP.)
     2.6  This project model was inspired by \fIdwm\fP,
     2.7 -.[
     2.8 -dwm website
     2.9 -.]
    2.10  which is Anselm Garbe's personal window manager \(en
    2.11  targeted to satisfy Garbe's personal needs whenever conflicts appear.
    2.12  Dwm has retained its lean elegance and its focused character, whereas
    2.13 -its community-driven predecessor \fIwmii\fP
    2.14 -.[
    2.15 -wmii website
    2.16 -.]
    2.17 -had grown fat over time.
    2.18 +its community-driven predecessor \fIwmii\fP had grown fat over time.
    2.19  The development of mmh should remain focused.
    2.20  
    2.21  
     3.1 --- a/makefile	Sun Jul 15 18:42:08 2012 +0200
     3.2 +++ b/makefile	Sun Jul 15 19:16:35 2012 +0200
     3.3 @@ -1,7 +1,7 @@
     3.4  NAME = thesis
     3.5  CHAPS = style front.roff dedication.roff toc.roff \
     3.6  	preface.roff intro.roff discussion.roff summary.roff tools.roff \
     3.7 -	refs.roff rfcs.roff official.roff colophon.roff
     3.8 +	refs.roff official.roff colophon.roff
     3.9  BIB = bib *.bib
    3.10  PDFFLAGS = -sPAPERSIZE=a4 -dPDFSETTINGS=/prepress
    3.11  REFER = refer -n -p bib -p mail.bib -p web.bib -e -P -sLAD -l,2 -k
     4.1 --- a/preface.roff	Sun Jul 15 18:42:08 2012 +0200
     4.2 +++ b/preface.roff	Sun Jul 15 19:16:35 2012 +0200
     4.3 @@ -2,22 +2,13 @@
     4.4  
     4.5  .P
     4.6  I have discovered the mail client \fInmh\fP
     4.7 -.[
     4.8 -nmh website homepage
     4.9 -.]
    4.10  in fall 2009.
    4.11  At that time I used \fImutt\fP,
    4.12 -.[
    4.13 -mutt website
    4.14 -.]
    4.15  as many advanced Unix users do.
    4.16  When I read about nmh, its concepts convinced me at once.
    4.17  The transition from mutt to nmh was similar to beginning with
    4.18  file management in the Unix shell when being used to the
    4.19  \fImidnight commander\fP,
    4.20 -.[
    4.21 -midnight commander website
    4.22 -.]
    4.23  or like starting with vi when being used to modeless editors.
    4.24  Such a change is not trivial, but, in being convinced by the
    4.25  concepts and by having done similar transitions for file management
    4.26 @@ -112,9 +103,6 @@
    4.27  .P
    4.28  This document explains the design goals and implementation decisions
    4.29  for mmh,
    4.30 -.[
    4.31 -mmh website homepage
    4.32 -.]
    4.33  an experimental version of nmh.
    4.34  It discusses technical, historical, social and philosophical considerations.
    4.35  On the technical side, this document
    4.36 @@ -257,14 +245,13 @@
    4.37  Citations of email messages and websites are distinguished by
    4.38  ``mail:'' and ``web:'' prefixes.
    4.39  All references are collected at the end of the document.
    4.40 +The websites of the software projects mentioned are collected
    4.41 +in a list in the appendix.
    4.42  .P
    4.43  This document describes practical programming work.
    4.44  The code of mmh is managed with the
    4.45  .Pn git
    4.46  version control system.
    4.47 -.[
    4.48 -git website
    4.49 -.]
    4.50  All code changes were checked in.
    4.51  In the discussions, references to corresponding code changes are printed
    4.52  as ``\c
    4.53 @@ -281,14 +268,9 @@
    4.54  But as we all know, URIs are always at risk to change.
    4.55  .P
    4.56  Whenever lines of code were determined, David A. Wheeler's \fIsloccount\fP
    4.57 -.[
    4.58 -sloccount website
    4.59 -.]
    4.60  was used to measure the amount in a comparable way.
    4.61  
    4.62  
    4.63  .U2 "Acknowledgments
    4.64  .P
    4.65 -To be written at the very end.
    4.66 -.P
    4.67 -XXX FIXME
    4.68 +.\"so thanks
     5.1 --- a/refs.roff	Sun Jul 15 18:42:08 2012 +0200
     5.2 +++ b/refs.roff	Sun Jul 15 19:16:35 2012 +0200
     5.3 @@ -3,3 +3,91 @@
     5.4  .[
     5.5  $LIST$
     5.6  .]
     5.7 +
     5.8 +
     5.9 +
    5.10 +.H1 "Requests for Comments" no
    5.11 +.sp
    5.12 +
    5.13 +.IP RFC\|821
    5.14 +.I "Simple Mail Transfer Protocol",
    5.15 +August 1982.
    5.16 +
    5.17 +.IP RFC\|822
    5.18 +.I "Standard for the Format of ARPA Internet Text Messages",
    5.19 +August 1982.
    5.20 +
    5.21 +.IP RFC\|1864
    5.22 +.I "The Content-MD5 Header Field",
    5.23 +October 1995.
    5.24 +
    5.25 +.IP RFC\|2045
    5.26 +.I "Multipurpose Internet Mail Extensions (MIME) Part One: \
    5.27 +	Format of Internet Message Bodies" ,
    5.28 +November 1996.
    5.29 +
    5.30 +.IP RFC\|2046
    5.31 +.I "Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types" ,
    5.32 +November 1996.
    5.33 +
    5.34 +.IP RFC\|2047
    5.35 +.I "MIME (Multipurpose Internet Mail Extensions) Part Three: \
    5.36 +	Message Header Extensions for Non-ASCII Text" ,
    5.37 +November 1996.
    5.38 +
    5.39 +.IP RFC\|2048
    5.40 +.I "Multipurpose Internet Mail Extensions (MIME) Part Four: \
    5.41 +	Registration Procedures" ,
    5.42 +November 1996.
    5.43 +
    5.44 +.IP RFC\|2049
    5.45 +.I "Multipurpose Internet Mail Extensions (MIME) Part Five: \
    5.46 +	Conformance Criteria and Examples" ,
    5.47 +November 1996.
    5.48 +
    5.49 +.IP RFC\|2822
    5.50 +.I "Internet Message Format",
    5.51 +April 2001.
    5.52 +
    5.53 +.IP RFC\|3156
    5.54 +.I "MIME Security with OpenPGP",
    5.55 +August 2001.
    5.56 +
    5.57 +.IP RFC\|4880
    5.58 +.I "OpenPGP Message Format",
    5.59 +November 2007.
    5.60 +
    5.61 +
    5.62 +
    5.63 +
    5.64 +
    5.65 +
    5.66 +.H1 "Websites of Software Projects" no
    5.67 +.sp
    5.68 +
    5.69 +.TS
    5.70 +;
    5.71 +lfI lfU.
    5.72 +dma	https://github.com/corecode/dma
    5.73 +dwm	http://dwm.suckless.org
    5.74 +fdm	http://fdm.sourceforge.net
    5.75 +fetchmail	http://www.fetchmail.info
    5.76 +getmail	http://pyropus.ca/software/getmail/
    5.77 +git	http://git-scm.com
    5.78 +gnupg	http://www.gnupg.org
    5.79 +masqmail	http://marmaro.de/prog/masqmail/
    5.80 +midnight commander	http://www.gnu.org/software/mc/
    5.81 +MH-E	http://mh-e.sourceforge.net
    5.82 +mmh	http://marmaro.de/prog/mmh/
    5.83 +mpop	http://mpop.sourceforge.net
    5.84 +mutt	http://www.mutt.org
    5.85 +nmh	http://nmh.nongnu.org
    5.86 +nullmailer	http://untroubled.org/nullmailer/
    5.87 +Postfix	http://www.postfix.org
    5.88 +procmail	http://www.procmail.org
    5.89 +qmail	http://cr.yp.to/qmail.html
    5.90 +Sendmail	http://www.sendmail.com
    5.91 +sloccount	http://www.dwheeler.com/sloccount/
    5.92 +ssmtp	http://packages.qa.debian.org/s/ssmtp.html
    5.93 +wmii	http://wmii.suckless.org
    5.94 +.TE
     6.1 --- a/rfcs.roff	Sun Jul 15 18:42:08 2012 +0200
     6.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     6.3 @@ -1,65 +0,0 @@
     6.4 -.H- "Requests for Comments
     6.5 -.P
     6.6 -RFCs document the Internet. They are published by the
     6.7 -.I "Internet Engineering Task Force
     6.8 -(IETF).
     6.9 -Any particular RFC is located at:
    6.10 -.VS
    6.11 -http://www.ietf.org/rfc/rfcNNNN.txt
    6.12 -VE
    6.13 -The placeholder `\fLNNNN\fP' needs to be replaced with the four-digit
    6.14 -number of the RFC.
    6.15 -RFC\|821, for example, can be found at
    6.16 -.Fn http://www.ietf.org/rfc/rfc0821.txt .
    6.17 -.P
    6.18 -The following list of contains all RFCs referenced in this document.
    6.19 -.sp
    6.20 -
    6.21 -.IP RFC\|821
    6.22 -.I "Simple Mail Transfer Protocol",
    6.23 -August 1982.
    6.24 -
    6.25 -.IP RFC\|822
    6.26 -.I "Standard for the Format of ARPA Internet Text Messages",
    6.27 -August 1982.
    6.28 -
    6.29 -.IP RFC\|1864
    6.30 -.I "The Content-MD5 Header Field",
    6.31 -October 1995.
    6.32 -
    6.33 -.IP RFC\|2045
    6.34 -.I "Multipurpose Internet Mail Extensions (MIME) Part One: \
    6.35 -	Format of Internet Message Bodies" ,
    6.36 -November 1996.
    6.37 -
    6.38 -.IP RFC\|2046
    6.39 -.I "Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types" ,
    6.40 -November 1996.
    6.41 -
    6.42 -.IP RFC\|2047
    6.43 -.I "MIME (Multipurpose Internet Mail Extensions) Part Three: \
    6.44 -	Message Header Extensions for Non-ASCII Text" ,
    6.45 -November 1996.
    6.46 -
    6.47 -.IP RFC\|2048
    6.48 -.I "Multipurpose Internet Mail Extensions (MIME) Part Four: \
    6.49 -	Registration Procedures" ,
    6.50 -November 1996.
    6.51 -
    6.52 -.IP RFC\|2049
    6.53 -.I "Multipurpose Internet Mail Extensions (MIME) Part Five: \
    6.54 -	Conformance Criteria and Examples" ,
    6.55 -November 1996.
    6.56 -
    6.57 -.IP RFC\|2822
    6.58 -.I "Internet Message Format",
    6.59 -April 2001.
    6.60 -
    6.61 -.IP RFC\|3156
    6.62 -.I "MIME Security with OpenPGP",
    6.63 -August 2001.
    6.64 -
    6.65 -.IP RFC\|4880
    6.66 -.I "OpenPGP Message Format",
    6.67 -November 2007.
    6.68 -
     7.1 --- a/web.bib	Sun Jul 15 18:42:08 2012 +0200
     7.2 +++ b/web.bib	Sun Jul 15 19:16:35 2012 +0200
     7.3 @@ -5,33 +5,6 @@
     7.4  %O \fU http://\:faculty.cs.niu.edu/\:~rickert/\:mh/
     7.5  %K mhsign mhpgp
     7.6  
     7.7 -%L web:\|nmh
     7.8 -%H Website of
     7.9 -%T nmh
    7.10 -%O \fU http://\:nmh.nongnu.org 
    7.11 -%K homepage
    7.12 -
    7.13 -%L web:\|mmh
    7.14 -%H Website of
    7.15 -%T mmh
    7.16 -%O \fU http://\:marmaro.de/\:prog/\:mmh/ 
    7.17 -%K homepage
    7.18 -
    7.19 -%L web:\|mutt
    7.20 -%H Website of
    7.21 -%T mutt
    7.22 -%O \fU http://\:www.mutt.org 
    7.23 -
    7.24 -%L web:\|git
    7.25 -%H Website of
    7.26 -%T git
    7.27 -%O \fU http://\:git-scm.com 
    7.28 -
    7.29 -%L web:\|sloccount
    7.30 -%H Website of
    7.31 -%T sloccount
    7.32 -%O \fU http://\:www.dwheeler.com/\:sloccount/ 
    7.33 -
    7.34  %L web:\|email
    7.35  %T Email
    7.36  %A Wikipedia
    7.37 @@ -43,23 +16,12 @@
    7.38  %O \fU http://\:code.google.com/\:soc/ 
    7.39  %K gsoc
    7.40  
    7.41 -%L web:\|mc
    7.42 -%H Website of
    7.43 -%T midnight commander
    7.44 -%O \fU http://\:www.gnu.org/\:software/\:mc/
    7.45 -
    7.46  %L web:\|UP
    7.47  %A Wikipedia, The Free Encyclopedia
    7.48  %T Unix philosophy
    7.49  %D Version of 2010-03-21 17:20 UTC
    7.50  %O \fU http://\:en.wikipedia.org/\:wiki/\:Unix_philosophy 
    7.51  
    7.52 -%L web:\|mailx
    7.53 -%A Gunnar Ritter
    7.54 -%T mail, Mail, mailx, nail-history notes
    7.55 -%D 2007
    7.56 -%O \fU http://\:heirloom.sourceforge.net/\:mailx_history.html 
    7.57 -
    7.58  %L web:\|nmh-workers
    7.59  %H Website of
    7.60  %T nmh-workers mailing list
    7.61 @@ -76,83 +38,3 @@
    7.62  %T History of MH
    7.63  %O \fU http://rand-mh.sourceforge.net/book/overall/hiofmh.html
    7.64  %K website
    7.65 -
    7.66 -%L web:\|dwm
    7.67 -%H Website of
    7.68 -%T dwm
    7.69 -%O \fU http://\:dwm.suckless.org
    7.70 -
    7.71 -%L web:\|wmii
    7.72 -%H Website of
    7.73 -%T wmii
    7.74 -%O \fU http://\:wmii.suckless.org
    7.75 -
    7.76 -%L web:\|postfix
    7.77 -%H Website of
    7.78 -%T Postfix
    7.79 -%O \fU http://\:www.postfix.org
    7.80 -
    7.81 -%L web:\|procmail
    7.82 -%H Website of
    7.83 -%T Procmail
    7.84 -%O \fU http://\:www.procmail.org
    7.85 -
    7.86 -%L web:\|fetchmail
    7.87 -%H Website of
    7.88 -%T Fetchmail
    7.89 -%O \fU http://\:www.fetchmail.info
    7.90 -
    7.91 -%L web:\|sendmail
    7.92 -%H Website of
    7.93 -%T Sendmail
    7.94 -%O \fU http://\:www.sendmail.com
    7.95 -
    7.96 -%L web:\|qmail
    7.97 -%H Website of
    7.98 -%T qmail
    7.99 -%O \fU http://\:cr.yp.to/\:qmail.html
   7.100 -
   7.101 -%L web:\|dma
   7.102 -%H Website of
   7.103 -%T dma, the DragonFly Mail Agent
   7.104 -%O \fU https://github.com/corecode/dma
   7.105 -
   7.106 -%L web:\|mpop
   7.107 -%H Website of
   7.108 -%T mpop
   7.109 -%O \fU http://mpop.sourceforge.net
   7.110 -
   7.111 -%L web:\|getmail
   7.112 -%H Website of
   7.113 -%T getmail
   7.114 -%O \fU http://pyropus.ca/software/getmail/
   7.115 -
   7.116 -%L web:\|fdm
   7.117 -%H Website of
   7.118 -%T fdm
   7.119 -%O \fU http://fdm.sourceforge.net
   7.120 -
   7.121 -%L web:\|masqmail
   7.122 -%H Website of
   7.123 -%T masqmail
   7.124 -%O \fU http://marmaro.de/prog/masqmail/
   7.125 -
   7.126 -%L web:\|nullmailer
   7.127 -%H Website of
   7.128 -%T nullmailer
   7.129 -%O \fU http://untroubled.org/nullmailer/
   7.130 -
   7.131 -%L web:\|ssmtp
   7.132 -%H Website of
   7.133 -%T ssmtp
   7.134 -%O \fU http://packages.qa.debian.org/s/ssmtp.html
   7.135 -
   7.136 -%L web:\|mh-e
   7.137 -%H Website of
   7.138 -%T MH-E, the Emacs Interface to the MH Mail System
   7.139 -%O \fU http://mh-e.sourceforge.net
   7.140 -
   7.141 -%L web:\|gpg
   7.142 -%H Website of
   7.143 -%T GnuPG
   7.144 -%O \fU http://www.gnupg.org