docs/master

changeset 30:d996f130e279

Some rework and new text in the Preface.
author markus schnalke <meillo@marmaro.de>
date Wed, 09 May 2012 15:50:40 +0200
parents 6afbb4a49962
children 029e11dd4de1
files preface.roff
diffstat 1 files changed, 24 insertions(+), 12 deletions(-) [+]
line diff
     1.1 --- a/preface.roff	Wed May 09 15:19:30 2012 +0200
     1.2 +++ b/preface.roff	Wed May 09 15:50:40 2012 +0200
     1.3 @@ -10,7 +10,7 @@
     1.4  to modernize, stream-line and to exploit the concepts
     1.5  even more thoroughly.
     1.6  
     1.7 -.U2 "The Path to this Thesis
     1.8 +.U2 "Background to this Thesis
     1.9  .P
    1.10  I have discovered nmh in September 2009. At that time I used to use the
    1.11  mail client mutt, like many command line-attracted Unix users do.
    1.12 @@ -96,7 +96,7 @@
    1.13  Nmh would hardly be hurt by my work as I would not interfere with
    1.14  them. But nmh would profit from my experiences.
    1.15  
    1.16 -.U2 "Focus and Delimitation of the Document
    1.17 +.U2 "Focus of this Document
    1.18  .P
    1.19  This document describes my work on the experimental version, named
    1.20  \fImmh\fP. It explains the changes I did to nmh, with having the focus
    1.21 @@ -111,25 +111,25 @@
    1.22  thoughts on style, mainly based to the Unix philosophy, are present
    1.23  throughout the discussions.
    1.24  .P
    1.25 -This document is written for the community \(en developers and users \(en
    1.26 -around MH-like mail systems.
    1.27 +This document is written for the community around MH-like mail systems
    1.28 +\(en developers and users.
    1.29  First of all, the document shall propagade the design goals and
    1.30  implementation decisions of mmh. But as well, it shall clarify my
    1.31 -perception of the
    1.32 -concepts of MH and Unix, and the therefrom resulting point of view.
    1.33 -Further more, the document shall explain this view on nmh and mmh.
    1.34 -Despite the focus on MH-like systems, this document can be useful
    1.35 +personal perception of the
    1.36 +concepts of MH and Unix, and explain the therefrom resulting point of view.
    1.37 +Despite the focus on MH-like systems, this document can be worthwhile
    1.38  to anyone interested in the Unix philosophy, as well as anyone
    1.39 -involved in old software projects, be it code-related or community-related.
    1.40 +involved in old software projects, be it code or community-related.
    1.41  .P
    1.42 -The reader is expected to know Unix, C and email well. Good Unix shell
    1.43 +The reader is expected to have good knowledge of Unix, C and emailing.
    1.44 +Good Unix shell
    1.45  knowledge, including shell scripting, is required. MH relies fundamentally
    1.46  on the shell. Without the power of the shell, MH becomes a motorbike
    1.47 -without winding roads.
    1.48 +without winding roads: boring.
    1.49  Introductions to Unix and its shell can be found in XXX.
    1.50  The reader is
    1.51  expected to be familiar with the C programming language, although the
    1.52 -document should be quite readable without knowledge of C, too.
    1.53 +document should be understandable without knowledge of C, too.
    1.54  The book by Kernighan and Ritchie is the definitive guide to C.
    1.55  Some book about system-level C programming is worthwile additional
    1.56  literature. Rochkind and Curry have written such books.
    1.57 @@ -143,6 +143,17 @@
    1.58  concrete is the literature by Kernighan and Pike XXX.
    1.59  The term paper ``Why the Unix Philosophy still matters'' by myself
    1.60  provides an overview on the topic, including a case study of MH.
    1.61 +Although a brief introduction to MH is provided in Chapter 1, the reader
    1.62 +is encouraged to have a look at the \fIMH Book\fP by Jerry Peek.
    1.63 +It is the definitive guide to MH and nmh.
    1.64 +The current version is available freely on the Internet XXX.
    1.65 +.P
    1.66 +This document is neither a user's tutorial to mmh nor an introduction
    1.67 +to any of the topics covered. It contains discussions on Unix, email
    1.68 +and system design on an advanced level.
    1.69 +However, as knowledge of the fundamental concepts is the most valuable
    1.70 +information over some program or software system a user can aquire,
    1.71 +this document might be worth a read for non-developers too.
    1.72  
    1.73  
    1.74  .U2 "Organization
    1.75 @@ -171,6 +182,7 @@
    1.76  
    1.77  .\" End or Preface. Start of the normal text.
    1.78  .\" Switch to arabic page numbers and start on a right page.
    1.79 +.
    1.80  .if e \{
    1.81  .	pn 1
    1.82  .	af PN 1