docs/diploma

diff thesis/tex/0-preface.tex @ 96:8db526d7a678

reorganized preface and introduction (feels better now)
author meillo@marmaro.de
date Sun, 16 Nov 2008 15:29:59 +0100
parents a6f8a93abd64
children 1b7dba16c74a
line diff
     1.1 --- a/thesis/tex/0-preface.tex	Sun Nov 16 15:29:30 2008 +0100
     1.2 +++ b/thesis/tex/0-preface.tex	Sun Nov 16 15:29:59 2008 +0100
     1.3 @@ -2,15 +2,16 @@
     1.4  \chapter*{Preface}
     1.5  \addcontentsline{toc}{chapter}{Preface}
     1.6  
     1.7 -\section*{Preface}
     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 +preface text (about 1 page)
    1.14  
    1.15 -\section*{Audience}
    1.16 -%TODO: maybe merge mit the intention of the document
    1.17 +
    1.18 +\textbf{Audience}
    1.19 +
    1.20  This document is targeted for \masqmail\ users and for people interested in mail systems in general.
    1.21  Security problems in electronic mail, \unix\ and the \NAME{C} programming language will also be discussed.
    1.22  Additional ones planning to take over an unmaintained software project will find real life experience in here.
    1.23 @@ -34,38 +35,7 @@
    1.24  %FIXME: write about organisation of the book: parts, chapters, sections. And more thats useful to know.
    1.25  %FIXME: explain where the main part lies (theory vs. implementation)
    1.26  
    1.27 -
    1.28 -\section*{Conventions used}
    1.29 -%TODO: check if this tells what is really used!
    1.30 -%FIXME: make it complete!
    1.31 -%FIXME: remove everything not needed. Maybe write only a few sentences text.
    1.32 -The following typographic conventions are used in this book:
    1.33 -
    1.34 -\begin{tabular}{ p{0.15\textwidth} p{0.8\textwidth} }
    1.35 -\emph{Italic} &
    1.36 -is used for names, including command names, file name, hostnames, usernames and email addresses.
    1.37 -Further more it is used to emphasize text.
    1.38 -\\ &\\
    1.39 -
    1.40 -\texttt{Constant Width} &
    1.41 -is used for source code, contents of files and output from programs.
    1.42 -\\ &\\
    1.43 -
    1.44 -\texttt{\$} &
    1.45 -indicates the the user shell prompt.
    1.46 -\\ &\\
    1.47 -
    1.48 -\texttt{\#} &
    1.49 -indicates the the root shell prompt.
    1.50 -\\
    1.51 -\end{tabular}
    1.52 -
    1.53 -
    1.54 -
    1.55 -\section*{Additional sources}
    1.56 -%FIXME: specify the really important external documents here
    1.57  %TODO: write about the bundled CD, and tell what's included
    1.58 -\NAME{RFC}s, other books, source code, websites
    1.59  
    1.60  
    1.61  \section*{Acknowledgements}