Mercurial > docs > master

comparison discussion.roff @ 139:b7b81ae9c9d8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Removed and moved some paragraphs.
author markus schnalke <meillo@marmaro.de>
date Wed, 04 Jul 2012 23:51:08 +0200
parents cc35686f359e
children 3361e53dfcd6
comparison
equal deleted inserted replaced
138:cc35686f359e 139:b7b81ae9c9d8
1308 switches from 21 to 6. 1308 switches from 21 to 6.
1309 .Ci 350ad6d3542a07639213cf2a4fe524e829c1e7b6 1309 .Ci 350ad6d3542a07639213cf2a4fe524e829c1e7b6
1310 .Ci 0e46503be3c855bddaeae3843e1b659279c35d70 1310 .Ci 0e46503be3c855bddaeae3843e1b659279c35d70
1311 1311
1312 1312
1313 .U3 "Mail Transfer Switches
1314 .P
1315 With the removal of the mail transfer facilities, a lot of switches
1316 vanished automatically.
1317 .Pn inc
1318 lost 9 switches, namely
1319 .Sw -host ,
1320 .Sw -port ,
1321 .Sw -user ,
1322 .Sw -proxy ,
1323 .Sw -snoop ,
1324 .Sw -[no]pack ,
1325 as well as
1326 .Sw -sasl
1327 and
1328 .Sw -saslmech .
1329 .Pn send
1330 and
1331 .Pn post
1332 lost 11 switches each, namely
1333 .Sw -server ,
1334 .Sw -port ,
1335 .Sw -client ,
1336 .Sw -user ,
1337 .Sw -mail ,
1338 .Sw -saml ,
1339 .Sw -send ,
1340 .Sw -soml ,
1341 .Sw -snoop ,
1342 as well as
1343 .Sw -sasl ,
1344 .Sw -saslmech ,
1345 and
1346 .Sw -tls .
1347 .Pn send
1348 had the switches only to pass them further to
1349 .Pn post ,
1350 because the user would invoke
1351 .Pn post
1352 not directly, but through
1353 .Pn send .
1354 All these switches, except
1355 .Sw -snoop
1356 were usually defined as default switches in the user's profile,
1357 but hardly given in interactive usage.
1358 .P
1359 Of course, those switches did not really ``vanish'', but the configuration
1360 they did was handed over to external MSAs and MRAs.
1361 Instead of setting up the mail transfer in mmh, it is set up in
1362 external tools.
1363 Yet, this simplifies mmh.
1364 Specialized external tools will likely have simple configuration files.
1365 Hence, instead of having one complicated central configuration file,
1366 the configuration of each domain is separate.
1367 Although the user needs to learn to configure each of the tools,
1368 each configuration is likely much simpler.
1369
1370
1371 .U3 "Maildrop Formats
1372 .P
1373 With the removal of MMDF maildrop format support,
1374 .Pn packf
1375 and
1376 .Pn rcvpack
1377 no longer needed their
1378 .Sw -mbox
1379 and
1380 .Sw -mmdf
1381 switches.
1382 .Sw -mbox
1383 is the sole behavior now.
1384 .Ci 3916ab66ad5d183705ac12357621ea8661afd3c0
1385 In the same go,
1386 .Pn packf
1387 and
1388 .Pn rcvpack
1389 were reworked (see Sec. XXX) and their
1390 .Sw -file
1391 switch became unnecessary.
1392 .Ci ca1023716d4c2ab890696f3e41fa0d94267a940e
1393
1394
1395 .U3 "Terminal Magic
1396 .P
1397 Mmh's tools will no longer clear the screen (\c
1398 .Pn scan 's
1399 and
1400 .Pn mhl 's
1401 .Sw -[no]clear
1402 switches
1403 .Ci e57b17343dcb3ff373ef4dd089fbe778f0c7c270
1404 .Ci 943765e7ac5693ae177fd8d2b5a2440e53ce816e ).
1405 Neither will
1406 .Pn mhl
1407 ring the bell (\c
1408 .Sw -[no]bell
1409 .Ci e11983f44e59d8de236affa5b0d0d3067c192e24 )
1410 nor page the output itself (\c
1411 .Sw -length
1412 .Ci 5b9d883db0318ed2b84bb82dee880d7381f99188 ).
1413 .P
1414 Generally, the pager to use is no longer specified with the
1415 .Sw -[no]moreproc
1416 command line switches for
1417 .Pn mhl
1418 and
1419 .Pn show /\c
1420 .Pn mhshow .
1421 .Ci 39e87a75b5c2d3572ec72e717720b44af291e88a
1422 .P
1423 .Pn prompter
1424 lost its
1425 .Sw -erase
1426 and
1427 .Sw -kill
1428 switches because today the terminal cares for the line editing keys.
1429 1313
1430 1314
1431 .U3 "Header Printing 1315 .U3 "Header Printing
1432 .P 1316 .P
1433 .Pn folder 's 1317 .Pn folder 's
1471 evaluates to 1355 evaluates to
1472 .Sw -help 1356 .Sw -help
1473 for all tools of mmh. 1357 for all tools of mmh.
1474 1358
1475 1359
1476 .U3 "Suppressing Edits or the WhatNow Shell 1360 .U3 "Suppressing Edits or the Invocation of the WhatNow Shell
1477 .P 1361 .P
1478 The 1362 The
1479 .Sw -noedit 1363 .Sw -noedit
1480 switch of 1364 switch of
1481 .Pn comp , 1365 .Pn comp ,
1521 Likely, the 1405 Likely, the
1522 .Sw -nowhatnowproc 1406 .Sw -nowhatnowproc
1523 switch was intended to be used by front-ends. 1407 switch was intended to be used by front-ends.
1524 1408
1525 1409
1526 .U3 "Compatibility Switches 1410
1411 .U3 "Various
1527 .BU 1412 .BU
1528 The hidden 1413 With the removal of MMDF maildrop format support,
1529 .Sw -[no]total 1414 .Pn packf
1530 switches of 1415 and
1531 .Pn flist . 1416 .Pn rcvpack
1532 They were simply the inverse of the visible 1417 no longer needed their
1533 .Sw -[no]fast 1418 .Sw -mbox
1534 switches: 1419 and
1535 .Sw -total 1420 .Sw -mmdf
1536 was 1421 switches.
1537 .Sw -nofast 1422 .Sw -mbox
1538 and 1423 is the sole behavior now.
1539 .Sw -nototal 1424 .Ci 3916ab66ad5d183705ac12357621ea8661afd3c0
1540 was 1425 In the same go,
1541 .Sw -fast . 1426 .Pn packf
1542 I removed the 1427 and
1543 .Sw -[no]total 1428 .Pn rcvpack
1544 legacy. 1429 were reworked (see Sec. XXX) and their
1545 .Ci ea21fe2c4bd23c639bef251398fae809875732ec 1430 .Sw -file
1431 switch became unnecessary.
1432 .Ci ca1023716d4c2ab890696f3e41fa0d94267a940e
1433
1546 .BU 1434 .BU
1547 The 1435 Mmh's tools will no longer clear the screen (\c
1548 .Sw -subject 1436 .Pn scan 's
1549 switch of 1437 and
1550 .Pn sortm 1438 .Pn mhl 's
1551 existed for compatibility only. 1439 .Sw -[no]clear
1552 It can be fully replaced by 1440 switches
1553 .Cl "-textfield subject 1441 .Ci e57b17343dcb3ff373ef4dd089fbe778f0c7c270
1554 thus it was removed. 1442 .Ci 943765e7ac5693ae177fd8d2b5a2440e53ce816e ).
1555 .Ci 00140a3c86e9def69d98ba2ffd4d6e50ef6326ea 1443 Neither will
1556 1444 .Pn mhl
1557 1445 ring the bell (\c
1558 .U3 "Various 1446 .Sw -[no]bell
1447 .Ci e11983f44e59d8de236affa5b0d0d3067c192e24 )
1448 nor page the output itself (\c
1449 .Sw -length
1450 .Ci 5b9d883db0318ed2b84bb82dee880d7381f99188 ).
1451 Generally, the pager to use is no longer specified with the
1452 .Sw -[no]moreproc
1453 command line switches for
1454 .Pn mhl
1455 and
1456 .Pn show /\c
1457 .Pn mhshow .
1458 .Ci 39e87a75b5c2d3572ec72e717720b44af291e88a
1459
1559 .BU 1460 .BU
1560 In order to avoid prefix collisions among switch names, the 1461 In order to avoid prefix collisions among switch names, the
1561 .Sw -version 1462 .Sw -version
1562 switch was renamed to 1463 switch was renamed to
1563 .Sw -Version 1464 .Sw -Version
1570 switch, present in many programs. 1471 switch, present in many programs.
1571 The rename solved this problem once for all. 1472 The rename solved this problem once for all.
1572 Although this rename breaks a basic interface, having the 1473 Although this rename breaks a basic interface, having the
1573 .Sw -V 1474 .Sw -V
1574 abbreviation to display the version information, isn't all too bad. 1475 abbreviation to display the version information, isn't all too bad.
1476
1575 .BU 1477 .BU
1576 .Sw -[no]preserve 1478 .Sw -[no]preserve
1577 of 1479 of
1578 .Pn refile 1480 .Pn refile
1579 was removed because what use was it anyway? 1481 was removed because what use was it anyway?
1585 to preserve the number of the message. If a conflict for a 1487 to preserve the number of the message. If a conflict for a
1586 particular folder occurs when using the \-preserve switch, 1488 particular folder occurs when using the \-preserve switch,
1587 then refile will use the next available message number which 1489 then refile will use the next available message number which
1588 is above the message number you wish to preserve. 1490 is above the message number you wish to preserve.
1589 .QE 1491 .QE
1492
1590 .BU 1493 .BU
1591 The removal of the 1494 The removal of the
1592 .Sw -[no]reverse 1495 .Sw -[no]reverse
1593 switches of 1496 switches of
1594 .Pn scan 1497 .Pn scan
1836 1739
1837 1740
1838 .U3 "MMDF maildrop support 1741 .U3 "MMDF maildrop support
1839 .P 1742 .P
1840 This type of format is conceptionally similar to the mbox format, 1743 This type of format is conceptionally similar to the mbox format,
1841 but uses a different message delimiter (`\fL^A^A^A^A\fP' instead of 1744 but uses a different message delimiter (`\fL\\1\\1\\1\\1\fP',
1842 `\fLFrom\0\fP'). 1745 commonly written as `\fL^A^A^A^A\fP', instead of `\fLFrom\0\fP').
1843 Mbox is the de-facto standard maildrop format on Unix, 1746 Mbox is the de-facto standard maildrop format on Unix,
1844 whereas the MMDF maildrop format became forgotten. 1747 whereas the MMDF maildrop format became forgotten.
1845 I did drop MMDF maildrop format support. 1748 I did drop MMDF maildrop format support.
1846 Mbox is the only packed mailbox format supported in mmh. 1749 Mbox is the only packed mailbox format supported in mmh.
1847 .P 1750 .P
3532 .P 3435 .P
3533 I have replaced the 3436 I have replaced the
3534 .Fu atooi() 3437 .Fu atooi()
3535 function with calls to 3438 function with calls to
3536 .Fu strtoul() 3439 .Fu strtoul()
3537 with the third parameter \(en the base \(en set to eight. 3440 with the third parameter, the base, set to eight.
3538 .Fu strtoul() 3441 .Fu strtoul()
3539 is part of C89 and thus considered safe to use. 3442 is part of C89 and thus considered safe to use.
3540 .Ci c490c51b3c0f8871b6953bd0c74551404f840a74 3443 .Ci c490c51b3c0f8871b6953bd0c74551404f840a74
3541 .P 3444 .P
3542 I did remove project-included fallback implementations of 3445 I did remove project-included fallback implementations of
3887 .P 3790 .P
3888 As I have read a lot in the code base during the last two years, 3791 As I have read a lot in the code base during the last two years,
3889 I learned about the easy and the difficult parts. 3792 I learned about the easy and the difficult parts.
3890 Code is easy to understand if: 3793 Code is easy to understand if:
3891 .BU 3794 .BU
3892 The influenced code area is small 3795 The influenced code area is small.
3893 .BU 3796 .BU
3894 The boundaries are strictly defined 3797 The boundaries are strictly defined.
3895 .BU 3798 .BU
3896 The code is written straight-forward 3799 The code is written straight-forward.
3897 .P 3800 .P
3898 .\" XXX move this paragraph somewhere else? 3801 .\" XXX move this paragraph somewhere else?
3899 Reading 3802 Reading
3900 .Pn rmm 's 3803 .Pn rmm 's
3901 source code in 3804 source code in