# HG changeset patch # User markus schnalke # Date 1335107790 -7200 # Node ID b3c37947764eeea72aeeec7007308543711ee4b3 # Parent 81f703140554c6ebef35ef2d916c2df5b5c4e0f7 Several minor text improvements. diff -r 81f703140554 -r b3c37947764e ch03.roff --- a/ch03.roff Sun Apr 22 13:50:35 2012 +0200 +++ b/ch03.roff Sun Apr 22 17:16:30 2012 +0200 @@ -133,7 +133,7 @@ draft folder facility exists. It had been introduced already in July 1984 by Marshall T. Rose. The facility was deactivated by default. Even in nmh, the draft folder facility remained deactivated by default. -At least, Richard Coleman added the man page \fImh-draft(5)\fI to document +At least, Richard Coleman added the man page \fImh-draft(5)\fP to document the feature well. .P The only advantage of not using the draft folder facility is the static @@ -145,9 +145,9 @@ On the other hand, a draft folder is the much more natural concept than a draft message. MH's mail storage consists of folders and messages, the messages named with ascending numbers. A draft message breaks with this -concept by introducing a message in a file named ``draft''. This draft +concept by introducing a message in a file named ``\fLdraft\fP''. This draft message is special. It can not be simply listed with the available tools, -but instead special switches were required. I.e. corner-cases were +but instead requires special switches. I.e. corner-cases were introduced. A draft folder, in contrast, does not introduce such corner-cases. The available tools can operate on the messages within that folder like on any messages within any mail folders. The only difference @@ -157,7 +157,7 @@ The trivial part of the change was activating the draft folder facility by default and setting a default name for this folder. Obviously, I chose the name ``\fL+drafts\fP''. This made the \fL\-draftfolder\fP and -\fL\-draftmessage\fP switches useless, thus I could remove them two. +\fL\-draftmessage\fP switches useless, and I could remove them. The more difficult but also the part that showed the real improvement, was updating the tools to the new concept. \fL\-draft\fP switches could be dropped, as operating on a draft message became indistinguishable to @@ -167,10 +167,10 @@ an existing draft. In either case, the behavior of \fLcomp\fP is deterministic. There is no more need to query the user. I consider this a major improvement. By making \fLsend\fP simply operate on the current -message in the draft folder by default, with both, message and folder, +message in the draft folder by default, with message and folder both overridable by specifying them on the command line, it is now possible -to send any message in the storage by simply specifying its folder and -name. +to send a draft anywhere within the storage by simply specifying its folder +and name. .P All theses changes converted special cases to regular cases, thus simplifying the tools and increasing the flexibility. @@ -193,8 +193,8 @@ the backup prefix from the file name. If however, the last message of a folder is been removed \(en say message `\fL6\fP' becomes file `\fL,6\fP' \(en and a new message enters the same folder, thus the same -numbered being given again \(en in out case `\fL6\fP' \(en, if that one -is removed too, then the backup of the former message gets over written. +numbered being given again \(en in our case `\fL6\fP' \(en, if that one +is removed too, then the backup of the former message gets overwritten. Thus, the ability to restore removed messages does not only depend on the ``sweeping cron job'' but also on the removing of further messages. This is undesireable, because the real mechanism is hidden from the user @@ -208,7 +208,7 @@ instead of taking the default action, described above. Refiling the to-be-removed files to some wastebin folder was a common example. Nmh's man page for \fLrmm(1)\fP proposes `\fLrefile +d\fP' -(implemented through a shell alias) and `\fLrm `mhpath +d all`\fP' +to move messages to the wastebin and `\fLrm `mhpath +d all`\fP' the empty the wastebin. Managing the message removal this way is a sane approach. It keeps the removed messages in one place, makes it easy to remove the backup @@ -233,9 +233,10 @@ of moved to the trash folder. -.H1 "Paths to ... +.H1 "MH Directory Split .P -foo + + .H1 "Path Notations .P