docs/master
diff discussion.roff @ 212:9317d789cef9
Various improvements and rework.
author | markus schnalke <meillo@marmaro.de> |
---|---|
date | Thu, 12 Jul 2012 22:04:51 +0200 |
parents | c299ed65d015 |
children | f3f65376bef9 |
line diff
1.1 --- a/discussion.roff Thu Jul 12 20:01:46 2012 +0200 1.2 +++ b/discussion.roff Thu Jul 12 22:04:51 2012 +0200 1.3 @@ -401,7 +401,7 @@ 1.4 .P 1.5 Removing 1.6 .Pn msh 1.7 -together with the truly archaic code relicts 1.8 +together with the truly archaic code relics 1.9 .Pn vmh 1.10 and 1.11 .Pn wmh 1.12 @@ -1028,11 +1028,29 @@ 1.13 1.14 .H2 "Command Line Switches 1.15 .P 1.16 -The command line switches of MH tools is similar to the X Window style. 1.17 +The command line switches of MH tools are similar to the X Window style. 1.18 .\" XXX ref 1.19 -They are words, introduced by a single dash. 1.20 -For example: 1.21 -.Cl "-truncate" . 1.22 +They consist of a single dash (`\fL-\fP') followed by a word. 1.23 +To ease typing, the word can be abbreviated, given the remaining 1.24 +prefix remains unambiguous. 1.25 +If no other switch starts with the letter `t', then any of 1.26 +.Cl "-truncate" , 1.27 +.Cl "-trunc" , 1.28 +.Cl "-tr" , 1.29 +and 1.30 +.Cl "-t 1.31 +is equal. 1.32 +As a result, switches can neither be grouped (as in 1.33 +.Cl "ls -ltr" ) 1.34 +nor can switch arguments be appended directly to the switch (as in 1.35 +.Cl "sendmail -q30m" ). 1.36 +Many switches have negating counter-parts, which start with `no'. 1.37 +For example 1.38 +.Cl "-notruncate 1.39 +inverts the 1.40 +.Cl "-truncate 1.41 +switch. 1.42 +They exist to override the effect of default switches in the profile. 1.43 Every program in mmh has two generic switches: 1.44 .Sw -help , 1.45 to print a short message on how to use the program, and 1.46 @@ -1652,7 +1670,7 @@ 1.47 increasingly extended. 1.48 New features entered the project and became alternatives to the 1.49 existing behavior. 1.50 -Relicts from several decades have gathered in the code base, 1.51 +Relics from several decades have gathered in the code base, 1.52 but seldom obsolete features were dropped. 1.53 This section describes the removing of old code 1.54 and the modernizing of the default setup. 1.55 @@ -1661,7 +1679,7 @@ 1.56 .Cf code-style . 1.57 1.58 1.59 -.H2 "Code Relicts 1.60 +.H2 "Code Relics 1.61 .P 1.62 My position regarding the removal of obsolete functions of mmh, 1.63 .\" XXX ``in order to remove old code,''