# HG changeset patch # User markus schnalke # Date 1338998289 -7200 # Node ID ff45373271626465878e4fe0748acda0bedba2e3 # Parent 5fb821ed6f3c9e808737be4a2484be86d1acf865 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. diff -r 5fb821ed6f3c -r ff4537327162 ch01.roff --- 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: 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: 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 diff -r 5fb821ed6f3c -r ff4537327162 ch03.roff --- 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. diff -r 5fb821ed6f3c -r ff4537327162 style --- 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