Mercurial > docs > master

comparison discussion.roff @ 212:9317d789cef9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Various improvements and rework.
author markus schnalke <meillo@marmaro.de>
date Thu, 12 Jul 2012 22:04:51 +0200
parents c299ed65d015
children f3f65376bef9
comparison
equal deleted inserted replaced
211:ff303d854771 212:9317d789cef9
399 main use case had been accessing Bulletin Boards, which have ceased to 399 main use case had been accessing Bulletin Boards, which have ceased to
400 be popular. 400 be popular.
401 .P 401 .P
402 Removing 402 Removing
403 .Pn msh 403 .Pn msh
404 together with the truly archaic code relicts 404 together with the truly archaic code relics
405 .Pn vmh 405 .Pn vmh
406 and 406 and
407 .Pn wmh 407 .Pn wmh
408 saved more than 7\|000 lines of C code \(en 408 saved more than 7\|000 lines of C code \(en
409 about 15\|% of the project's original source code amount. 409 about 15\|% of the project's original source code amount.
1026 1026
1027 1027
1028 1028
1029 .H2 "Command Line Switches 1029 .H2 "Command Line Switches
1030 .P 1030 .P
1031 The command line switches of MH tools is similar to the X Window style. 1031 The command line switches of MH tools are similar to the X Window style.
1032 .\" XXX ref 1032 .\" XXX ref
1033 They are words, introduced by a single dash. 1033 They consist of a single dash (`\fL-\fP') followed by a word.
1034 For example: 1034 To ease typing, the word can be abbreviated, given the remaining
1035 .Cl "-truncate" . 1035 prefix remains unambiguous.
1036 If no other switch starts with the letter `t', then any of
1037 .Cl "-truncate" ,
1038 .Cl "-trunc" ,
1039 .Cl "-tr" ,
1040 and
1041 .Cl "-t
1042 is equal.
1043 As a result, switches can neither be grouped (as in
1044 .Cl "ls -ltr" )
1045 nor can switch arguments be appended directly to the switch (as in
1046 .Cl "sendmail -q30m" ).
1047 Many switches have negating counter-parts, which start with `no'.
1048 For example
1049 .Cl "-notruncate
1050 inverts the
1051 .Cl "-truncate
1052 switch.
1053 They exist to override the effect of default switches in the profile.
1036 Every program in mmh has two generic switches: 1054 Every program in mmh has two generic switches:
1037 .Sw -help , 1055 .Sw -help ,
1038 to print a short message on how to use the program, and 1056 to print a short message on how to use the program, and
1039 .Sw -Version 1057 .Sw -Version
1040 (with capital `V'), to tell what version of mmh the program belongs to. 1058 (with capital `V'), to tell what version of mmh the program belongs to.
1650 .P 1668 .P
1651 In the more than thirty years of MH's existence, its code base was 1669 In the more than thirty years of MH's existence, its code base was
1652 increasingly extended. 1670 increasingly extended.
1653 New features entered the project and became alternatives to the 1671 New features entered the project and became alternatives to the
1654 existing behavior. 1672 existing behavior.
1655 Relicts from several decades have gathered in the code base, 1673 Relics from several decades have gathered in the code base,
1656 but seldom obsolete features were dropped. 1674 but seldom obsolete features were dropped.
1657 This section describes the removing of old code 1675 This section describes the removing of old code
1658 and the modernizing of the default setup. 1676 and the modernizing of the default setup.
1659 It focuses on the functional aspect only; 1677 It focuses on the functional aspect only;
1660 the non-functional aspects of code style are discussed in Sec. 1678 the non-functional aspects of code style are discussed in Sec.
1661 .Cf code-style . 1679 .Cf code-style .
1662 1680
1663 1681
1664 .H2 "Code Relicts 1682 .H2 "Code Relics
1665 .P 1683 .P
1666 My position regarding the removal of obsolete functions of mmh, 1684 My position regarding the removal of obsolete functions of mmh,
1667 .\" XXX ``in order to remove old code,'' 1685 .\" XXX ``in order to remove old code,''
1668 is much more revolutional than the nmh community appreciates. 1686 is much more revolutional than the nmh community appreciates.
1669 Working on an experimental version, I was quickly able to drop 1687 Working on an experimental version, I was quickly able to drop