docs/master

changeset 69:f80ced4e749b

Wrote more about the show-mhshow merge.
author markus schnalke <meillo@marmaro.de>
date Sat, 02 Jun 2012 12:00:22 +0200
parents 7ca31b06b653
children d6840bfbe04c
files ch03.roff
diffstat 1 files changed, 75 insertions(+), 5 deletions(-) [+]
line diff
     1.1 --- a/ch03.roff	Sat Jun 02 11:58:40 2012 +0200
     1.2 +++ b/ch03.roff	Sat Jun 02 12:00:22 2012 +0200
     1.3 @@ -271,7 +271,7 @@
     1.4  
     1.5  .H2 "Merge of \f(CWshow\fP and \f(CWmhshow\fP
     1.6  .P
     1.7 -Since the very beginning, already in the first concept paper,
     1.8 +Since the very beginning \(en already in the first concept paper \(en
     1.9  .Pn show
    1.10  had been MH's message display program.
    1.11  .Pn show
    1.12 @@ -287,7 +287,7 @@
    1.13  .Pn mhl 's
    1.14  limited display facilities couldn't cope with the task any longer.
    1.15  .P
    1.16 -Instead of extending these tools, new ones were written from scratch
    1.17 +Instead of extending these tools, additional ones were written from scratch
    1.18  and then added to the MH tool chest. Doing so is encouraged by the
    1.19  tool chest approach. The new tools could be added without interfering
    1.20  with the existing ones. This is great. The ease of adding new tools
    1.21 @@ -303,12 +303,82 @@
    1.22  .Pn mhn
    1.23  into a set of specialized programs, which together covered the
    1.24  multiple aspects of MIME. One of these resulting tools was
    1.25 -.Pn mhshow .
    1.26 -.Pn mhshow
    1.27 -resembled the
    1.28 +.Pn mhshow ,
    1.29 +which replaced the
    1.30  .Cl "mhn \-show
    1.31  call.
    1.32  .P
    1.33 +From then on, two message display tools were part of nmh.
    1.34 +Because it should not require user actions to invoke the right tool
    1.35 +whether the message uses MIME or not,
    1.36 +.Pn show
    1.37 +was extended to automatically hand the job over to
    1.38 +.Pn mhshow
    1.39 +if displaying the message would be beyond
    1.40 +.Pn show 's
    1.41 +abilities.
    1.42 +For convenience,
    1.43 +.Pn show
    1.44 +would still display MIME messages if they contained only a single text
    1.45 +part.
    1.46 +In consequence, the user would invoke
    1.47 +.Pn show
    1.48 +(possibly through
    1.49 +.Pn next
    1.50 +or
    1.51 +.Pn prev )
    1.52 +and get the message printed with either
    1.53 +.Pn show
    1.54 +or
    1.55 +.Pn mhshow ,
    1.56 +whatever was more appropriate.
    1.57 +(There was also a switch for
    1.58 +.Pn show
    1.59 +to never invoke
    1.60 +.Pn mhshow .)
    1.61 +.P
    1.62 +Having two similar tools for essentially the same task is redundant.
    1.63 +Both programs needed to be developed syncronously as they were
    1.64 +used as a single tool by the user. Thus they needed to act in a
    1.65 +similar way to not distract the user.
    1.66 +.P
    1.67 +Today, non-MIME messages are rather seen to be a special case of
    1.68 +MIME messages, than MIME messages are seen to be an extension to
    1.69 +original mail.
    1.70 +As
    1.71 +.Pn mhshow
    1.72 +had already be able to display non-MIME messages, it was natural
    1.73 +to drop
    1.74 +.Pn show
    1.75 +in favor of using
    1.76 +.Pn mhshow
    1.77 +exclusively.
    1.78 +.Ci 4c1efdd
    1.79 +This decision follows the idea of orthogonal design.
    1.80 +.P
    1.81 +To allow this replacement,
    1.82 +.Pn mhshow
    1.83 +was reworked to behave more like
    1.84 +.Pn show
    1.85 +first.
    1.86 +Section XXX describes this rework from a different perspective.
    1.87 +Once the tools behaved similar, the replacing became a natural decision.
    1.88 +In mmh,
    1.89 +.Pn show
    1.90 +is the one single message display program again, but it handles
    1.91 +MIME messages as well as non-MIME messages.
    1.92 +There's only one program to maintain and users don't need to deal
    1.93 +with the existance of two display programs.
    1.94 +.P
    1.95 +Though, there's one reason why removing the old
    1.96 +.Pn show
    1.97 +hurts: It had been such a simple program.
    1.98 +Its lean elegance is missing to
    1.99 +.Pn mhshow ,
   1.100 +i.e. the new
   1.101 +.Pn show .
   1.102 +But there is no chance, because supporting MIME causes essentially
   1.103 +higher complexity.
   1.104  
   1.105  
   1.106  .H2 "Removal of Configure Options