# HG changeset patch # User markus schnalke # Date 1341438668 -7200 # Node ID b7b81ae9c9d8a4d4e1660541aa26ed6cfea44581 # Parent cc35686f359e26d000374003c5d7d98b03769924 Removed and moved some paragraphs. diff -r cc35686f359e -r b7b81ae9c9d8 discussion.roff --- a/discussion.roff Wed Jul 04 16:28:39 2012 +0200 +++ b/discussion.roff Wed Jul 04 23:51:08 2012 +0200 @@ -1310,122 +1310,6 @@ .Ci 0e46503be3c855bddaeae3843e1b659279c35d70 -.U3 "Mail Transfer Switches -.P -With the removal of the mail transfer facilities, a lot of switches -vanished automatically. -.Pn inc -lost 9 switches, namely -.Sw -host , -.Sw -port , -.Sw -user , -.Sw -proxy , -.Sw -snoop , -.Sw -[no]pack , -as well as -.Sw -sasl -and -.Sw -saslmech . -.Pn send -and -.Pn post -lost 11 switches each, namely -.Sw -server , -.Sw -port , -.Sw -client , -.Sw -user , -.Sw -mail , -.Sw -saml , -.Sw -send , -.Sw -soml , -.Sw -snoop , -as well as -.Sw -sasl , -.Sw -saslmech , -and -.Sw -tls . -.Pn send -had the switches only to pass them further to -.Pn post , -because the user would invoke -.Pn post -not directly, but through -.Pn send . -All these switches, except -.Sw -snoop -were usually defined as default switches in the user's profile, -but hardly given in interactive usage. -.P -Of course, those switches did not really ``vanish'', but the configuration -they did was handed over to external MSAs and MRAs. -Instead of setting up the mail transfer in mmh, it is set up in -external tools. -Yet, this simplifies mmh. -Specialized external tools will likely have simple configuration files. -Hence, instead of having one complicated central configuration file, -the configuration of each domain is separate. -Although the user needs to learn to configure each of the tools, -each configuration is likely much simpler. - - -.U3 "Maildrop Formats -.P -With the removal of MMDF maildrop format support, -.Pn packf -and -.Pn rcvpack -no longer needed their -.Sw -mbox -and -.Sw -mmdf -switches. -.Sw -mbox -is the sole behavior now. -.Ci 3916ab66ad5d183705ac12357621ea8661afd3c0 -In the same go, -.Pn packf -and -.Pn rcvpack -were reworked (see Sec. XXX) and their -.Sw -file -switch became unnecessary. -.Ci ca1023716d4c2ab890696f3e41fa0d94267a940e - - -.U3 "Terminal Magic -.P -Mmh's tools will no longer clear the screen (\c -.Pn scan 's -and -.Pn mhl 's -.Sw -[no]clear -switches -.Ci e57b17343dcb3ff373ef4dd089fbe778f0c7c270 -.Ci 943765e7ac5693ae177fd8d2b5a2440e53ce816e ). -Neither will -.Pn mhl -ring the bell (\c -.Sw -[no]bell -.Ci e11983f44e59d8de236affa5b0d0d3067c192e24 ) -nor page the output itself (\c -.Sw -length -.Ci 5b9d883db0318ed2b84bb82dee880d7381f99188 ). -.P -Generally, the pager to use is no longer specified with the -.Sw -[no]moreproc -command line switches for -.Pn mhl -and -.Pn show /\c -.Pn mhshow . -.Ci 39e87a75b5c2d3572ec72e717720b44af291e88a -.P -.Pn prompter -lost its -.Sw -erase -and -.Sw -kill -switches because today the terminal cares for the line editing keys. .U3 "Header Printing @@ -1473,7 +1357,7 @@ for all tools of mmh. -.U3 "Suppressing Edits or the WhatNow Shell +.U3 "Suppressing Edits or the Invocation of the WhatNow Shell .P The .Sw -noedit @@ -1523,40 +1407,57 @@ switch was intended to be used by front-ends. -.U3 "Compatibility Switches -.BU -The hidden -.Sw -[no]total -switches of -.Pn flist . -They were simply the inverse of the visible -.Sw -[no]fast -switches: -.Sw -total -was -.Sw -nofast -and -.Sw -nototal -was -.Sw -fast . -I removed the -.Sw -[no]total -legacy. -.Ci ea21fe2c4bd23c639bef251398fae809875732ec -.BU -The -.Sw -subject -switch of -.Pn sortm -existed for compatibility only. -It can be fully replaced by -.Cl "-textfield subject -thus it was removed. -.Ci 00140a3c86e9def69d98ba2ffd4d6e50ef6326ea - .U3 "Various .BU +With the removal of MMDF maildrop format support, +.Pn packf +and +.Pn rcvpack +no longer needed their +.Sw -mbox +and +.Sw -mmdf +switches. +.Sw -mbox +is the sole behavior now. +.Ci 3916ab66ad5d183705ac12357621ea8661afd3c0 +In the same go, +.Pn packf +and +.Pn rcvpack +were reworked (see Sec. XXX) and their +.Sw -file +switch became unnecessary. +.Ci ca1023716d4c2ab890696f3e41fa0d94267a940e + +.BU +Mmh's tools will no longer clear the screen (\c +.Pn scan 's +and +.Pn mhl 's +.Sw -[no]clear +switches +.Ci e57b17343dcb3ff373ef4dd089fbe778f0c7c270 +.Ci 943765e7ac5693ae177fd8d2b5a2440e53ce816e ). +Neither will +.Pn mhl +ring the bell (\c +.Sw -[no]bell +.Ci e11983f44e59d8de236affa5b0d0d3067c192e24 ) +nor page the output itself (\c +.Sw -length +.Ci 5b9d883db0318ed2b84bb82dee880d7381f99188 ). +Generally, the pager to use is no longer specified with the +.Sw -[no]moreproc +command line switches for +.Pn mhl +and +.Pn show /\c +.Pn mhshow . +.Ci 39e87a75b5c2d3572ec72e717720b44af291e88a + +.BU In order to avoid prefix collisions among switch names, the .Sw -version switch was renamed to @@ -1572,6 +1473,7 @@ Although this rename breaks a basic interface, having the .Sw -V abbreviation to display the version information, isn't all too bad. + .BU .Sw -[no]preserve of @@ -1587,6 +1489,7 @@ then refile will use the next available message number which is above the message number you wish to preserve. .QE + .BU The removal of the .Sw -[no]reverse @@ -1838,8 +1741,8 @@ .U3 "MMDF maildrop support .P This type of format is conceptionally similar to the mbox format, -but uses a different message delimiter (`\fL^A^A^A^A\fP' instead of -`\fLFrom\0\fP'). +but uses a different message delimiter (`\fL\\1\\1\\1\\1\fP', +commonly written as `\fL^A^A^A^A\fP', instead of `\fLFrom\0\fP'). Mbox is the de-facto standard maildrop format on Unix, whereas the MMDF maildrop format became forgotten. I did drop MMDF maildrop format support. @@ -3534,7 +3437,7 @@ .Fu atooi() function with calls to .Fu strtoul() -with the third parameter \(en the base \(en set to eight. +with the third parameter, the base, set to eight. .Fu strtoul() is part of C89 and thus considered safe to use. .Ci c490c51b3c0f8871b6953bd0c74551404f840a74 @@ -3889,11 +3792,11 @@ I learned about the easy and the difficult parts. Code is easy to understand if: .BU -The influenced code area is small +The influenced code area is small. .BU -The boundaries are strictly defined +The boundaries are strictly defined. .BU -The code is written straight-forward +The code is written straight-forward. .P .\" XXX move this paragraph somewhere else? Reading