docs/master

changeset 51:49cf68506b5d

Spell checking.
author markus schnalke <meillo@marmaro.de>
date Sun, 20 May 2012 11:40:19 +0200
parents a446f89cc5d9
children f12b22b0e29a
files ch01.roff ch03.roff dedication.roff preface.roff
diffstat 4 files changed, 60 insertions(+), 59 deletions(-) [+]
line diff
     1.1 --- a/ch01.roff	Sat May 19 17:57:20 2012 +0200
     1.2 +++ b/ch01.roff	Sun May 20 11:40:19 2012 +0200
     1.3 @@ -63,7 +63,7 @@
     1.4  
     1.5  .U2 "Concepts
     1.6  .P
     1.7 -MH is a toolchest, modelled after the Unix toolchest. It consists of a
     1.8 +MH is a tool chest, modeled after the Unix tool chest. It consists of a
     1.9  set of tools, each covering a specific task of email handling, like
    1.10  composing a message, replying to a message, refiling a message to a
    1.11  different folder, listing the messages in a folder.
    1.12 @@ -97,14 +97,14 @@
    1.13  adjust them to the user's personal preferences.
    1.14  Multiple versions of the same command with different
    1.15  default values can also be created very easily.
    1.16 -Form templates for new messages or for replies are easily changable,
    1.17 +Form templates for new messages or for replies are easily changeable,
    1.18  and output is adjustable with format files.
    1.19  Almost every part of the system can be adjusted to personal preference.
    1.20  .P
    1.21 -The system is well scriptable and extendable.
    1.22 +The system is well scriptable and extensible.
    1.23  New MH tools are built out of or on top of existing ones quickly.
    1.24 -Further more, MH encourages the user to taylor, extend and automate the system.
    1.25 -As the MH toolchest was modelled after the Unix toolchest, the
    1.26 +Further more, MH encourages the user to tailor, extend and automate the system.
    1.27 +As the MH tool chest was modeled after the Unix tool chest, the
    1.28  properties of the latter apply to the former as well.
    1.29  
    1.30  
    1.31 @@ -164,7 +164,7 @@
    1.32  All this still was in times before POSIX and ANSI C.
    1.33  As large parts of the code stem from this time, today's nmh source code
    1.34  still contains many ancient parts.
    1.35 -BSD-specific code and constructs taylored for hardware of that time
    1.36 +BSD-specific code and constructs tailored for hardware of that time
    1.37  are frequent.
    1.38  .P
    1.39  Nmh started about a decade after the POSIX and ANSI C standards had been
    1.40 @@ -172,16 +172,16 @@
    1.41  a part of the developers came from ``the old days''. The developer
    1.42  base became more diverse and thus resulted in code of different style.
    1.43  Programming practices from different decades merged in the project.
    1.44 -As several peers added code, the system became more a conclomeration
    1.45 -of single tools rather than a homogenic of-one-cast mail system.
    1.46 +As several peers added code, the system became more a conglomeration
    1.47 +of single tools rather than a homogeneous of-one-cast mail system.
    1.48  Still, the existing basic concepts held it together.
    1.49  They were mostly untouched throughout the years.
    1.50  .P
    1.51 -Despite the toolchest approach at the surface \(en a collection
    1.52 +Despite the tool chest approach at the surface \(en a collection
    1.53  of separate small programs \(en on the source code level
    1.54  it is much more interweaved.
    1.55  Several separate components were compiled into one program
    1.56 -for effiency reasons.
    1.57 +for efficiency reasons.
    1.58  This lead to intricate innards.
    1.59  Unfortunately, the clear separation on the outside appeared as being
    1.60  pretty interweaved inside.
    1.61 @@ -189,13 +189,13 @@
    1.62  The advent of MIME rose the complexity of email by a magnitude.
    1.63  This is visible in nmh. The MIME-related parts are the most complex ones.
    1.64  It's also visible that MIME support had been added on top of the old MH core.
    1.65 -MH's toolchest style made this easily possible and encourages
    1.66 +MH's tool chest style made this easily possible and encourages
    1.67  such approaches, but unfortunately, it lead to duplicated functions
    1.68  and half-hearted implementation of the concepts.
    1.69  .P
    1.70  To provide backward-compatibility, it is a common understanding to not
    1.71  change the default settings.
    1.72 -In consequence, the user needs to activate modern features explicitely
    1.73 +In consequence, the user needs to activate modern features explicitly
    1.74  to be able to use them.
    1.75  This puts a burden on new users, because out-of-the-box nmh remains
    1.76  in the same ancient style.
    1.77 @@ -212,10 +212,10 @@
    1.78  when there were no more than three commits to nmh in the previous nine months..
    1.79  In December, when I announced my work on the nmh-workers mailing list,
    1.80  .[
    1.81 -nmh-workers mmh announce december
    1.82 +nmh-workers mmh announce December
    1.83  .]
    1.84  the activity in nmh rose much.
    1.85 -Suddently the community started to move.
    1.86 +Suddenly, the community started to move.
    1.87  This movement was heavily pushed by Paul Vixie's ``edginess'' comment.
    1.88  .[
    1.89  nmh-workers vixie edginess
    1.90 @@ -230,7 +230,7 @@
    1.91  The project follows my personal considerations and preferences.
    1.92  By calling it a personal project, I don't need to justify my decisions,
    1.93  though, still I like to do.
    1.94 -This enabled me to follow my vision staightly and thus produce
    1.95 +This enabled me to follow my vision straightly and thus produce
    1.96  a result of greater pureness.
    1.97  This project model was inspired by the window manager \fIdwm\fP,
    1.98  which is Anselm Garbe's personal window manager \(en
    1.99 @@ -241,7 +241,7 @@
   1.100  This should not happen to mmh.
   1.101  .P
   1.102  Mmh also stands for \fImodern mail handler\fP, and this is
   1.103 -the variant chosen to entitel this document. One main focus of the
   1.104 +the variant chosen to entitle this document. One main focus of the
   1.105  project was to modernize nmh. Another main goal is resembled in the
   1.106  name \fIminimized mail handler\fP: Drop any parts that don't add
   1.107  to the main task of mmh, being a conceptionally appealing MUA.
   1.108 @@ -257,22 +257,22 @@
   1.109  
   1.110  .U2 "Motivation
   1.111  .P
   1.112 -MH is the most important of very few command line toolchest email systems.
   1.113 +MH is the most important of very few command line tool chest email systems.
   1.114  (There's also \fIim\fP by Tatsuya Kinoshita,
   1.115  which operates on an MH mail storage.)
   1.116 -Toolchests are powerful because they can be perfectly automated and
   1.117 -extended. Toolchests are good back-ends for various sorts of front-ends.
   1.118 +Tool chests are powerful because they can be perfectly automated and
   1.119 +extended. Tool chests are good back-ends for various sorts of front-ends.
   1.120  They allow multiple front-ends for different special needs
   1.121 -to be implemented quickly and withough internal knowledge on emailing.
   1.122 -Further more, toolchests are much better to maintain than large monolithic
   1.123 +to be implemented quickly and without internal knowledge on emailing.
   1.124 +Further more, tool chests are much better to maintain than large monolithic
   1.125  programs.
   1.126 -As there are few toolchests for emailing and MH-like ones are the most
   1.127 -popular amoung them, they should be developed further to keep their
   1.128 +As there are few tool chests for emailing and MH-like ones are the most
   1.129 +popular among them, they should be developed further to keep their
   1.130  conceptional elegance and unique scripting qualities available to users.
   1.131  mmh will create a modern and convenient entry point for new, interested
   1.132  users to MH-like systems.
   1.133  .P
   1.134 -The mmh project is motivated by deficites of nmh and
   1.135 +The mmh project is motivated by deficits of nmh and
   1.136  my wish for general changes, combined
   1.137  with the nmh community's reluctancy to change.
   1.138  .P
   1.139 @@ -293,7 +293,7 @@
   1.140  compete with the large specialized projects that focus
   1.141  on only one of the components.
   1.142  The situation can be improved by concentrating the development power
   1.143 -on the most unique part of MH and letting the user pick his prefered
   1.144 +on the most unique part of MH and letting the user pick his preferred
   1.145  set of other mail components.
   1.146  Today's pre-packaged software components encourage this model.
   1.147  mmh is a way to go for this approach.
   1.148 @@ -326,9 +326,9 @@
   1.149  He is at least capable of shell scripting and wants to improve his
   1.150  productivity by scripting the mail system.
   1.151  He naturally uses modern email features, like attachments,
   1.152 -non-ASCII text, and digital cryptrography.
   1.153 +non-ASCII text, and digital cryptography.
   1.154  He is able to setup email system components besides mmh,
   1.155 -and actually likes the choice to pick the ones he preferes.
   1.156 +and actually likes the choice to pick the ones he prefers.
   1.157  He has a reasonably modern system that complies to standards,
   1.158  like POSIX and ANSI C.
   1.159  .P
   1.160 @@ -336,7 +336,7 @@
   1.161  shell session, but as well, he uses them to automate mail handling tasks.
   1.162  Likely, he runs his mail setup on a server machine, to which he connects
   1.163  via ssh. He might also have local mmh installations on his workstations,
   1.164 -but does rather not rely on graphical frontends. He definitely wants
   1.165 +but does rather not rely on graphical front-ends. He definitely wants
   1.166  to be flexible and thus be able to change his setup to suite his needs.
   1.167  .P
   1.168  The typical mmh user is a programmer himself.
   1.169 @@ -385,7 +385,7 @@
   1.170  Time and space optimizations should to be replaced by
   1.171  clear and readable code.
   1.172  A uniform programming style should prevail.
   1.173 -.IP "Homogenity
   1.174 +.IP "Homogeneity
   1.175  The available concepts need to be expanded as far as possible.
   1.176  A small set of concepts should prevail thoroughly throughout the system.
   1.177  The whole system should appear to be of-one-style.
     2.1 --- a/ch03.roff	Sat May 19 17:57:20 2012 +0200
     2.2 +++ b/ch03.roff	Sun May 20 11:40:19 2012 +0200
     2.3 @@ -6,23 +6,24 @@
     2.4  
     2.5  .H1 "Removal of Code Relicts
     2.6  .P
     2.7 -The code base of mmh originates from the late 70s, had been extensively
     2.8 -worked on in the mid 80s, and had been partly reorganized and extended
     2.9 -in the 90s. Relicts of all those times had gathered in the code base.
    2.10 +The code base of mmh originates from the late Seventies,
    2.11 +had been extensively
    2.12 +worked on in the mid Eighties, and had been partly reorganized and extended
    2.13 +in the Nineties. Relicts of all those times had gathered in the code base.
    2.14  My goal was to remove any ancient code parts. One part of the task was
    2.15  converting obsolete code constructs to standard constructs, the other part
    2.16  was dropping obsolete functions.
    2.17  .P
    2.18  As I'm not even thirty years old and have no more than seven years of
    2.19 -Unix experience, I needed to learn about the history in retroperspective.
    2.20 -Older people likely have used those ancient constructs themself
    2.21 -and have suffered from their incompatiblities and have longed for
    2.22 +Unix experience, I needed to learn about the history in retrospective.
    2.23 +Older people likely have used those ancient constructs themselves
    2.24 +and have suffered from their incompatibilities and have longed for
    2.25  standardization. Unfortunately, I have only read that others had done so.
    2.26  This put me in a much more difficult positions when working on the old
    2.27  code. I needed to recherche what other would have known by heart from
    2.28  experience. All my programming experience comes from a time past ANSI C
    2.29  and past POSIX. Although I knew about the times before, I took the
    2.30 -current state implicitely for granted most of the time.
    2.31 +current state implicitly for granted most of the time.
    2.32  .P
    2.33  Being aware of
    2.34  these facts, I rather let people with more historic experience solve the 
    2.35 @@ -156,7 +157,7 @@
    2.36  .DE
    2.37  the resulting behavior is similar to
    2.38  .Pn mailx .
    2.39 -Appearently,
    2.40 +Apparently,
    2.41  .Pn prompter
    2.42  hadn't been touched lately. Otherwise it's hardly explainable why it
    2.43  still offered the switches
    2.44 @@ -171,7 +172,7 @@
    2.45  
    2.46  .U2 "Vfork and Retry Loops
    2.47  .P
    2.48 -MH creates many processes, which is a concequence of the toolchest approach.
    2.49 +MH creates many processes, which is a consequence of the tool chest approach.
    2.50  In earlier times
    2.51  .Fu fork()
    2.52  had been an expensive system call, as the process's whole image needed
    2.53 @@ -194,7 +195,7 @@
    2.54  in the cases when they can be exchanged.
    2.55  With
    2.56  .Fu vfork()
    2.57 -being more errorprone and hardly faster, it's preferable to simply
    2.58 +being more error-prone and hardly faster, it's preferable to simply
    2.59  use
    2.60  .Fu fork()
    2.61  instead.
    2.62 @@ -203,7 +204,7 @@
    2.63  .Fu fork()
    2.64  is the probability of its success.
    2.65  Today on modern systems, the system call will succeed almost always.
    2.66 -In the 80s on heavy loaded systems, as they were common at
    2.67 +In the Eighties on heavy loaded systems, as they were common at
    2.68  universities, this had been different. Thus, many of the
    2.69  .Fu fork()
    2.70  calls were wrapped into loops to retry to fork several times in
    2.71 @@ -223,7 +224,7 @@
    2.72  to go. There are excellent specialized MTAs, like Postfix;
    2.73  there are specialized MDAs, like Procmail; there are specialized
    2.74  MRAs, like Fetchmail. I believe it's best to use them instead of
    2.75 -providing the same function ourself. Doing something well requires to
    2.76 +providing the same function ourselves. Doing something well requires to
    2.77  focus on this particular aspect or a small set of aspects. The more
    2.78  it is possible to focus, the better the result in this particular
    2.79  area will be. The limiting resource in Free Software community development
    2.80 @@ -249,7 +250,7 @@
    2.81  .P
    2.82  .Pn rcvtty
    2.83  was removed because its usecase of writing to the user's terminal
    2.84 -on receival of mail is hardly wanted today. If users like to be
    2.85 +on receiving of mail is hardly wanted today. If users like to be
    2.86  informed of new mail, then using the shell's
    2.87  .Ev MAILPATH
    2.88  variable or different (graphical) notifications are likely more
    2.89 @@ -290,9 +291,9 @@
    2.90  .Pn msh
    2.91  was removed because the tool was in conflict with the original
    2.92  philosophy of MH. It provided an interactive shell to access the
    2.93 -features of MH. One major feature of MH is being a toolchest.
    2.94 +features of MH. One major feature of MH is being a tool chest.
    2.95  .Pn msh
    2.96 -wouldn't be just another shell, taylored to the needs of mail
    2.97 +wouldn't be just another shell, tailored to the needs of mail
    2.98  handling, but one large program to have the MH tools built in.
    2.99  It's main use was for accessing Bulletin Boards, which have seized to
   2.100  be popular. Removing
   2.101 @@ -311,7 +312,7 @@
   2.102  .Fn draft
   2.103  and
   2.104  being located in the MH directory. When starting to compose another message
   2.105 -before the former one was sent, the user had been questioned wether to use,
   2.106 +before the former one was sent, the user had been questioned whether to use,
   2.107  refile or replace the old draft. Working on multiple drafts at the same time
   2.108  was impossible. One could only work on them in alteration by refiling the
   2.109  previous one to some directory and fetching some other one for reediting. 
   2.110 @@ -413,8 +414,8 @@
   2.111  is removed too, then the backup of the former message gets overwritten.
   2.112  Thus, the ability to restore removed messages does not only depend on
   2.113  the ``sweeping cron job'' but also on the removing of further messages.
   2.114 -This is undesireable, because the real mechanism is hidden from the user
   2.115 -and the concequences of further removals are not always obvious.
   2.116 +This is undesirable, because the real mechanism is hidden from the user
   2.117 +and the consequences of further removals are not always obvious.
   2.118  Further more, the backup files are scattered within the whole mail
   2.119  storage, instead of being collected at one place.
   2.120  .P
   2.121 @@ -425,14 +426,14 @@
   2.122  was introduced, very early.
   2.123  It could be set to any command, which would care for the mail removal
   2.124  instead of taking the default action, described above.
   2.125 -Refiling the to-be-removed files to some wastebin folder was a common
   2.126 +Refiling the to-be-removed files to some garbage folder was a common
   2.127  example. Nmh's man page
   2.128  .Mp rmm(1)
   2.129  proposes
   2.130  .Cl "refile +d
   2.131 -to move messages to the wastebin and
   2.132 +to move messages to the garbage folder and
   2.133  .Cl "rm `mhpath +d all`
   2.134 -the empty the wastebin.
   2.135 +the empty the garbage folder.
   2.136  Managing the message removal this way is a sane approach. It keeps
   2.137  the removed messages in one place, makes it easy to remove the backup
   2.138  files, and, most important, enables the user to use the tools of MH
   2.139 @@ -447,7 +448,7 @@
   2.140  .Pn mhpath
   2.141  to switch over from MH tools to Unix tools \(en MH can do it all itself.
   2.142  .P
   2.143 -This apporach matches perfect with the concepts of MH, thus making
   2.144 +This approach matches perfect with the concepts of MH, thus making
   2.145  it powerful. Hence, I made it the default. And even more, I also
   2.146  removed the old backup prefix approach, as it is clearly less powerful.
   2.147  Keeping unused alternative in the code is a bad choice as they likely
   2.148 @@ -588,8 +589,8 @@
   2.149  .Pn mhl 's
   2.150  limited display facilities couldn't cope with the task any longer.
   2.151  Instead of extending these tools, new ones were written from scratch
   2.152 -and then added to the MH toolchest. Doing so is encouraged by the
   2.153 -toolchest approach. The new tools could be added without interfering
   2.154 +and then added to the MH tool chest. Doing so is encouraged by the
   2.155 +tool chest approach. The new tools could be added without interfering
   2.156  with the existing ones. This is great. It allowed MH to be the
   2.157  first MUA to implement MIME.
   2.158  .P
     3.1 --- a/dedication.roff	Sat May 19 17:57:20 2012 +0200
     3.2 +++ b/dedication.roff	Sun May 20 11:40:19 2012 +0200
     3.3 @@ -9,7 +9,7 @@
     3.4  .ce 99
     3.5  .ig
     3.6  The UNIX Programming Environment:
     3.7 -	Instead, what makes it (the UNIX system) effective is an approch
     3.8 +	Instead, what makes it (the UNIX system) effective is an approach
     3.9  	to programming, a philosophy of using the computer. Although
    3.10  	that philosophy can't be written down in a single sentence, at
    3.11  	its heart is the idea that the power of a system comes more from
     4.1 --- a/preface.roff	Sat May 19 17:57:20 2012 +0200
     4.2 +++ b/preface.roff	Sun May 20 11:40:19 2012 +0200
     4.3 @@ -2,7 +2,7 @@
     4.4  
     4.5  .P
     4.6  MH is a set of mail handling tools with a common concept, similar to
     4.7 -the Unix toolchest, which is a set of file handling tools with a common
     4.8 +the Unix tool chest, which is a set of file handling tools with a common
     4.9  concept. nmh is the currently most popular implementation of an
    4.10  MH-like mail handling system.
    4.11  This thesis describes an experimental version of nmh, named \fImmh\fP.
    4.12 @@ -20,7 +20,7 @@
    4.13  Such a change is not trivial, but in being convinced by the
    4.14  concepts and by having done similar transitions for file management
    4.15  and editing already, it was not too difficult neither.
    4.16 -In contrast, setting up nmh to a convenient state became a tendious task
    4.17 +In contrast, setting up nmh to a convenient state became a tedious task
    4.18  that took several months.
    4.19  .P
    4.20  Once having nmh arranged to a convenient state, I enjoyed using it
    4.21 @@ -146,7 +146,7 @@
    4.22  kernighan ritchie c prog lang
    4.23  .]
    4.24  is the definitive guide to C.
    4.25 -Some book about system-level C programming is worthwile additional
    4.26 +Some book about system-level C programming is worthwhile additional
    4.27  literature. Rochkind and Curry have written such books.
    4.28  .[
    4.29  rochkind advanced unix prog
    4.30 @@ -194,7 +194,7 @@
    4.31  to any of the topics covered. It discusses Unix, email
    4.32  and system design on an advanced level.
    4.33  However, as knowledge of the fundamental concepts is the most valuable
    4.34 -information a user can aquire about some program or software system,
    4.35 +information a user can acquire about some program or software system,
    4.36  this document might be worth a read for non-developers as well.
    4.37  
    4.38  
    4.39 @@ -204,7 +204,7 @@
    4.40  Meaning of `foo(1)'.
    4.41  RFCs.
    4.42  .P
    4.43 -This thesis is devided into XXX chapters, ...
    4.44 +This thesis is divided into XXX chapters, ...
    4.45  .P
    4.46  .I Chapter 1
    4.47  introduces ...