1.1 --- a/thesis/tex/0-preface.tex	Fri Nov 14 18:16:26 2008 +0100
     1.2 +++ b/thesis/tex/0-preface.tex	Sun Nov 16 14:44:22 2008 +0100
     1.3 @@ -3,11 +3,14 @@
     1.4  \addcontentsline{toc}{chapter}{Preface}
     1.5  
     1.6  \section*{Preface}
     1.7 -%FIXME: write about the motivation to cover this topic
     1.8 +%FIXME: write about the motivation to cover this topic: what is it I want?
     1.9 +% preface == target of the book, related to the reader
    1.10 +% make the topic more concrete and limit it
    1.11  %TODO: have text by oliver here?
    1.12  
    1.13  
    1.14  \section*{Audience}
    1.15 +%TODO: maybe merge mit the intention of the document
    1.16  This document is targeted for \masqmail\ users and for people interested in mail systems in general.
    1.17  Security problems in electronic mail, \unix\ and the \NAME{C} programming language will also be discussed.
    1.18  Additional ones planning to take over an unmaintained software project will find real life experience in here.
    1.19 @@ -29,16 +32,13 @@
    1.20  
    1.21  \section*{Organisation}
    1.22  %FIXME: write about organisation of the book: parts, chapters, sections. And more thats useful to know.
    1.23 -
    1.24 -
    1.25 -\section*{How to read this document}
    1.26 -%TODO: what to write here??
    1.27 -%TODO: include this in section ``Organisation''?
    1.28 +%FIXME: explain where the main part lies (theory vs. implementation)
    1.29  
    1.30  
    1.31  \section*{Conventions used}
    1.32  %TODO: check if this tells what is really used!
    1.33  %FIXME: make it complete!
    1.34 +%FIXME: remove everything not needed. Maybe write only a few sentences text.
    1.35  The following typographic conventions are used in this book:
    1.36  
    1.37  \begin{tabular}{ p{0.15\textwidth} p{0.8\textwidth} }
    1.38 @@ -71,3 +71,4 @@
    1.39  \section*{Acknowledgements}
    1.40  %FIXME: write this at the very end.
    1.41  % dont forget: proove readers, suggestion makers, supporters, ...
    1.42 +% FIXME: if too long, include a file on the CD and refer on it here

     2.1 --- a/thesis/tex/1-Introduction.tex	Fri Nov 14 18:16:26 2008 +0100
     2.2 +++ b/thesis/tex/1-Introduction.tex	Sun Nov 16 14:44:22 2008 +0100
     2.3 @@ -1,13 +1,14 @@
     2.4  \chapter{Introduction}
     2.5  \label{chap:introduction}
     2.6  
     2.7 -
     2.8 +% say what you want to say
     2.9  
    2.10  
    2.11  \section{Transporting mail}
    2.12  
    2.13  
    2.14  \subsection{History of electronic mail}
    2.15 +%FIXME: shorter!!!
    2.16  %TODO: have a quote from Bell Labs about email here
    2.17  
    2.18  Electronic mail\index{electronic mail} (short: \name{email})\citeweb{wikipedia:email} is a basic concept in \unix.\citeweb{unix-mail-intro} On \unix\ machines, a lot of information is distributed by \name{system mail}, which is email sent by the operating system. Beside that, email is the common communication system between humans working on computers.
    2.19 @@ -33,8 +34,10 @@
    2.20  More information about the history of electronic mail can be found at: \citeweb{email:griffiths}, \citeweb{email:crocker}, \citeweb{email:vleck}, \citeweb{email:akkad}, \citeweb{email:murakami}, and \citeweb{email:tomlinson}. A good starting point for general information on internet history is \citeweb{wikipedia:historyoftheinternet}.
    2.21  %TODO: check the websites which ones are the important ones; remove unnessesary ones
    2.22  
    2.23 +
    2.24 +
    2.25  \subsection{Definition of \MTA}
    2.26 -
    2.27 +%FIXME: better title; work text over!
    2.28  %TODO: when was the term ``mail transfer agent'' established?
    2.29  
    2.30  This thesis is about a \name{mail transfer agent} (or \index{mail transport agent|see{mail transfer agent}}\name{mail transport agent}, short \NAME{MTA}): \masqmail. \sendmail\ is one too---the most important one.
    2.31 @@ -74,6 +77,7 @@
    2.32  
    2.33  \subsection{\name{sendmail-compatibility}}
    2.34  \label{sec:sendmail}
    2.35 +%FIXME: rewrite!
    2.36  
    2.37  Allman wrote it to transfer emails between different networks, thus giving \sendmail\ mighty address rewriting abilities. In contrast to its predecessor \name{delivermail}, was \sendmail\ designed to offer greatest flexiblity in configuration; this enabled it to deal with any type of network.
    2.38  
    2.39 @@ -98,7 +102,7 @@
    2.40  
    2.41  
    2.42  \section{The \masqmail\ project}
    2.43 -
    2.44 +%FIXME: explain why masqmail is old and why it is interesting/important however!
    2.45  
    2.46  \subsubsection{Target field}
    2.47  Its original author, Oliver Kurth, sees \masqmail\ so:
    2.48 @@ -146,5 +150,7 @@
    2.49  
    2.50  
    2.51  \section{Problems to solve}
    2.52 +%FIXME: what problems has masqmail?
    2.53 +%FIXME: what's the intention of this document?
    2.54 +%FIXME: why is it worth the effort?
    2.55  
    2.56 -

     3.1 --- a/thesis/tex/2-MailTransferAgents.tex	Fri Nov 14 18:16:26 2008 +0100
     3.2 +++ b/thesis/tex/2-MailTransferAgents.tex	Sun Nov 16 14:44:22 2008 +0100
     3.3 @@ -242,6 +242,14 @@
     3.4  
     3.5  
     3.6  
     3.7 +% quality criteria
     3.8 +% standards of any kind
     3.9 +% how to compare?
    3.10 +% (bewertungsmatrix) objectivity
    3.11 +% how many criterias for ``good''?
    3.12 +
    3.13 +
    3.14 +
    3.15  
    3.16  
    3.17  \subsubsection*{masqmail stuff}

     4.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     4.2 +++ b/thesis/tex/4-MasqmailsFuture.tex	Sun Nov 16 14:44:22 2008 +0100
     4.3 @@ -0,0 +1,44 @@
     4.4 +\chapter{\masqmail's future}
     4.5 +
     4.6 +% plans to get masqmail more popular again (if that is the goal)
     4.7 +
     4.8 +% concrete decisions based on results of the last 2 chapters
     4.9 +
    4.10 +\section{Existing features}
    4.11 +This overview regards \masqmail version 0.2.21, the state this document starts off.
    4.12 +
    4.13 +First of all \masqmail\ is an \MTA. Therefor it accepts mail on the command line and via \SMTP. Mail queueing and alias expansion is supported. \masqmail\ is able to deliver mail to local mailboxes (in \name{mbox} or \name{maildir} format) or pass it to a \name{mail delivery agent} (like \name{procmail}). Mail destinated to remote locations is sent via \SMTP. Outgoing \SMTP\ connections feature \name{SMTP-Auth} and \name{SMTP-after-POP} authentication, but incoming \SMTP\ does not.
    4.14 +
    4.15 +As \masqmail\ is focused on non-permanent Internet connections, online state can be queried by three methods: reading from a file, reading the output of a command, or by asking an \name{mserver}. Each method may return a string indicating one of the available routes being online, or returning nothing to indicate offline state.
    4.16 +
    4.17 +Delivery to recipients on the local host or in local nets is done at once; delivery to recipients on the Internet is only done when being online, and queued otherwise. Each online route may have a different mail server to which mail is relayed. Return address headers are modified appropriate if wished.
    4.18 +
    4.19 +Additional to the \mta\ job, \masqmail\ also offers mail retrieval services with being a \NAME{POP3} client. Thus it can fetch mail from remote locations, dependent on the active online route.
    4.20 +
    4.21 +
    4.22 +
    4.23 +
    4.24 +\section{Directions to go}
    4.25 +
    4.26 +\subsection{\masqmail\ in five years}
    4.27 +\label{sec:masqmail-in-5-years}
    4.28 +Now how could \masqmail\ be like in, say, five years?
    4.29 +%requirements
    4.30 +%which parts to do
    4.31 +%how to make masqmail future-safe
    4.32 +
    4.33 +%how to advertise masqmail
    4.34 +%difference for free software
    4.35 +%why is it worth to revive masqmail?
    4.36 +
    4.37 +
    4.38 +\subsection{A design from scratch}
    4.39 +%what would be needed
    4.40 +%would one create it at all?
    4.41 +
    4.42 +
    4.43 +
    4.44 +\section{Work to do}
    4.45 +
    4.46 +
    4.47 +

     5.1 --- a/thesis/tex/5-Improvements.tex	Fri Nov 14 18:16:26 2008 +0100
     5.2 +++ b/thesis/tex/5-Improvements.tex	Sun Nov 16 14:44:22 2008 +0100
     5.3 @@ -1,44 +1,10 @@
     5.4 -\chapter{Improvements}
     5.5 +\chapter{Implementation}
     5.6  
     5.7  
     5.8 -\section{Existing features}
     5.9 -This overview regards \masqmail version 0.2.21, the state this document starts off.
    5.10 -
    5.11 -First of all \masqmail\ is an \MTA. Therefor it accepts mail on the command line and via \SMTP. Mail queueing and alias expansion is supported. \masqmail\ is able to deliver mail to local mailboxes (in \name{mbox} or \name{maildir} format) or pass it to a \name{mail delivery agent} (like \name{procmail}). Mail destinated to remote locations is sent via \SMTP. Outgoing \SMTP\ connections feature \name{SMTP-Auth} and \name{SMTP-after-POP} authentication, but incoming \SMTP\ does not.
    5.12 -
    5.13 -As \masqmail\ is focused on non-permanent Internet connections, online state can be queried by three methods: reading from a file, reading the output of a command, or by asking an \name{mserver}. Each method may return a string indicating one of the available routes being online, or returning nothing to indicate offline state.
    5.14 -
    5.15 -Delivery to recipients on the local host or in local nets is done at once; delivery to recipients on the Internet is only done when being online, and queued otherwise. Each online route may have a different mail server to which mail is relayed. Return address headers are modified appropriate if wished.
    5.16 -
    5.17 -Additional to the \mta\ job, \masqmail\ also offers mail retrieval services with being a \NAME{POP3} client. Thus it can fetch mail from remote locations, dependent on the active online route.
    5.18 -
    5.19 -
    5.20 -
    5.21 -
    5.22 -\section{Directions to go}
    5.23 -
    5.24 -\subsection{\masqmail\ in five years}
    5.25 -\label{sec:masqmail-in-5-years}
    5.26 -Now how could \masqmail\ be like in, say, five years?
    5.27 -%requirements
    5.28 -%which parts to do
    5.29 -%how to make masqmail future-safe
    5.30 -
    5.31 -%how to advertise masqmail
    5.32 -%difference for free software
    5.33 -%why is it worth to revive masqmail?
    5.34 -
    5.35 -
    5.36 -\subsection{A design from scratch}
    5.37 -%what would be needed
    5.38 -%would one create it at all?
    5.39 -
    5.40 -
    5.41 -
    5.42 -\section{Work to do}
    5.43 -
    5.44 -
    5.45 -\section{Implementation}
    5.46 +\section{topic01}
    5.47 +\section{topic02}
    5.48 +\section{topic03}
    5.49 +\section{topic04}
    5.50  
    5.51  
    5.52  \section{Work done}

     6.1 --- a/thesis/thesis.tex	Fri Nov 14 18:16:26 2008 +0100
     6.2 +++ b/thesis/thesis.tex	Sun Nov 16 14:44:22 2008 +0100
     6.3 @@ -30,6 +30,7 @@
     6.4  \include{tex/1-Introduction}
     6.5  \include{tex/2-MailTransferAgents}
     6.6  \include{tex/3-MarketAnalysis}
     6.7 +\include{tex/4-MasqmailsFuture}
     6.8  \include{tex/5-Improvements}
     6.9  \include{tex/6-Release}
    6.10  \include{tex/7-Summary}