changeset 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 5fb821ed6f3c
children 99ab58dc891f
files ch01.roff ch03.roff style
diffstat 3 files changed, 75 insertions(+), 42 deletions(-) [+]
line wrap: on
line diff
--- a/ch01.roff	Wed Jun 06 14:53:16 2012 +0200
+++ b/ch01.roff	Wed Jun 06 17:58:09 2012 +0200
@@ -128,42 +128,42 @@
 Following is an example mail handling session.
 It uses mmh but is mostly compatible with nmh and old MH.
 Details might vary but the look'n'feel is the same.
-.DS
-$ \f(CBinc\fP
+.VS
+$ f(CBincfP
 Incorporating new mail into inbox...
-	
+
    1+ 2012-05-16 11:16  meillo@dream.home  Hello
    2  2012-05-16 11:17  meillo@dream.home  book
-	
-$ \f(CBshow\fP
+
+$ f(CBshowfP
 Date:    Wed, 16 May 2012 11:16:00 +0200
 To:      meillo
 From:    <meillo@dream.home.schnalke.org>
 Subject: Hello
-	
+
 part       text/plain                  13
 mmh is great
-	
-$ \f(CBnext\fP
+
+$ f(CBnextfP
 Date:    Wed, 16 May 2012 11:17:24 +0200
 To:      meillo
 From:    <meillo@dream.home.schnalke.org>
 Subject: book
-	
+
 part       text/plain                  79
 Hello meillo,
-	
+
 have a look at the ``Daemon book''. You need to read that!
-	
+
 foo
-	
-$ \f(CBrmm 1\fP
-	
-$ \f(CBscan\fP
+
+$ f(CBrmm 1fP
+
+$ f(CBscanfP
    2+ 2012-05-16 11:17  meillo@dream.home  book
-	
+
 $
-.DE
+VE
 
 
 .H1 "nmh: Code and Community
--- a/ch03.roff	Wed Jun 06 14:53:16 2012 +0200
+++ b/ch03.roff	Wed Jun 06 17:58:09 2012 +0200
@@ -223,9 +223,9 @@
 If though one wants to have it this way, the standard tool
 .Pn write
 can be used in a way similar to:
-.DS
+.VS
 scan -file - | write `id -un`
-.DE
+VE
 .BU
 .Pn viamail
 was removed when the new attachment system was activated, because
@@ -244,9 +244,9 @@
 A call to
 .Pn msgchk
 provided hardly more information than
-.DS
+.VS
 ls -l /var/mail/meillo
-.DE
+VE
 though it distinguished between old and new mail.
 This detail information and can be retrieved with
 .Pn stat (1),
@@ -370,7 +370,7 @@
 First, the new MIME features were added in form of the single program
 .Pn mhn .
 The command
-.Cl "mhn \-show 42
+.Cl "mhn -show 42
 would show the MIME message numbered 42.
 With the 1.0 release of nmh in February 1999, Richard Coleman finished
 the split of
@@ -379,7 +379,7 @@
 multiple aspects of MIME. One of these resulting tools was
 .Pn mhshow ,
 which replaced the
-.Cl "mhn \-show
+.Cl "mhn -show
 call.
 It was capable to display a MIME message appropriately.
 .P
@@ -920,7 +920,7 @@
 .Pn mhl )
 and the terminal. This could have been ensured with
 the
-.Sw \-nomoreproc
+.Sw -nomoreproc
 at the command line statically, too.
 
 .U2 "Removed support for header fields
@@ -971,18 +971,18 @@
 queries the user to fill in a message form. When used by
 .Pn comp
 as:
-.DS
-comp \-editor prompter
-.DE
+.VS
+comp -editor prompter
+VE
 the resulting behavior is similar to
 .Pn mailx .
 Apparently,
 .Pn prompter
 hadn't been touched lately. Otherwise it's hardly explainable why it
 still offered the switches
-.Sn \-erase \fUchr\fP
+.Sw "-erase \f(CIchr\fP
 and
-.Sn \-kill \fUchr\fP
+.Sw "-kill \f(CIchr\fP
 to name the characters for command line editing.
 The times when this had been necessary are long time gone.
 Today these things work out-of-the-box, and if not, are configured
@@ -1225,19 +1225,19 @@
 the name
 .Fn +drafts .
 This made the
-.Sw \-draftfolder
+.Sw -draftfolder
 and
-.Sw \-draftmessage
+.Sw -draftmessage
 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.
-.Sw \-draft
+.Sw -draft
 switches could
 be dropped, as operating on a draft message became indistinguishable to
 operating on any other message for the tools.
 .Pn comp
 still has its
-.Sw \-use
+.Sw -use
 switch for switching between its two modes: (1) Compose a new
 draft, possibly by taking some existing message as a form. (2) Modify
 an existing draft. In either case, the behavior of
@@ -1268,9 +1268,9 @@
 are treated as messages. The removed messages remained as files in the
 same directory and needed some maintenance job to truly delete them after
 some grace time. Usually, by running a command similar to
-.DS
-find /home/user/Mail \-ctime +7 \-name ',*' | xargs rm
-.DE
+.VS
+find /home/user/Mail -ctime +7 -name ',*' | xargs rm
+VE
 in a cron job. Within the grace time interval
 the original message could be restored by stripping the
 the backup prefix from the file name. If however, the last message of
@@ -1335,9 +1335,9 @@
 by default). Messages
 there can be operated on like on any other message in the storage.
 The sweep clean, one can use
-.Cl "rmm \-unlink +trash a" ,
+.Cl "rmm -unlink +trash a" ,
 where the
-.Sw \-unlink
+.Sw -unlink
 switch causes the files to be truly unliked instead
 of moved to the trash folder.
 
--- a/style	Wed Jun 06 14:53:16 2012 +0200
+++ b/style	Wed Jun 06 17:58:09 2012 +0200
@@ -17,10 +17,10 @@
 .fp 0 CI TerminusMediumItalic-4.36 ttf
 .fp 0 CB TerminusBold-4.36 ttf
 .fp 0 L TerminusMedium-4.36 ttf
-.ftr CW -\-
-.ftr CI -\-
-.ftr CB -\-
-.ftr L -\-
+.ftr CW -\-`\`'\'
+.ftr CI -\-`\`'\'
+.ftr CB -\-`\`'\'
+.ftr L -\-`\`'\'
 .fp 0 SC LinLibertine_R otf
 .feature SC +onum +smcp
 .fp 0 IC LinLibertine_RI otf
@@ -280,6 +280,39 @@
 .ta T 8n
 ..
 
+.	\" VS - verbatim text start (\\ -> ^G; ' -> disabled; . -> ^B)
+.de VS
+.br
+.ne 4
+.sp \n(DDu
+.if t .in +.5i
+.if n .in +8n
+.nf
+.ft CW
+.\" ps -1
+.ta T 8n
+.\" set up verbatim environment
+\.blm
+\.ec 
+\.c2 ""
+\.cc 
+..
+
+.	\" VE - verbatim text end  (NOTE: Needs to be called as ^BVE !)
+.de VE
+\" restore the special characters
+cc
+.c2
+.ec
+.blm __
+.if t .in -.5i
+.if n .in -8n
+.sp \n(DDu
+.ft P
+.fi
+.TA
+..
+
 .	\" FA - XXX somehow related to footnotes?
 .am FA
 .ps 8