Mercurial > docs > diploma

annotate thesis/tex/0-preface.tex @ 323:82496704f747

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
added labels
author meillo@marmaro.de
date Thu, 22 Jan 2009 21:51:19 +0100
parents f3a86ce788ec
children 3a544a333752
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
274
56cc2f5755f8 cleardoublepage -> clearpage (as the document is single sided)
meillo@marmaro.de
parents: 253
diff changeset
1 \clearpage
8
1d35768e1643 first prototype of thesis (with some sample content)
meillo@marmaro.de
parents:
diff changeset
2 \chapter*{Preface}
98
1b7dba16c74a minor stuff in preface
meillo@marmaro.de
parents: 96
diff changeset
3 \addcontentsline{toc}{section}{Preface}
8
1d35768e1643 first prototype of thesis (with some sample content)
meillo@marmaro.de
parents:
diff changeset
4
101
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
5 << preface text (about 1 page) >> %FIXME
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
6
302
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
7 << \textbf{say what you want to say} >>
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
8
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
9 << the overall goal of the document >>
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
10
101
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
11 goal: revive masqmail; make it future save; clean it up; add some missing features; release a new version
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
12
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
13 << write about the motivation to cover this topic: what is it I want? >> %FIXME
8
1d35768e1643 first prototype of thesis (with some sample content)
meillo@marmaro.de
parents:
diff changeset
14
101
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
15 << preface == target of the book, related to the reader >> %FIXME
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
16
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
17 << make the topic more concrete and limit it >> %FIXME
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
18
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 304
diff changeset
19 << have text by Oliver here? >> %TODO
101
6e2eaf91e59f some comments
meillo@marmaro.de
parents: 98
diff changeset
20
277
8a25b6262497 minor changes; added todos
meillo@marmaro.de
parents: 274
diff changeset
21 usage examples:
8a25b6262497 minor changes; added todos
meillo@marmaro.de
parents: 274
diff changeset
22
8a25b6262497 minor changes; added todos
meillo@marmaro.de
parents: 274
diff changeset
23 debian popcon stats
8a25b6262497 minor changes; added todos
meillo@marmaro.de
parents: 274
diff changeset
24
8a25b6262497 minor changes; added todos
meillo@marmaro.de
parents: 274
diff changeset
25 << hikernet >>
8
1d35768e1643 first prototype of thesis (with some sample content)
meillo@marmaro.de
parents:
diff changeset
26
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
27
277
8a25b6262497 minor changes; added todos
meillo@marmaro.de
parents: 274
diff changeset
28 \subsubsection*{Audience}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
29
47
d52fa2350137 split up into one sentence per line
meillo@marmaro.de
parents: 42
diff changeset
30 This document is targeted for \masqmail\ users and for people interested in mail systems in general.
136
b5f141edee4e one uppercase letter words are not set in small caps
meillo@marmaro.de
parents: 101
diff changeset
31 Security problems in electronic mail, \unix\ and the C programming language will also be discussed.
47
d52fa2350137 split up into one sentence per line
meillo@marmaro.de
parents: 42
diff changeset
32 Additional ones planning to take over an unmaintained software project will find real life experience in here.
33
b3ba69ef35ab added text about audience; added FIXMEs
meillo@marmaro.de
parents: 26
diff changeset
33
47
d52fa2350137 split up into one sentence per line
meillo@marmaro.de
parents: 42
diff changeset
34 In each topic, basic knowledge is preconditioned.
d52fa2350137 split up into one sentence per line
meillo@marmaro.de
parents: 42
diff changeset
35 Nevertheless introductions are given and sources for further reading will be mentioned.
8
1d35768e1643 first prototype of thesis (with some sample content)
meillo@marmaro.de
parents:
diff changeset
36
47
d52fa2350137 split up into one sentence per line
meillo@marmaro.de
parents: 42
diff changeset
37 This work focuses on the \unix\ operating system.
d52fa2350137 split up into one sentence per line
meillo@marmaro.de
parents: 42
diff changeset
38 Experience in usage, administration and program development is assumed.
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 304
diff changeset
39 This includes the basic tool chain (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.
33
b3ba69ef35ab added text about audience; added FIXMEs
meillo@marmaro.de
parents: 26
diff changeset
40
210
2181dc39ec06 extended typo conventions; and minor stuff
meillo@marmaro.de
parents: 150
diff changeset
41 General information about \unix\ can be found in \cite{kernighan84} %FIXME: references
33
b3ba69ef35ab added text about audience; added FIXMEs
meillo@marmaro.de
parents: 26
diff changeset
42 . %FIXME: references
47
d52fa2350137 split up into one sentence per line
meillo@marmaro.de
parents: 42
diff changeset
43 explain about administrating \unix.
210
2181dc39ec06 extended typo conventions; and minor stuff
meillo@marmaro.de
parents: 150
diff changeset
44 And developing programs in C may be learned from \cite{k&r} and \cite{rochkind85}. %FIXME: references
33
b3ba69ef35ab added text about audience; added FIXMEs
meillo@marmaro.de
parents: 26
diff changeset
45
b3ba69ef35ab added text about audience; added FIXMEs
meillo@marmaro.de
parents: 26
diff changeset
46
8
1d35768e1643 first prototype of thesis (with some sample content)
meillo@marmaro.de
parents:
diff changeset
47
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 304
diff changeset
48 \section*{Organization}
98
1b7dba16c74a minor stuff in preface
meillo@marmaro.de
parents: 96
diff changeset
49
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 304
diff changeset
50 << write about organization of the book: parts, chapters, sections. And more that's useful to know. >> %FIXME
33
b3ba69ef35ab added text about audience; added FIXMEs
meillo@marmaro.de
parents: 26
diff changeset
51
98
1b7dba16c74a minor stuff in preface
meillo@marmaro.de
parents: 96
diff changeset
52 << explain where the main part lies (theory vs. implementation) >> %FIXME:
1b7dba16c74a minor stuff in preface
meillo@marmaro.de
parents: 96
diff changeset
53
8
1d35768e1643 first prototype of thesis (with some sample content)
meillo@marmaro.de
parents:
diff changeset
54
33
b3ba69ef35ab added text about audience; added FIXMEs
meillo@marmaro.de
parents: 26
diff changeset
55
280
1749abc10235 minor changes
meillo@marmaro.de
parents: 277
diff changeset
56 \section*{Conventions}
302
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
57 %TODO: check it!
280
1749abc10235 minor changes
meillo@marmaro.de
parents: 277
diff changeset
58 The following typographic conventions are used in this thesis:
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 136
diff changeset
59
304
34ecf52520d3 small update
meillo@marmaro.de
parents: 302
diff changeset
60 \begin{enumerate}
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 304
diff changeset
61 \item \emph{Italic shape} is used to emphasize text, to introduce new terms, and for names, including product, host, and user names, as well as email addresses.
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 136
diff changeset
62
304
34ecf52520d3 small update
meillo@marmaro.de
parents: 302
diff changeset
63 \item For names of persons \textsc{Small Caps} are used.
34ecf52520d3 small update
meillo@marmaro.de
parents: 302
diff changeset
64
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 304
diff changeset
65 \item File and path names, source code excerpts, contents of files, and output from programs are displayed in \texttt{Typewriter font}.
304
34ecf52520d3 small update
meillo@marmaro.de
parents: 302
diff changeset
66 \end{enumerate}
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 136
diff changeset
67
302
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
68 References to external resources are marked using one of three styles, distinguished by the type of resource.
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 136
diff changeset
69
302
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
70 \begin{enumerate}
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 304
diff changeset
71 \item References to books, articles, and similar documents looks like this: \cite{kernighan84}. The letters represent the author(s) (here \person{Kernighan} and \person{Pike}), the number represents the year of publication (here 1984).
210
2181dc39ec06 extended typo conventions; and minor stuff
meillo@marmaro.de
parents: 150
diff changeset
72
302
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
73 \item Websites differ from documents as they are less of a text written by some author but more a place where information is gathered. They are only indicated by numbers, like for example: \citeweb{masqmail:homepage}.
210
2181dc39ec06 extended typo conventions; and minor stuff
meillo@marmaro.de
parents: 150
diff changeset
74
302
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
75 \item \name{Request for Comments}---documents that define Internet standards---are referenced in a third way, by specifying the unique number of the \RFC\ directly: \RFC821.
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
76 \end{enumerate}
234
4f2ebfac5ce0 added convention of refs to RFCs
meillo@marmaro.de
parents: 210
diff changeset
77
302
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
78 The Bibliography is located at the end of the thesis. It also includes a list of the relevant \RFC{}s and how they can be retrieved.
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 136
diff changeset
79
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 136
diff changeset
80
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 136
diff changeset
81
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 136
diff changeset
82
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 136
diff changeset
83
98
1b7dba16c74a minor stuff in preface
meillo@marmaro.de
parents: 96
diff changeset
84 \section*{Acknowledgments}
33
b3ba69ef35ab added text about audience; added FIXMEs
meillo@marmaro.de
parents: 26
diff changeset
85 %FIXME: write this at the very end.
b3ba69ef35ab added text about audience; added FIXMEs
meillo@marmaro.de
parents: 26
diff changeset
86 % dont forget: proove readers, suggestion makers, supporters, ...
302
fb66805bc870 reworked section about conventions; minor other stuff
meillo@marmaro.de
parents: 280
diff changeset
87 % FIXME: if too long, think about a page in the appendix