docs/master

diff discussion.roff @ 139:b7b81ae9c9d8

Removed and moved some paragraphs.
author markus schnalke <meillo@marmaro.de>
date Wed, 04 Jul 2012 23:51:08 +0200
parents cc35686f359e
children 3361e53dfcd6
line diff
     1.1 --- a/discussion.roff	Wed Jul 04 16:28:39 2012 +0200
     1.2 +++ b/discussion.roff	Wed Jul 04 23:51:08 2012 +0200
     1.3 @@ -1310,122 +1310,6 @@
     1.4  .Ci 0e46503be3c855bddaeae3843e1b659279c35d70
     1.5  
     1.6  
     1.7 -.U3 "Mail Transfer Switches
     1.8 -.P
     1.9 -With the removal of the mail transfer facilities, a lot of switches
    1.10 -vanished automatically.
    1.11 -.Pn inc
    1.12 -lost 9 switches, namely
    1.13 -.Sw -host ,
    1.14 -.Sw -port ,
    1.15 -.Sw -user ,
    1.16 -.Sw -proxy ,
    1.17 -.Sw -snoop ,
    1.18 -.Sw -[no]pack ,
    1.19 -as well as
    1.20 -.Sw -sasl
    1.21 -and
    1.22 -.Sw -saslmech .
    1.23 -.Pn send
    1.24 -and
    1.25 -.Pn post 
    1.26 -lost 11 switches each, namely
    1.27 -.Sw -server ,
    1.28 -.Sw -port ,
    1.29 -.Sw -client ,
    1.30 -.Sw -user ,
    1.31 -.Sw -mail ,
    1.32 -.Sw -saml ,
    1.33 -.Sw -send ,
    1.34 -.Sw -soml ,
    1.35 -.Sw -snoop ,
    1.36 -as well as
    1.37 -.Sw -sasl ,
    1.38 -.Sw -saslmech ,
    1.39 -and
    1.40 -.Sw -tls .
    1.41 -.Pn send
    1.42 -had the switches only to pass them further to
    1.43 -.Pn post ,
    1.44 -because the user would invoke
    1.45 -.Pn post
    1.46 -not directly, but through
    1.47 -.Pn send .
    1.48 -All these switches, except
    1.49 -.Sw -snoop
    1.50 -were usually defined as default switches in the user's profile,
    1.51 -but hardly given in interactive usage.
    1.52 -.P
    1.53 -Of course, those switches did not really ``vanish'', but the configuration
    1.54 -they did was handed over to external MSAs and MRAs.
    1.55 -Instead of setting up the mail transfer in mmh, it is set up in
    1.56 -external tools.
    1.57 -Yet, this simplifies mmh.
    1.58 -Specialized external tools will likely have simple configuration files.
    1.59 -Hence, instead of having one complicated central configuration file,
    1.60 -the configuration of each domain is separate.
    1.61 -Although the user needs to learn to configure each of the tools,
    1.62 -each configuration is likely much simpler.
    1.63 -
    1.64 -
    1.65 -.U3 "Maildrop Formats
    1.66 -.P
    1.67 -With the removal of MMDF maildrop format support,
    1.68 -.Pn packf
    1.69 -and
    1.70 -.Pn rcvpack
    1.71 -no longer needed their
    1.72 -.Sw -mbox
    1.73 -and
    1.74 -.Sw -mmdf
    1.75 -switches.
    1.76 -.Sw -mbox
    1.77 -is the sole  behavior now.
    1.78 -.Ci 3916ab66ad5d183705ac12357621ea8661afd3c0
    1.79 -In the same go,
    1.80 -.Pn packf
    1.81 -and
    1.82 -.Pn rcvpack
    1.83 -were reworked (see Sec. XXX) and their
    1.84 -.Sw -file
    1.85 -switch became unnecessary.
    1.86 -.Ci ca1023716d4c2ab890696f3e41fa0d94267a940e
    1.87 -
    1.88 -
    1.89 -.U3 "Terminal Magic
    1.90 -.P
    1.91 -Mmh's tools will no longer clear the screen (\c
    1.92 -.Pn scan 's
    1.93 -and
    1.94 -.Pn mhl 's
    1.95 -.Sw -[no]clear
    1.96 -switches
    1.97 -.Ci e57b17343dcb3ff373ef4dd089fbe778f0c7c270
    1.98 -.Ci 943765e7ac5693ae177fd8d2b5a2440e53ce816e ).
    1.99 -Neither will
   1.100 -.Pn mhl
   1.101 -ring the bell (\c
   1.102 -.Sw -[no]bell
   1.103 -.Ci e11983f44e59d8de236affa5b0d0d3067c192e24 )
   1.104 -nor page the output itself (\c
   1.105 -.Sw -length
   1.106 -.Ci 5b9d883db0318ed2b84bb82dee880d7381f99188 ).
   1.107 -.P
   1.108 -Generally, the pager to use is no longer specified with the
   1.109 -.Sw -[no]moreproc
   1.110 -command line switches for
   1.111 -.Pn mhl
   1.112 -and
   1.113 -.Pn show /\c
   1.114 -.Pn mhshow .
   1.115 -.Ci 39e87a75b5c2d3572ec72e717720b44af291e88a
   1.116 -.P
   1.117 -.Pn prompter
   1.118 -lost its
   1.119 -.Sw -erase
   1.120 -and
   1.121 -.Sw -kill
   1.122 -switches because today the terminal cares for the line editing keys.
   1.123  
   1.124  
   1.125  .U3 "Header Printing
   1.126 @@ -1473,7 +1357,7 @@
   1.127  for all tools of mmh.
   1.128  
   1.129  
   1.130 -.U3 "Suppressing Edits or the WhatNow Shell
   1.131 +.U3 "Suppressing Edits or the Invocation of the WhatNow Shell
   1.132  .P
   1.133  The
   1.134  .Sw -noedit
   1.135 @@ -1523,40 +1407,57 @@
   1.136  switch was intended to be used by front-ends.
   1.137  
   1.138  
   1.139 -.U3 "Compatibility Switches
   1.140 -.BU
   1.141 -The hidden
   1.142 -.Sw -[no]total
   1.143 -switches of
   1.144 -.Pn flist .
   1.145 -They were simply the inverse of the visible
   1.146 -.Sw -[no]fast
   1.147 -switches:
   1.148 -.Sw -total
   1.149 -was
   1.150 -.Sw -nofast
   1.151 -and
   1.152 -.Sw -nototal
   1.153 -was
   1.154 -.Sw -fast .
   1.155 -I removed the
   1.156 -.Sw -[no]total
   1.157 -legacy.
   1.158 -.Ci ea21fe2c4bd23c639bef251398fae809875732ec
   1.159 -.BU
   1.160 -The
   1.161 -.Sw -subject
   1.162 -switch of
   1.163 -.Pn sortm
   1.164 -existed for compatibility only.
   1.165 -It can be fully replaced by
   1.166 -.Cl "-textfield subject
   1.167 -thus it was removed.
   1.168 -.Ci 00140a3c86e9def69d98ba2ffd4d6e50ef6326ea
   1.169 -
   1.170  
   1.171  .U3 "Various
   1.172  .BU
   1.173 +With the removal of MMDF maildrop format support,
   1.174 +.Pn packf
   1.175 +and
   1.176 +.Pn rcvpack
   1.177 +no longer needed their
   1.178 +.Sw -mbox
   1.179 +and
   1.180 +.Sw -mmdf
   1.181 +switches.
   1.182 +.Sw -mbox
   1.183 +is the sole  behavior now.
   1.184 +.Ci 3916ab66ad5d183705ac12357621ea8661afd3c0
   1.185 +In the same go,
   1.186 +.Pn packf
   1.187 +and
   1.188 +.Pn rcvpack
   1.189 +were reworked (see Sec. XXX) and their
   1.190 +.Sw -file
   1.191 +switch became unnecessary.
   1.192 +.Ci ca1023716d4c2ab890696f3e41fa0d94267a940e
   1.193 +
   1.194 +.BU
   1.195 +Mmh's tools will no longer clear the screen (\c
   1.196 +.Pn scan 's
   1.197 +and
   1.198 +.Pn mhl 's
   1.199 +.Sw -[no]clear
   1.200 +switches
   1.201 +.Ci e57b17343dcb3ff373ef4dd089fbe778f0c7c270
   1.202 +.Ci 943765e7ac5693ae177fd8d2b5a2440e53ce816e ).
   1.203 +Neither will
   1.204 +.Pn mhl
   1.205 +ring the bell (\c
   1.206 +.Sw -[no]bell
   1.207 +.Ci e11983f44e59d8de236affa5b0d0d3067c192e24 )
   1.208 +nor page the output itself (\c
   1.209 +.Sw -length
   1.210 +.Ci 5b9d883db0318ed2b84bb82dee880d7381f99188 ).
   1.211 +Generally, the pager to use is no longer specified with the
   1.212 +.Sw -[no]moreproc
   1.213 +command line switches for
   1.214 +.Pn mhl
   1.215 +and
   1.216 +.Pn show /\c
   1.217 +.Pn mhshow .
   1.218 +.Ci 39e87a75b5c2d3572ec72e717720b44af291e88a
   1.219 +
   1.220 +.BU
   1.221  In order to avoid prefix collisions among switch names, the
   1.222  .Sw -version
   1.223  switch was renamed to
   1.224 @@ -1572,6 +1473,7 @@
   1.225  Although this rename breaks a basic interface, having the
   1.226  .Sw -V
   1.227  abbreviation to display the version information, isn't all too bad.
   1.228 +
   1.229  .BU
   1.230  .Sw -[no]preserve
   1.231  of
   1.232 @@ -1587,6 +1489,7 @@
   1.233  then refile will use the next available message number which
   1.234  is above the message number you wish to preserve.
   1.235  .QE
   1.236 +
   1.237  .BU
   1.238  The removal of the
   1.239  .Sw -[no]reverse
   1.240 @@ -1838,8 +1741,8 @@
   1.241  .U3 "MMDF maildrop support
   1.242  .P
   1.243  This type of format is conceptionally similar to the mbox format,
   1.244 -but uses a different message delimiter (`\fL^A^A^A^A\fP' instead of
   1.245 -`\fLFrom\0\fP').
   1.246 +but uses a different message delimiter (`\fL\\1\\1\\1\\1\fP',
   1.247 +commonly written as `\fL^A^A^A^A\fP', instead of `\fLFrom\0\fP').
   1.248  Mbox is the de-facto standard maildrop format on Unix,
   1.249  whereas the MMDF maildrop format became forgotten.
   1.250  I did drop MMDF maildrop format support.
   1.251 @@ -3534,7 +3437,7 @@
   1.252  .Fu atooi()
   1.253  function with calls to
   1.254  .Fu strtoul()
   1.255 -with the third parameter \(en the base \(en set to eight.
   1.256 +with the third parameter, the base, set to eight.
   1.257  .Fu strtoul()
   1.258  is part of C89 and thus considered safe to use.
   1.259  .Ci c490c51b3c0f8871b6953bd0c74551404f840a74
   1.260 @@ -3889,11 +3792,11 @@
   1.261  I learned about the easy and the difficult parts.
   1.262  Code is easy to understand if:
   1.263  .BU
   1.264 -The influenced code area is small
   1.265 +The influenced code area is small.
   1.266  .BU
   1.267 -The boundaries are strictly defined
   1.268 +The boundaries are strictly defined.
   1.269  .BU
   1.270 -The code is written straight-forward
   1.271 +The code is written straight-forward.
   1.272  .P
   1.273  .\" XXX move this paragraph somewhere else?
   1.274  Reading