meillo@274: \clearpage meillo@8: \chapter*{Preface} meillo@98: \addcontentsline{toc}{section}{Preface} meillo@8: meillo@101: << preface text (about 1 page) >> %FIXME meillo@8: meillo@101: goal: revive masqmail; make it future save; clean it up; add some missing features; release a new version meillo@101: meillo@101: << write about the motivation to cover this topic: what is it I want? >> %FIXME meillo@101: meillo@101: << preface == target of the book, related to the reader >> %FIXME meillo@101: meillo@101: << make the topic more concrete and limit it >> %FIXME meillo@101: meillo@101: << have text by oliver here? >> %TODO meillo@101: meillo@277: usage examples: meillo@8: meillo@277: debian popcon stats meillo@96: meillo@277: << hikernet >> meillo@277: meillo@277: meillo@277: \subsubsection*{Audience} meillo@96: meillo@47: This document is targeted for \masqmail\ users and for people interested in mail systems in general. meillo@136: Security problems in electronic mail, \unix\ and the C programming language will also be discussed. meillo@47: Additional ones planning to take over an unmaintained software project will find real life experience in here. meillo@33: meillo@47: In each topic, basic knowledge is preconditioned. meillo@47: Nevertheless introductions are given and sources for further reading will be mentioned. meillo@33: meillo@47: This work focuses on the \unix\ operating system. meillo@47: Experience in usage, administration and program development is assumed. meillo@136: 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: meillo@210: General information about \unix\ can be found in \cite{kernighan84} %FIXME: references meillo@33: . %FIXME: references meillo@47: explain about administrating \unix. meillo@210: And developing programs in C may be learned from \cite{k&r} and \cite{rochkind85}. %FIXME: references meillo@33: meillo@33: %TODO: should I tell them to send email to me when having questions? Or somewhere else? meillo@33: meillo@8: meillo@36: \section*{Organisation} meillo@33: meillo@98: << write about organisation of the book: parts, chapters, sections. And more thats useful to know. >> %FIXME meillo@8: meillo@98: << explain where the main part lies (theory vs. implementation) >> %FIXME: meillo@33: meillo@98: << write about the bundled CD, and tell what's included >> %TODO meillo@98: meillo@98: meillo@150: \section*{Typographic conventions} meillo@150: %TODO: check if this tells what is really used! meillo@150: %FIXME: make it complete! meillo@150: %FIXME: remove everything not needed. Maybe write only a few sentences text. meillo@150: The following typographic conventions are used in this book: meillo@150: meillo@210: \begin{tabular}{ p{0.25\textwidth} p{0.7\textwidth} } meillo@210: \emph{Italics} & meillo@150: is used for names, including command names, file name, hostnames, usernames and email addresses. meillo@150: Further more it is used to emphasize text. meillo@150: \\ &\\ meillo@150: meillo@150: \texttt{Constant Width} & meillo@150: is used for source code, contents of files and output from programs. meillo@150: \\ &\\ meillo@150: meillo@248: \person{Small Caps} & meillo@210: are used to indicate names of persons. meillo@210: \\ &\\ meillo@210: meillo@150: \texttt{\$} & meillo@210: indicates the user's shell prompt. meillo@150: \\ &\\ meillo@150: meillo@150: \texttt{\#} & meillo@210: indicates the shell prompt of the superuser---root. meillo@210: \\ &\\ meillo@210: meillo@210: \cite{kernighan84} & meillo@210: is a reference to a book, an article, or a similar document. The Bibliography is located at the end of the thesis. meillo@210: \\ &\\ meillo@210: meillo@210: \citeweb{masqmail:homepage} & meillo@253: 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: \\ &\\ meillo@234: meillo@234: \RFC821 & meillo@253: 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: \\ &\\ meillo@234: meillo@150: \end{tabular} meillo@150: meillo@150: meillo@150: meillo@150: meillo@150: meillo@98: \section*{Acknowledgments} meillo@33: %FIXME: write this at the very end. meillo@33: % dont forget: proove readers, suggestion makers, supporters, ... meillo@93: % FIXME: if too long, include a file on the CD and refer on it here