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,''