docs/master

diff ch03.roff @ 82:ff4537327162

Mayor rework: Replaced .DS with .VS, a better verbatim environment. VS is no Keep. By translating characters in the typewriter fonts, we don't need to escape the minus, backtick and single quote characters.
author markus schnalke <meillo@marmaro.de>
date Wed, 06 Jun 2012 17:58:09 +0200
parents 64f177ca2af1
children c35ec2b7de5d
line diff
     1.1 --- a/ch03.roff	Wed Jun 06 14:53:16 2012 +0200
     1.2 +++ b/ch03.roff	Wed Jun 06 17:58:09 2012 +0200
     1.3 @@ -223,9 +223,9 @@
     1.4  If though one wants to have it this way, the standard tool
     1.5  .Pn write
     1.6  can be used in a way similar to:
     1.7 -.DS
     1.8 +.VS
     1.9  scan -file - | write `id -un`
    1.10 -.DE
    1.11 +VE
    1.12  .BU
    1.13  .Pn viamail
    1.14  was removed when the new attachment system was activated, because
    1.15 @@ -244,9 +244,9 @@
    1.16  A call to
    1.17  .Pn msgchk
    1.18  provided hardly more information than
    1.19 -.DS
    1.20 +.VS
    1.21  ls -l /var/mail/meillo
    1.22 -.DE
    1.23 +VE
    1.24  though it distinguished between old and new mail.
    1.25  This detail information and can be retrieved with
    1.26  .Pn stat (1),
    1.27 @@ -370,7 +370,7 @@
    1.28  First, the new MIME features were added in form of the single program
    1.29  .Pn mhn .
    1.30  The command
    1.31 -.Cl "mhn \-show 42
    1.32 +.Cl "mhn -show 42
    1.33  would show the MIME message numbered 42.
    1.34  With the 1.0 release of nmh in February 1999, Richard Coleman finished
    1.35  the split of
    1.36 @@ -379,7 +379,7 @@
    1.37  multiple aspects of MIME. One of these resulting tools was
    1.38  .Pn mhshow ,
    1.39  which replaced the
    1.40 -.Cl "mhn \-show
    1.41 +.Cl "mhn -show
    1.42  call.
    1.43  It was capable to display a MIME message appropriately.
    1.44  .P
    1.45 @@ -920,7 +920,7 @@
    1.46  .Pn mhl )
    1.47  and the terminal. This could have been ensured with
    1.48  the
    1.49 -.Sw \-nomoreproc
    1.50 +.Sw -nomoreproc
    1.51  at the command line statically, too.
    1.52  
    1.53  .U2 "Removed support for header fields
    1.54 @@ -971,18 +971,18 @@
    1.55  queries the user to fill in a message form. When used by
    1.56  .Pn comp
    1.57  as:
    1.58 -.DS
    1.59 -comp \-editor prompter
    1.60 -.DE
    1.61 +.VS
    1.62 +comp -editor prompter
    1.63 +VE
    1.64  the resulting behavior is similar to
    1.65  .Pn mailx .
    1.66  Apparently,
    1.67  .Pn prompter
    1.68  hadn't been touched lately. Otherwise it's hardly explainable why it
    1.69  still offered the switches
    1.70 -.Sn \-erase \fUchr\fP
    1.71 +.Sw "-erase \f(CIchr\fP
    1.72  and
    1.73 -.Sn \-kill \fUchr\fP
    1.74 +.Sw "-kill \f(CIchr\fP
    1.75  to name the characters for command line editing.
    1.76  The times when this had been necessary are long time gone.
    1.77  Today these things work out-of-the-box, and if not, are configured
    1.78 @@ -1225,19 +1225,19 @@
    1.79  the name
    1.80  .Fn +drafts .
    1.81  This made the
    1.82 -.Sw \-draftfolder
    1.83 +.Sw -draftfolder
    1.84  and
    1.85 -.Sw \-draftmessage
    1.86 +.Sw -draftmessage
    1.87  switches useless, and I could remove them.
    1.88  The more difficult but also the part that showed the real improvement,
    1.89  was updating the tools to the new concept.
    1.90 -.Sw \-draft
    1.91 +.Sw -draft
    1.92  switches could
    1.93  be dropped, as operating on a draft message became indistinguishable to
    1.94  operating on any other message for the tools.
    1.95  .Pn comp
    1.96  still has its
    1.97 -.Sw \-use
    1.98 +.Sw -use
    1.99  switch for switching between its two modes: (1) Compose a new
   1.100  draft, possibly by taking some existing message as a form. (2) Modify
   1.101  an existing draft. In either case, the behavior of
   1.102 @@ -1268,9 +1268,9 @@
   1.103  are treated as messages. The removed messages remained as files in the
   1.104  same directory and needed some maintenance job to truly delete them after
   1.105  some grace time. Usually, by running a command similar to
   1.106 -.DS
   1.107 -find /home/user/Mail \-ctime +7 \-name ',*' | xargs rm
   1.108 -.DE
   1.109 +.VS
   1.110 +find /home/user/Mail -ctime +7 -name ',*' | xargs rm
   1.111 +VE
   1.112  in a cron job. Within the grace time interval
   1.113  the original message could be restored by stripping the
   1.114  the backup prefix from the file name. If however, the last message of
   1.115 @@ -1335,9 +1335,9 @@
   1.116  by default). Messages
   1.117  there can be operated on like on any other message in the storage.
   1.118  The sweep clean, one can use
   1.119 -.Cl "rmm \-unlink +trash a" ,
   1.120 +.Cl "rmm -unlink +trash a" ,
   1.121  where the
   1.122 -.Sw \-unlink
   1.123 +.Sw -unlink
   1.124  switch causes the files to be truly unliked instead
   1.125  of moved to the trash folder.
   1.126