rev |
line source |
meillo@274
|
1 \clearpage
|
meillo@8
|
2 \chapter*{Preface}
|
meillo@98
|
3 \addcontentsline{toc}{section}{Preface}
|
meillo@8
|
4
|
meillo@101
|
5 << preface text (about 1 page) >> %FIXME
|
meillo@8
|
6
|
meillo@101
|
7 goal: revive masqmail; make it future save; clean it up; add some missing features; release a new version
|
meillo@101
|
8
|
meillo@101
|
9 << write about the motivation to cover this topic: what is it I want? >> %FIXME
|
meillo@101
|
10
|
meillo@101
|
11 << preface == target of the book, related to the reader >> %FIXME
|
meillo@101
|
12
|
meillo@101
|
13 << make the topic more concrete and limit it >> %FIXME
|
meillo@101
|
14
|
meillo@101
|
15 << have text by oliver here? >> %TODO
|
meillo@101
|
16
|
meillo@277
|
17 usage examples:
|
meillo@8
|
18
|
meillo@277
|
19 debian popcon stats
|
meillo@96
|
20
|
meillo@277
|
21 << hikernet >>
|
meillo@277
|
22
|
meillo@277
|
23
|
meillo@277
|
24 \subsubsection*{Audience}
|
meillo@96
|
25
|
meillo@47
|
26 This document is targeted for \masqmail\ users and for people interested in mail systems in general.
|
meillo@136
|
27 Security problems in electronic mail, \unix\ and the C programming language will also be discussed.
|
meillo@47
|
28 Additional ones planning to take over an unmaintained software project will find real life experience in here.
|
meillo@33
|
29
|
meillo@47
|
30 In each topic, basic knowledge is preconditioned.
|
meillo@47
|
31 Nevertheless introductions are given and sources for further reading will be mentioned.
|
meillo@33
|
32
|
meillo@47
|
33 This work focuses on the \unix\ operating system.
|
meillo@47
|
34 Experience in usage, administration and program development is assumed.
|
meillo@136
|
35 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 C language.
|
meillo@33
|
36
|
meillo@210
|
37 General information about \unix\ can be found in \cite{kernighan84} %FIXME: references
|
meillo@33
|
38 . %FIXME: references
|
meillo@47
|
39 explain about administrating \unix.
|
meillo@210
|
40 And developing programs in C may be learned from \cite{k&r} and \cite{rochkind85}. %FIXME: references
|
meillo@33
|
41
|
meillo@33
|
42 %TODO: should I tell them to send email to me when having questions? Or somewhere else?
|
meillo@33
|
43
|
meillo@8
|
44
|
meillo@36
|
45 \section*{Organisation}
|
meillo@33
|
46
|
meillo@98
|
47 << write about organisation of the book: parts, chapters, sections. And more thats useful to know. >> %FIXME
|
meillo@8
|
48
|
meillo@98
|
49 << explain where the main part lies (theory vs. implementation) >> %FIXME:
|
meillo@33
|
50
|
meillo@98
|
51 << write about the bundled CD, and tell what's included >> %TODO
|
meillo@98
|
52
|
meillo@98
|
53
|
meillo@150
|
54 \section*{Typographic conventions}
|
meillo@150
|
55 %TODO: check if this tells what is really used!
|
meillo@150
|
56 %FIXME: make it complete!
|
meillo@150
|
57 %FIXME: remove everything not needed. Maybe write only a few sentences text.
|
meillo@150
|
58 The following typographic conventions are used in this book:
|
meillo@150
|
59
|
meillo@210
|
60 \begin{tabular}{ p{0.25\textwidth} p{0.7\textwidth} }
|
meillo@210
|
61 \emph{Italics} &
|
meillo@150
|
62 is used for names, including command names, file name, hostnames, usernames and email addresses.
|
meillo@150
|
63 Further more it is used to emphasize text.
|
meillo@150
|
64 \\ &\\
|
meillo@150
|
65
|
meillo@150
|
66 \texttt{Constant Width} &
|
meillo@150
|
67 is used for source code, contents of files and output from programs.
|
meillo@150
|
68 \\ &\\
|
meillo@150
|
69
|
meillo@248
|
70 \person{Small Caps} &
|
meillo@210
|
71 are used to indicate names of persons.
|
meillo@210
|
72 \\ &\\
|
meillo@210
|
73
|
meillo@150
|
74 \texttt{\$} &
|
meillo@210
|
75 indicates the user's shell prompt.
|
meillo@150
|
76 \\ &\\
|
meillo@150
|
77
|
meillo@150
|
78 \texttt{\#} &
|
meillo@210
|
79 indicates the shell prompt of the superuser---root.
|
meillo@210
|
80 \\ &\\
|
meillo@210
|
81
|
meillo@210
|
82 \cite{kernighan84} &
|
meillo@210
|
83 is a reference to a book, an article, or a similar document. The Bibliography is located at the end of the thesis.
|
meillo@210
|
84 \\ &\\
|
meillo@210
|
85
|
meillo@210
|
86 \citeweb{masqmail:homepage} &
|
meillo@253
|
87 is a reference to a website. Websites differ from documents as they are less of a text written by some author, but more a place where information is gathered.
|
meillo@210
|
88 \\ &\\
|
meillo@234
|
89
|
meillo@234
|
90 \RFC821 &
|
meillo@253
|
91 is a reference to the \name{Request For Comments}, here the one numbered 821. \RFC{}s are only referenced in this way. A list of relevant \RFC{}s and how they can be retrieved is available in the Appendix. %fixme: add ref
|
meillo@234
|
92 \\ &\\
|
meillo@234
|
93
|
meillo@150
|
94 \end{tabular}
|
meillo@150
|
95
|
meillo@150
|
96
|
meillo@150
|
97
|
meillo@150
|
98
|
meillo@150
|
99
|
meillo@98
|
100 \section*{Acknowledgments}
|
meillo@33
|
101 %FIXME: write this at the very end.
|
meillo@33
|
102 % dont forget: proove readers, suggestion makers, supporters, ...
|
meillo@93
|
103 % FIXME: if too long, include a file on the CD and refer on it here
|