docs/diploma

changeset 33:b3ba69ef35ab

added text about audience; added FIXMEs
author meillo@marmaro.de
date Tue, 07 Oct 2008 15:32:15 +0200
parents e150e6406019
children f789b659f094
files thesis/tex/0-preface.tex thesis/thesis.tex
diffstat 2 files changed, 34 insertions(+), 41 deletions(-) [+]
line diff
     1.1 --- a/thesis/tex/0-preface.tex	Tue Oct 07 14:45:43 2008 +0200
     1.2 +++ b/thesis/tex/0-preface.tex	Tue Oct 07 15:32:15 2008 +0200
     1.3 @@ -3,49 +3,38 @@
     1.4  \addcontentsline{toc}{chapter}{Preface}
     1.5  
     1.6  \section*{Preface}
     1.7 -Lorem ipsum dolor sit amet, \cite{brooks95} consectetur adipisicing elit, sed do eiusmod tempor
     1.8 -incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis
     1.9 -nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
    1.10 -
    1.11 -Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu
    1.12 -fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
    1.13 -culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit
    1.14 -amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore
    1.15 -et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation
    1.16 -ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor
    1.17 -in reprehenderit in voluptate velit esse. Cillum dolore eu fugiat nulla
    1.18 -pariatur.
    1.19 -
    1.20 -Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia
    1.21 -deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur\index{Daten}
    1.22 -adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna
    1.23 -aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi
    1.24 -ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in
    1.25 -voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint
    1.26 -occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim
    1.27 -id est laborum.
    1.28 -
    1.29 -Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut
    1.30 -aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in\index{Texteditor}
    1.31 -voluptate velit esse cillum dolore eu fugiat nulla pariatur. Duis aute irure
    1.32 -dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla\index{Geistesblitz}
    1.33 -pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui
    1.34 -officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet,
    1.35 -consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et
    1.36 -dolore magna aliqua.
    1.37 +Lorem ipsum dolor sit amet, \cite{brooks95} consectetur\index{Daten} adipisicing elit
    1.38  
    1.39  
    1.40  \section*{Organisation}
    1.41 -text
    1.42 +%FIXME: write about organisation of the book: parts, chapters, sections. And more thats useful to know.
    1.43 +%TODO: have this section after ``Audience''?
    1.44  
    1.45 -\section*{Audience and Assumptions}
    1.46 -text
    1.47 +
    1.48 +\section*{Audience}
    1.49 +This document is targeted for \masqmail\ users and for people interested in mail systems in general. Security problems in electronic mail, \unix\ and the \NAME{C} programming language will also be discussed. Additional ones planning to take over an unmaintained software project will find real life experience in here.
    1.50 +
    1.51 +In each topic, basic knowledge is %FIXME: vorrausgesetzt
    1.52 +. Nevertheless introductions are given and sources for further reading will be mentioned.
    1.53 +
    1.54 +This work focuses on the \unix\ operating system. Experience in usage, administration and program development is assumed. This includes the basic toolchain (e.g. \name{tar}, \name{grep}, etc.), user, file and permission management, as well as writing, compiling and installing programs written in the \NAME{C} language.
    1.55 +
    1.56 +General information about \unix\ can be found in %FIXME: references
    1.57 +. %FIXME: references
    1.58 +explain about administrating \unix. And developing programs in \NAME{C} may be learned from %FIXME: references (``The C programming language'', ``The Unix programming environment'', ...)
    1.59 +.
    1.60 +
    1.61 +%TODO: should I tell them to send email to me when having questions? Or somewhere else?
    1.62 +
    1.63  
    1.64  \section*{How to read this document}
    1.65 -text
    1.66 +%TODO: what to write here??
    1.67 +%TODO: include this in section ``Organisation''?
    1.68 +
    1.69  
    1.70  \section*{Conventions used in the book}
    1.71 -
    1.72 +%TODO: check if this tells what is really used!
    1.73 +%FIXME: make it complete!
    1.74  The following typographic conventions are used in this book:
    1.75  
    1.76  \begin{tabular}{ p{0.15\textwidth} p{0.8\textwidth} }
    1.77 @@ -70,11 +59,15 @@
    1.78  
    1.79  
    1.80  \section*{Regarded versions}
    1.81 -text
    1.82 +%FIXME: do I need this (here)?
    1.83 +
    1.84  
    1.85  \section*{Additional sources}
    1.86 -\NAME{RFCs}, other books, source code, websites
    1.87 +%FIXME: specify the really important external documents here
    1.88 +%TODO: write about the bundled CD, and tell what's included
    1.89 +\NAME{RFC}s, other books, source code, websites
    1.90  
    1.91 -	
    1.92 +
    1.93  \section*{Acknowledgements}
    1.94 -text
    1.95 +%FIXME: write this at the very end.
    1.96 +% dont forget: proove readers, suggestion makers, supporters, ...
     2.1 --- a/thesis/thesis.tex	Tue Oct 07 14:45:43 2008 +0200
     2.2 +++ b/thesis/thesis.tex	Tue Oct 07 15:32:15 2008 +0200
     2.3 @@ -19,8 +19,8 @@
     2.4  \include{tex/dedication}
     2.5  \cleardoublepage
     2.6  \tableofcontents
     2.7 -\listoffigures
     2.8 -\listoftables
     2.9 +%\listoffigures
    2.10 +%\listoftables
    2.11  \include{tex/0-preface}
    2.12  \setcounter{page}{0}
    2.13  \pagenumbering{arabic}