annotate unix-phil.ms @ 20:578d5c84e5c0

a lot about mh (ch04)
author meillo@marmaro.de
date Fri, 26 Feb 2010 00:57:37 +0100
parents d8f428cee0d1
children ca929b042039
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
1 .\".if n .pl 1000i
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
2 .de XX
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
3 .pl 1v
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
4 ..
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
5 .em XX
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
6 .\".nr PI 0
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
7 .\".if t .nr PD .5v
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
8 .\".if n .nr PD 1v
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
9 .nr lu 0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
10 .de CW
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
11 .nr PQ \\n(.f
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
12 .if t .ft CW
17
ef67aad148f6 substitutet \a with ^ in CW macro
meillo@marmaro.de
parents: 16
diff changeset
13 .ie ^\\$1^^ .if n .ul 999
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
14 .el .if n .ul 1
17
ef67aad148f6 substitutet \a with ^ in CW macro
meillo@marmaro.de
parents: 16
diff changeset
15 .if t .if !^\\$1^^ \&\\$1\f\\n(PQ\\$2
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
16 .if n .if \\n(.$=1 \&\\$1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
17 .if n .if \\n(.$>1 \&\\$1\c
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
18 .if n .if \\n(.$>1 \&\\$2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
19 ..
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
20 .ds [. \ [
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
21 .ds .] ]
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
22 .\"----------------------------------------
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
23 .TL
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
24 Why the Unix Philosophy still matters
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
25 .AU
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
26 markus schnalke <meillo@marmaro.de>
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
27 .AB
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
28 .ti \n(.iu
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
29 This paper discusses the importance of the Unix Philosophy in software design.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
30 Today, few software designers are aware of these concepts,
3
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
31 and thus most modern software is limited and does not make use of software leverage.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
32 Knowing and following the tenets of the Unix Philosophy makes software more valuable.
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
33 .AE
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
34
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
35 .\".if t .2C
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
36
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
37 .FS
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
38 .ps -1
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
39 This paper was prepared for the seminar ``Software Analysis'' at University Ulm.
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
40 Mentor was professor Schweiggert. 2010-02-05
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
41 .br
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
42 You may get this document from my website
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
43 .CW \s-1http://marmaro.de/docs
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
44 .FE
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
45
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
46 .NH 1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
47 Introduction
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
48 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
49 Building a software is a process from an idea of the purpose of the software
3
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
50 to its release.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
51 No matter \fIhow\fP the process is run, two things are common:
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
52 the initial idea and the release.
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
53 The process in between can be of any shape.
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
54 The the maintenance work after the release is ignored for the moment.
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
55 .PP
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
56 The process of building splits mainly in two parts:
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
57 the planning of what and how to build, and implementing the plan by writing code.
3
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
58 This paper focuses on the planning part \(en the designing of the software.
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
59 .PP
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
60 Software design is the plan of how the internals and externals of the software should look like,
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
61 based on the requirements.
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
62 This paper discusses the recommendations of the Unix Philosophy about software design.
3
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
63 .PP
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
64 The here discussed ideas can get applied by any development process.
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
65 The Unix Philosophy does recommend how the software development process should look like,
3
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
66 but this shall not be of matter here.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
67 Similar, the question of how to write the code is out of focus.
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
68 .PP
3
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
69 The name ``Unix Philosophy'' was already mentioned several times, but it was not explained yet.
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
70 The Unix Philosophy is the essence of how the Unix operating system and its toolchest was designed.
3
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
71 It is no limited set of rules, but what people see to be common to typical Unix software.
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
72 Several people stated their view on the Unix Philosophy.
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
73 Best known are:
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
74 .IP \(bu
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
75 Doug McIlroy's summary: ``Write programs that do one thing and do it well.''
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
76 .[
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
77 %A M. D. McIlroy
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
78 %A E. N. Pinson
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
79 %A B. A. Taque
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
80 %T UNIX Time-Sharing System Forward
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
81 %J The Bell System Technical Journal
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
82 %D 1978
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
83 %V 57
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
84 %N 6
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
85 %P 1902
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
86 .]
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
87 .IP \(bu
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
88 Mike Gancarz' book ``The UNIX Philosophy''.
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
89 .[
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
90 %A Mike Gancarz
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
91 %T The UNIX Philosophy
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
92 %D 1995
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
93 %I Digital Press
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
94 .]
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
95 .IP \(bu
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
96 Eric S. Raymond's book ``The Art of UNIX Programming''.
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
97 .[
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
98 %A Eric S. Raymond
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
99 %T The Art of UNIX Programming
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
100 %D 2003
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
101 %I Addison-Wesley
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
102 %O .CW \s-1http://www.faqs.org/docs/artu/
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
103 .]
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
104 .LP
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
105 These different views on the Unix Philosophy have much in common.
3
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
106 Especially, the main concepts are similar for all of them.
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
107 But there are also points on which they differ.
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
108 This only underlines what the Unix Philosophy is:
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
109 A retrospective view on the main concepts of Unix software;
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
110 especially those that were successful and unique to Unix.
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
111 .\" really?
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
112 .PP
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
113 Before we will have a look at concrete concepts,
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
114 we discuss why software design is important
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
115 and what problems bad design introduces.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
116
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
117
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
118 .NH 1
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
119 Importance of software design in general
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
120 .LP
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
121 Why should we design software at all?
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
122 It is general knowledge, that even a bad plan is better than no plan.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
123 Ignoring software design is programming without a plan.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
124 This will lead pretty sure to horrible results.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
125 .PP
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
126 The design of a software is its internal and external shape.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
127 The design talked about here has nothing to do with visual appearance.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
128 If we see a program as a car, then its color is of no matter.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
129 Its design would be the car's size, its shape, the number and position of doors,
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
130 the ratio of passenger and cargo transport, and so forth.
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
131 .PP
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
132 A software's design is about quality properties.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
133 Each of the cars may be able to drive from A to B,
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
134 but it depends on its properties whether it is a good car for passenger transport or not.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
135 It also depends on its properties if it is a good choice for a rough mountain area.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
136 .PP
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
137 Requirements to a software are twofold: functional and non-functional.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
138 Functional requirements are easier to define and to verify.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
139 They are directly the software's functions.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
140 Functional requirements are the reason why software gets written.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
141 Someone has a problem and needs a tool to solve it.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
142 Being able to solve the problem is the main functional requirement.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
143 It is the driving force behind all programming effort.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
144 .PP
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
145 On the other hand, there are also non-functional requirements.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
146 They are called \fIquality\fP requirements, too.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
147 The quality of a software is about properties that are not directly related to
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
148 the software's basic functions.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
149 Quality aspects are about the properties that are overlooked at first sight.
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
150 .PP
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
151 Quality is of few matter when the software gets initially built,
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
152 but it will be of matter in usage and maintenance of the software.
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
153 A short-sighted might see in developing a software mainly building something up.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
154 Reality shows, that building the software the first time is only a small amount
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
155 of the overall work.
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
156 Bug fixing, extending, rebuilding of parts \(en short: maintenance work \(en
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
157 does soon take over the major part of the time spent on a software.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
158 Not to forget the usage of the software.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
159 These processes are highly influenced by the software's quality.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
160 Thus, quality should never be neglected.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
161 The problem is that you hardly ``stumble over'' bad quality during the first build,
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
162 but this is the time when you should care about good quality most.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
163 .PP
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
164 Software design is not about the basic function of a software;
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
165 this requirement will get satisfied anyway, as it is the main driving force behind the development.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
166 Software design is about quality aspects of the software.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
167 Good design will lead to good quality, bad design to bad quality.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
168 The primary functions of the software will be affected modestly by bad quality,
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
169 but good quality can provide a lot of additional gain from the software,
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
170 even at places where one never expected it.
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
171 .PP
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
172 The ISO/IEC 9126-1 standard, part 1,
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
173 .[
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
174 %I International Organization for Standardization
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
175 %T ISO Standard 9126: Software Engineering \(en Product Quality, part 1
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
176 %C Geneve
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
177 %D 2001
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
178 .]
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
179 defines the quality model as consisting out of:
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
180 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
181 .I Functionality
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
182 (suitability, accuracy, inter\%operability, security)
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
183 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
184 .I Reliability
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
185 (maturity, fault tolerance, recoverability)
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
186 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
187 .I Usability
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
188 (understandability, learnability, operability, attractiveness)
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
189 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
190 .I Efficiency
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
191 (time behavior, resource utilization)
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
192 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
193 .I Maintainability
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
194 (analysability, changeability, stability, testability)
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
195 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
196 .I Portability
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
197 (adaptability, installability, co-existence, replaceability)
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
198 .LP
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
199 These goals are parts of a software's design.
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
200 Good design can give these properties to a software,
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
201 bad designed software will miss them.
7
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
202 .PP
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
203 One further goal of software design is consistency.
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
204 Consistency eases understanding, working on, and using things.
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
205 Consistent internals and consistent interfaces to the outside can be provided by good design.
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
206 .PP
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
207 We should design software because good design avoids many problems during a software's lifetime.
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
208 And we should design software because good design can offer much gain,
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
209 that can be unrelated to the software main intend.
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
210 Indeed, we should spend much effort into good design to make the software more valuable.
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
211 The Unix Philosophy shows how to design software well.
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
212 It offers guidelines to achieve good quality and high gain for the effort spent.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
213
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
214
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
215 .NH 1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
216 The Unix Philosophy
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
217 .LP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
218 The origins of the Unix Philosophy were already introduced.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
219 This chapter explains the philosophy, oriented on Gancarz,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
220 and shows concrete examples of its application.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
221
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
222 .NH 2
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
223 Pipes
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
224 .LP
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
225 Following are some examples to demonstrate how applied Unix Philosophy feels like.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
226 Knowledge of using the Unix shell is assumed.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
227 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
228 Counting the number of files in the current directory:
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
229 .DS I 2n
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
230 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
231 .ps -1
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
232 ls | wc -l
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
233 .DE
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
234 The
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
235 .CW ls
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
236 command lists all files in the current directory, one per line,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
237 and
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
238 .CW "wc -l
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
239 counts the number of lines.
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
240 .PP
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
241 Counting the number of files that do not contain ``foo'' in their name:
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
242 .DS I 2n
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
243 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
244 .ps -1
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
245 ls | grep -v foo | wc -l
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
246 .DE
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
247 Here, the list of files is filtered by
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
248 .CW grep
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
249 to remove all that contain ``foo''.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
250 The rest is the same as in the previous example.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
251 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
252 Finding the five largest entries in the current directory.
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
253 .DS I 2n
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
254 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
255 .ps -1
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
256 du -s * | sort -nr | sed 5q
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
257 .DE
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
258 .CW "du -s *
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
259 returns the recursively summed sizes of all files
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
260 \(en no matter if they are regular files or directories.
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
261 .CW "sort -nr
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
262 sorts the list numerically in reverse order.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
263 Finally,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
264 .CW "sed 5q
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
265 quits after it has printed the fifth line.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
266 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
267 The presented command lines are examples of what Unix people would use
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
268 to get the desired output.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
269 There are also other ways to get the same output.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
270 It's a user's decision which way to go.
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
271 .PP
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
272 The examples show that many tasks on a Unix system
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
273 are accomplished by combining several small programs.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
274 The connection between the single programs is denoted by the pipe operator `|'.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
275 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
276 Pipes, and their extensive and easy use, are one of the great
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
277 achievements of the Unix system.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
278 Pipes between programs have been possible in earlier operating systems,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
279 but it has never been a so central part of the concept.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
280 When, in the early seventies, Doug McIlroy introduced pipes for the
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
281 Unix system,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
282 ``it was this concept and notation for linking several programs together
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
283 that transformed Unix from a basic file-sharing system to an entirely new way of computing.''
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
284 .[
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
285 %T Unix: An Oral History
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
286 %O .CW \s-1http://www.princeton.edu/~hos/frs122/unixhist/finalhis.htm
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
287 .]
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
288 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
289 Being able to specify pipelines in an easy way is,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
290 however, not enough by itself.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
291 It is only one half.
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
292 The other is the design of the programs that are used in the pipeline.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
293 They have to interfaces that allows them to be used in such a way.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
294
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
295 .NH 2
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
296 Interface design
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
297 .LP
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
298 Unix is, first of all, simple \(en Everything is a file.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
299 Files are sequences of bytes, without any special structure.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
300 Programs should be filters, which read a stream of bytes from ``standard input'' (stdin)
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
301 and write a stream of bytes to ``standard output'' (stdout).
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
302 .PP
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
303 If the files \fIare\fP sequences of bytes,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
304 and the programs \fIare\fP filters on byte streams,
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
305 then there is exactly one standardized data interface.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
306 Thus it is possible to combine them in any desired way.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
307 .PP
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
308 Even a handful of small programs will yield a large set of combinations,
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
309 and thus a large set of different functions.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
310 This is leverage!
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
311 If the programs are orthogonal to each other \(en the best case \(en
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
312 then the set of different functions is greatest.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
313 .PP
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
314 Programs might also have a separate control interface,
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
315 besides their data interface.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
316 The control interface is often called ``user interface'',
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
317 because it is usually designed to be used by humans.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
318 The Unix Philosophy discourages to assume the user to be human.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
319 Interactive use of software is slow use of software,
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
320 because the program waits for user input most of the time.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
321 Interactive software requires the user to be in front of the computer
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
322 all the time.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
323 Interactive software occupy the user's attention while they are running.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
324 .PP
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
325 Now we come back to the idea of using several small programs, combined,
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
326 to have a more specific function.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
327 If these single tools would all be interactive,
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
328 how would the user control them?
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
329 It is not only a problem to control several programs at once if they run at the same time,
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
330 it also very inefficient to have to control each of the single programs
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
331 that are intended to work as one large program.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
332 Hence, the Unix Philosophy discourages programs to demand interactive use.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
333 The behavior of programs should be defined at invocation.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
334 This is done by specifying arguments (``command line switches'') to the program call.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
335 Gancarz discusses this topic as ``avoid captive user interfaces''.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
336 .[
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
337 %A Mike Gancarz
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
338 %T The UNIX Philosophy
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
339 %I Digital Press
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
340 %D 1995
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
341 %P 88 ff.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
342 .]
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
343 .PP
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
344 Non-interactive use is, during development, also an advantage for testing.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
345 Testing of interactive programs is much more complicated,
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
346 than testing of non-interactive programs.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
347
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
348 .NH 2
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
349 The toolchest approach
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
350 .LP
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
351 A toolchest is a set of tools.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
352 Instead of having one big tool for all tasks, one has many small tools,
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
353 each for one task.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
354 Difficult tasks are solved by combining several of the small, simple tools.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
355 .PP
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
356 The Unix toolchest \fIis\fP a set of small, (mostly) non-interactive programs
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
357 that are filters on byte streams.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
358 They are, to a large extend, unrelated in their function.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
359 Hence, the Unix toolchest provides a large set of functions
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
360 that can be accessed by combining the programs in the desired way.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
361 .PP
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
362 There are also advantages for developing small toolchest programs.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
363 It is easier and less error-prone to write small programs.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
364 It is also easier and less error-prone to write a large set of small programs,
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
365 than to write one large program with all the functionality included.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
366 If the small programs are combinable, then they offer even a larger set
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
367 of functions than the single large program.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
368 Hence, one gets two advantages out of writing small, combinable programs.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
369 .PP
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
370 There are two drawbacks of the toolchest approach.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
371 First, one simple, standardized, unidirectional interface has to be sufficient.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
372 If one feels the need for more ``logic'' than a stream of bytes,
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
373 then a different approach might be of need.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
374 But it is also possible, that he just can not imagine a design where
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
375 a stream of bytes is sufficient.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
376 By becoming more familiar with the ``Unix style of thinking'',
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
377 developers will more often and easier find simple designs where
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
378 a stream of bytes is a sufficient interface.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
379 .PP
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
380 The second drawback of a toolchest affects the users.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
381 A toolchest is often more difficult to use for novices.
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
382 It is necessary to become familiar with each of the tools,
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
383 to be able to use the right one in a given situation.
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
384 Additionally, one needs to combine the tools in a senseful way on its own.
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
385 This is like a sharp knife \(en it is a powerful tool in the hand of a master,
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
386 but of no good value in the hand of an unskilled.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
387 .PP
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
388 However, learning single, small tool of the toolchest is easier than
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
389 learning a complex tool.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
390 The user will have a basic understanding of a yet unknown tool,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
391 if the several tools of the toolchest have a common style.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
392 He will be able to transfer knowledge over one tool to another.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
393 .PP
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
394 Moreover, the second drawback can be removed easily by adding wrappers
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
395 around the single tools.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
396 Novice users do not need to learn several tools if a professional wraps
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
397 the single commands into a more high-level script.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
398 Note that the wrapper script still calls the small tools;
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
399 the wrapper script is just like a skin around.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
400 No complexity is added this way,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
401 but new programs can get created out of existing one with very low effort.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
402 .PP
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
403 A wrapper script for finding the five largest entries in the current directory
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
404 could look like this:
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
405 .DS I 2n
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
406 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
407 .ps -1
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
408 #!/bin/sh
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
409 du -s * | sort -nr | sed 5q
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
410 .DE
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
411 The script itself is just a text file that calls the command line
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
412 a professional user would type in directly.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
413 Making the program flexible on the number of entries it prints,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
414 is easily possible:
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
415 .DS I 2n
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
416 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
417 .ps -1
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
418 #!/bin/sh
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
419 num=5
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
420 [ $# -eq 1 ] && num="$1"
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
421 du -sh * | sort -nr | sed "${num}q"
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
422 .DE
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
423 This script acts like the one before, when called without an argument.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
424 But one can also specify a numerical argument to define the number of lines to print.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
425
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
426 .NH 2
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
427 A powerful shell
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
428 .LP
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
429 It was already said, that the Unix shell provides the possibility to
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
430 combine small programs into large ones easily.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
431 A powerful shell is a great feature in other ways, too.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
432 .PP
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
433 For instance by including a scripting language.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
434 The control statements are build into the shell.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
435 The functions, however, are the normal programs, everyone can use on the system.
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
436 Thus, the programs are known, so learning to program in the shell is easy.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
437 Using normal programs as functions in the shell programming language
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
438 is only possible because they are small and combinable tools in a toolchest style.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
439 .PP
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
440 The Unix shell encourages to write small scripts out of other programs,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
441 because it is so easy to do.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
442 This is a great step towards automation.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
443 It is wonderful if the effort to automate a task equals the effort
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
444 it takes to do it the second time by hand.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
445 If it is so, then the user will be happy to automate everything he does more than once.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
446 .PP
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
447 Small programs that do one job well, standardized interfaces between them,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
448 a mechanism to combine parts to larger parts, and an easy way to automate tasks,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
449 this will inevitably produce software leverage.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
450 Getting multiple times the benefit of an investment is a great offer.
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
451 .PP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
452 The shell also encourages rapid prototyping.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
453 Many well known programs started as quickly hacked shell scripts,
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
454 and turned into ``real'' programs, written in C, later.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
455 Building a prototype first is a way to avoid the biggest problems
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
456 in application development.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
457 Fred Brooks writes in ``No Silver Bullet'':
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
458 .[
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
459 %A Frederick P. Brooks, Jr.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
460 %T No Silver Bullet: Essence and Accidents of Software Engineering
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
461 %B Information Processing 1986, the Proceedings of the IFIP Tenth World Computing Conference
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
462 %E H.-J. Kugler
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
463 %D 1986
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
464 %P 1069\(en1076
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
465 %I Elsevier Science B.V.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
466 %C Amsterdam, The Netherlands
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
467 .]
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
468 .QP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
469 The hardest single part of building a software system is deciding precisely what to build.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
470 No other part of the conceptual work is so difficult as establishing the detailed
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
471 technical requirements, [...].
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
472 No other part of the work so cripples the resulting system if done wrong.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
473 No other part is more difficult to rectify later.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
474 .PP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
475 Writing a prototype is a great method to become familiar with the requirements
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
476 and to actually run into real problems.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
477 Today, prototyping is often seen as a first step in building a software.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
478 This is, of course, good.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
479 However, the Unix Philosophy has an \fIadditional\fP perspective on prototyping:
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
480 After having built the prototype, one might notice, that the prototype is already
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
481 \fIgood enough\fP.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
482 Hence, no reimplementation, in a more sophisticated programming language, might be of need,
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
483 for the moment.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
484 Maybe later, it might be neccessary to rewrite the software, but not now.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
485 .PP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
486 By delaying further work, one keeps the flexibility to react easily on
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
487 changing requirements.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
488 Software parts that are not written will not miss the requirements.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
489
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
490 .NH 2
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
491 Worse is better
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
492 .LP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
493 The Unix Philosophy aims for the 80% solution;
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
494 others call it the ``Worse is better'' approach.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
495 .PP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
496 First, practical experience shows, that it is almost never possible to define the
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
497 requirements completely and correctly the first time.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
498 Hence one should not try to; it will fail anyway.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
499 Second, practical experience shows, that requirements change during time.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
500 Hence it is best to delay requirement-based design decisions as long as possible.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
501 Also, the software should be small and flexible as long as possible
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
502 to react on changing requirements.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
503 Shell scripts, for example, are more easily adjusted as C programs.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
504 Third, practical experience shows, that maintenance is hard work.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
505 Hence, one should keep the amount of software as small as possible;
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
506 it should just fulfill the \fIcurrent\fP requirements.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
507 Software parts that will be written later, do not need maintenance now.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
508 .PP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
509 Starting with a prototype in a scripting language has several advantages:
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
510 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
511 As the initial effort is low, one will likely start right away.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
512 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
513 As working parts are available soon, the real requirements can get identified soon.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
514 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
515 When a software is usable, it gets used, and thus tested.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
516 Hence problems will be found at early stages of the development.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
517 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
518 The prototype might be enough for the moment,
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
519 thus further work on the software can be delayed to a time
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
520 when one knows better about the requirements and problems,
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
521 than now.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
522 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
523 Implementing now only the parts that are actually needed now,
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
524 requires fewer maintenance work.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
525 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
526 If the global situation changes so that the software is not needed anymore,
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
527 then less effort was spent into the project, than it would have be
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
528 when a different approach had been used.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
529
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
530 .NH 2
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
531 Upgrowth and survival of software
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
532 .LP
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
533 So far it was talked about \fIwriting\fP or \fIbuilding\fP software.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
534 Although these are just verbs, they do imply a specific view on the work process
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
535 they describe.
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
536 The better verb, however, is to \fIgrow\fP.
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
537 .PP
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
538 Creating software in the sense of the Unix Philosophy is an incremental process.
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
539 It starts with a first prototype, which evolves as requirements change.
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
540 A quickly hacked shell script might become a large, sophisticated,
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
541 compiled program this way.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
542 Its lifetime begins with the initial prototype and ends when the software is not used anymore.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
543 While being alive it will get extended, rearranged, rebuilt (from scratch).
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
544 Growing software matches the view that ``software is never finished. It is only released.''
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
545 .[
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
546 %O FIXME
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
547 %A Mike Gancarz
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
548 %T The UNIX Philosophy
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
549 %P 26
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
550 .]
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
551 .PP
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
552 Software can be seen as being controlled by evolutionary processes.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
553 Successful software is software that is used by many for a long time.
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
554 This implies that the software is needed, useful, and better than alternatives.
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
555 Darwin talks about: ``The survival of the fittest.''
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
556 .[
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
557 %O FIXME
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
558 %A Charles Darwin
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
559 .]
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
560 Transferred to software: The most successful software, is the fittest,
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
561 is the one that survives.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
562 (This may be at the level of one creature, or at the level of one species.)
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
563 The fitness of software is affected mainly by four properties:
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
564 portability of code, portability of data, range of usability, and reusability of parts.
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
565 .\" .IP \(bu
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
566 .\" portability of code
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
567 .\" .IP \(bu
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
568 .\" portability of data
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
569 .\" .IP \(bu
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
570 .\" range of usability
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
571 .\" .IP \(bu
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
572 .\" reuseability of parts
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
573 .PP
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
574 (1)
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
575 .I "Portability of code
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
576 means, using high-level programming languages,
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
577 sticking to the standard,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
578 and avoiding optimizations that introduce dependencies on specific hardware.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
579 Hardware has a much lower lifetime than software.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
580 By chaining software to a specific hardware,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
581 the software's lifetime gets shortened to that of this hardware.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
582 In contrast, software should be easy to port \(en
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
583 adaption is the key to success.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
584 .\" cf. practice of prog: ch08
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
585 .PP
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
586 (2)
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
587 .I "Portability of data
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
588 is best achieved by avoiding binary representations
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
589 to store data, because binary representations differ from machine to machine.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
590 Textual represenation is favored.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
591 Historically, ASCII was the charset of choice.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
592 In the future, UTF-8 might be the better choice, however.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
593 Important is that it is a plain text representation in a
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
594 very common charset encoding.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
595 Apart from being able to transfer data between machines,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
596 readable data has the great advantage, that humans are able
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
597 to directly edit it with text editors and other tools from the Unix toolchest.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
598 .\" gancarz tenet 5
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
599 .PP
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
600 (3)
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
601 A large
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
602 .I "range of usability
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
603 ensures good adaption, and thus good survival.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
604 It is a special distinction if a software becomes used in fields of action,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
605 the original authors did never imagine.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
606 Software that solves problems in a general way will likely be used
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
607 for all kinds of similar problems.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
608 Being too specific limits the range of uses.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
609 Requirements change through time, thus use cases change or even vanish.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
610 A good example in this point is Allman's sendmail.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
611 Allman identifies flexibility to be one major reason for sendmail's success:
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
612 .[
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
613 %O FIXME
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
614 %A Allman
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
615 %T sendmail
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
616 .]
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
617 .QP
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
618 Second, I limited myself to the routing function [...].
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
619 This was a departure from the dominant thought of the time, [...].
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
620 .QP
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
621 Third, the sendmail configuration file was flexible enough to adopt
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
622 to a rapidly changing world [...].
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
623 .LP
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
624 Successful software adopts itself to the changing world.
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
625 .PP
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
626 (4)
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
627 .I "Reuse of parts
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
628 is even one step further.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
629 A software may completely lose its field of action,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
630 but parts of which the software is build may be general and independent enough
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
631 to survive this death.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
632 If software is build by combining small independent programs,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
633 then there are parts readily available for reuse.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
634 Who cares if the large program is a failure,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
635 but parts of it become successful instead?
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
636
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
637 .NH 2
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
638 Summary
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
639 .LP
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
640 This chapter explained the central ideas of the Unix Philosophy.
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
641 For each of the ideas, it was exposed what advantages they introduce.
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
642 The Unix Philosophy are guidelines that help to write valuable software.
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
643 From the view point of a software developer or software designer,
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
644 the Unix Philosophy provides answers to many software design problem.
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
645 .PP
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
646 The various ideas of the Unix Philosophy are very interweaved
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
647 and can hardly be applied independently.
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
648 However, the probably most important messages are:
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
649 .I "``Do one thing well!''" ,
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
650 .I "``Keep it simple!''" ,
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
651 and
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
652 .I "``Use software leverage!''
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
653
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
654
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
655
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
656 .NH 1
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
657 Case study: \s-1MH\s0
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
658 .LP
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
659 The last chapter introduced and explained the Unix Philosophy
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
660 from a general point of view.
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
661 The driving force were the guidelines and references to
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
662 existing software were given only sparsely.
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
663 In this and the next chapter, concrete software will be
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
664 the driving force in the discussion.
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
665 .PP
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
666 This first case study is about the mail user agents \s-1MH\s0
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
667 (``mail handler'') and its descendent \fInmh\fP (``new mail handler'').
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
668 In this document, the name \s-1MH\s0 will be used for both of them.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
669 A distinction will only be made if differences between
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
670 them are described.
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
671
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
672
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
673 .NH 2
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
674 Historical background
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
675 .LP
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
676 Electronic mail was available in Unix very early.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
677 It is out of matter that in the beginning mail was only
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
678 transferred within one machine.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
679 This chapter is about a mail user agent (\s-1MUA\s0),
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
680 which provides functions to read, compose, and organize mail,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
681 but (ideally) not to transfer.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
682 .PP
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
683 The first \s-1MUA\s0 on Unix was \f(CWmail\fP.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
684 It was a small program that either prints the own mailbox file
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
685 or appends text to someone elses mailbox file,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
686 depending on the command line arguments.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
687 .[
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
688 %O http://cm.bell-labs.com/cm/cs/who/dmr/pdfs/man12.pdf
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
689 .]
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
690 It was a program that did one job well.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
691 This job was emailing, which then was very simple.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
692 .PP
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
693 Later, emailing became more powerfull, and thus more complex.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
694 The simple \f(CWmail\fP, which knew nothing of subjects,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
695 independent handling of single messages,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
696 and long-time storage of them, was not powerful enough anymore.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
697 At Berkeley, Kurt Shoens wrote \fIMail\fP (with capital `M')
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
698 in 1978 to provide additional functions for emailing.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
699 Mail was still one program, but now it was large and did
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
700 several jobs.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
701 Its user interface is modeled after the one of ed.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
702 It is designed for humans, but is still scriptable.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
703 \fImailx\fP is the adaption of Berkeley Mail into System V.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
704 .[
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
705 %A Gunnar Ritter
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
706 %O http://heirloom.sourceforge.net/mailx_history.html
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
707 .]
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
708 Elm, pine, mutt, and today a whole bunch of graphical \s-1MUA\s0s
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
709 followed Mail's direction.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
710 They are large, monolithic programs which include all emailing functions.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
711 .PP
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
712 A different way took the people of \s-1RAND\s0 Corporation.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
713 In the beginning, they also had used a monolitic mail system,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
714 simply called \s-1MS\s0 for ``mail system''.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
715 But in 1977, Stockton Gaines and Norman Shapiro
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
716 came up with a proposal of a new email system concept \(en
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
717 one that honors the Unix Philosophy.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
718 The concept was implemented by Bruce Borden in 1978 and 1979.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
719 This was the birth of \s-1MH\s0 \(en the ``mail handler''.
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
720 .PP
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
721 Since then, \s-1RAND\s0, the University of California at Irvine and
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
722 at Berkeley, and several others have contributed to the software.
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
723 However, it's core concepts remained the same.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
724 In the 90s, when development of \s-1MH\s0 slowed down,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
725 Richard Coleman started with \fInmh\fP, the new mail handler.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
726 This was in 1997.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
727 His goal was to improve \s-1MH\s0, especially in regard of
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
728 the requirements of modern email.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
729 Today, nmh is developed by various people on the Internet.
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
730 .[
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
731 %T RAND and the Information Evolution: A History in Essays and Vignettes
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
732 %A Willis H. Ware
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
733 %D 2008
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
734 %I The RAND Corporation
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
735 %P 128\(en137
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
736 %O .CW \s-1http://www.rand.org/pubs/corporate_pubs/CP537/
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
737 .]
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
738 .[
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
739 %T MH & xmh: Email for Users & Programmers
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
740 %A Jerry Peek
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
741 %D 1991, 1992, 1995
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
742 %I O'Reilly & Associates, Inc.
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
743 %P Appendix B
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
744 %O Also available online: \f(CW\s-2http://rand-mh.sourceforge.net/book/\fP
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
745 .]
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
746
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
747 .NH 2
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
748 Contrasts to monolithic mail systems
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
749 .LP
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
750 All \s-1MUA\s0s are monolithic, except \s-1MH\s0.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
751 This might not be true,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
752 but it reflects the situation pretty well.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
753 .PP
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
754 While monolithic \s-1MUA\s0s gather all function in one program,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
755 \s-1MH\s0 is a toolchest of many small tools \(en one for each job.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
756 Following is a list of important programs of \s-1MH\s0's toolchest:
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
757 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
758 .CW inc :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
759 incorporate new mail
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
760 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
761 .CW scan :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
762 list messages in folder
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
763 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
764 .CW show :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
765 show message
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
766 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
767 .CW next\fR/\fPprev :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
768 show next/previous message
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
769 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
770 .CW folder :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
771 change current folder
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
772 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
773 .CW refile :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
774 refile message into folder
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
775 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
776 .CW rmm :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
777 remove message
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
778 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
779 .CW comp :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
780 compose a new message
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
781 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
782 .CW repl :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
783 reply to a message
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
784 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
785 .CW forw :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
786 forward a message
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
787 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
788 .CW send :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
789 send a prepared message
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
790 .LP
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
791 \s-1MH\s0 has no special user interface like monolithic \s-1MUA\s0s have.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
792 The user does not leave the shell to run \s-1MH\s0,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
793 but he uses \s-1MH\s0 within the shell.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
794 \s-1MH\s0's mail storage is (only little more than) a directory tree
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
795 where directories are mail folders and files are mail messages.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
796 Working with \s-1MH\s0's toolchest is much like working
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
797 with Unix' toolchest:
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
798 \f(CWscan\fP is like \f(CWls\fP,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
799 \f(CWshow\fP is like \f(CWcat\fP,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
800 \f(CWfolder\fP is like \f(CWcd\fP,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
801 \f(CWrefile\fP is like \f(CWmv\fP,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
802 and \f(CWrmm\fP is like \f(CWrm\fP.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
803 .PP
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
804 The context of the Unix tools is mainly the current working directory,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
805 the user identification, and the environment variables.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
806 \s-1MH\s0 extends this context by two more items:
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
807 The current mail folder, similar to the current working directory,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
808 for which \f(CWfolder\fP provides the functionality of
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
809 \f(CWpwd\fP and \f(CWcd\fP.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
810 And the current message, relative to the current mail folder,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
811 which enables commands like \f(CWnext\fP and \f(CWprev\fP.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
812 In contrast to Unix' context, which is chained to the shell session,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
813 \s-1MH\s0's context is meant to be chained to a mail account.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
814 But actually, the current message is a property of the mail folder,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
815 which is mainly a legacy.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
816 This will cause problems when multiple users work
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
817 in one mail folder simultaneously.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
818 .PP
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
819 Using a monolithic program with a captive user interface
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
820 means ``entering'' the program, using it, and ``exiting'' the program.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
821 Using toolchests like \s-1MH\s0 means running programs,
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
822 alone or in combinition with others, even from other toolchests,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
823 without leaving the shell.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
824
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
825
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
826 .NH 2
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
827 Discussion of the design
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
828 .LP
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
829 The following paragraphs discuss \s-1MH\s0 in regard to the tenets
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
830 of the Unix Philosophy Gancarz identified.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
831
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
832 .PP
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
833 .I "``Small is beautiful''
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
834 and
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
835 .I "``do one thing well''
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
836 are two design goals that are directly visible in \s-1MH\s0.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
837 Gancarz actually presents \s-1MH\s0 as example under the headline
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
838 ``Making UNIX Do One Thing Well'':
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
839 .QP
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
840 [\s-1MH\s0] consists of a series of programs which
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
841 when combined give the user an enormous ability
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
842 to manipulate electronic mail messages.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
843 A complex application, it shows that not only is it
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
844 possible to build large applications from smaller
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
845 components, but also that such designs are actually preferable.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
846 .[
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
847 %A Mike Gancarz
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
848 %T unix-phil
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
849 %P 125
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
850 .]
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
851 .LP
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
852 The various small programs of \s-1MH\s0 were relatively easy
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
853 to write as each of them is small, limited to one function,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
854 and has clear bounderies.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
855 For the same reasons, they are also good to maintain.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
856 Further more, the system can easily get extended.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
857 One only needs to put a new program into the toolchest.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
858 This was done when \s-1MIME\s0 support was added
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
859 (e.g. \f(CWmhbuild\fP).
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
860 Also, different programs can exist to do the basically same job
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
861 in different ways (e.g. in nmh: \f(CWshow\fP and \f(CWmhshow\fP).
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
862 If someone needs a mail system with some additionally
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
863 functions that are nowhere available yet, he best takes a
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
864 toolchest system like \s-1MH\s0 where he can add the
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
865 functionality with little work.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
866
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
867 .PP
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
868 .I "Data storage.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
869 How \s-1MH\s0 stores data was already mentioned.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
870 Mail folders are directories (which contain a file
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
871 \&\f(CW.mh_sequences\fP) under the user's \s-1MH\s0 directory
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
872 (usually \f(CW$HOME/Mail\fP).
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
873 Mail messages are text files located in a mail folder.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
874 The files contain the messages as they were received.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
875 The messages are numbered in ascending order in each folder.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
876 This mailbox format is called ``\s-1MH\s0'' after the \s-1MUA\s0.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
877 Alternatives are \fImbox\fP and \fImaildir\fP.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
878 In the mbox format all messages are stored within one file.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
879 This was a good solution in the early days, when messages
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
880 were only a few lines of text and were deleted soon.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
881 Today, when single messages often include several megabytes
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
882 of attachments, it is a bad solution.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
883 Another disadvantage of the mbox format is that it is
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
884 more difficult to write tools that work on mail messages,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
885 because it is always neccessary to first find and extract
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
886 the relevant message in the mbox file.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
887 With \s-1MH\s0 mailboxes, each message is a self-standing item,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
888 by definition.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
889 Also, the problem of concurrent access to one mailbox is
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
890 reduced to the problem of concurrent access to one message.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
891 However, the issue of the shared parts of the context,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
892 as mentioned above, remains.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
893 Maildir is generally similar to \s-1MH\s0's format,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
894 but modified towards guaranteed reliability.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
895 This involves some complexity, unfortunately.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
896
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
897 .PP
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
898 .I "``Avoid captive user interfaces.''
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
899 \s-1MH\s0 is perfectly suited for non-interactive use.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
900 It offers all functions directly and without captive user interfaces.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
901 If users want a graphical user interface, anyhow,
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
902 they can have it with \fIxmh\fP or \fIexmh\fP, too.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
903 These are graphical frontends for the \s-1MH\s0 toolchest.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
904 This means, all email-related work is still done by \s-1MH\s0 tools,
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
905 but the frontend issues the appropriate calls when the user
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
906 clicks on a button.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
907 Providing easy-to-use user interfaces in form of frontends is a good
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
908 approach, because it does not limit the power of the backend itself.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
909 The frontend will anyway only be able to make a subset of the
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
910 backend's power and flexibility available.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
911 But if it is a separate program,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
912 then the missing parts can still be accessed at the backend directly.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
913 If it is integrated, then this will hardly be possible.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
914
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
915 .PP
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
916 .I "``Choose portability over efficiency''
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
917 and
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
918 .I "``use shell scripts to increase leverage and portability'' .
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
919 These two tenets are indirectly, but nicely, demonstrated by
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
920 Bolsky and Korn in their book about the korn shell.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
921 .[
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
922 %T The KornShell: command and programming language
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
923 %A Morris I. Bolsky
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
924 %A David G. Korn
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
925 %I Prentice Hall
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
926 %D 1989
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
927 %O \s-1ISBN\s0: 0-13-516972-0
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
928 .]
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
929 They demonstrated, in one chapter of the book, a basic implementation
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
930 of a subset of \s-1MH\s0 in ksh scripts.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
931 Of course, this was just a demonstration, but a brilliant one.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
932 It shows how quickly one can implement such a prototype with shell scripts,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
933 and how readable they are.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
934 The implementation in the scripting language may not be very fast,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
935 but it can be fast enough though, and this is all that matters.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
936 By having the code in an interpreted language, like the shell,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
937 portability becomes a minor issue, if we assume the interpreter
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
938 to be widespread.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
939 This demonstration also shows how easy it is to create single programs
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
940 of a toolchest software.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
941 Most of the single programs comprise less than a hundred lines of
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
942 shell code.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
943 Such small software is easy to write, easy to understand,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
944 and thus easy to maintain.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
945 Being a toolchest improved the possibility to only write some parts
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
946 and though create a working result.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
947 Expanding the toolchest without global changes will likely be
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
948 possible, too.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
949
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
950 .PP
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
951 .I "``Use software leverage to your advantage''
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
952 and the lesser tenet
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
953 .I "``allow the user to tailor the environment''
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
954 are ideally followed in the design of \s-1MH\s0.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
955
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
956 .PP
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
957 filters: many tools provide basic FS operations (like mv, rm, ...)
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
958 prototypes: affect dev, but MH is very matured
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
959
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
960 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
961 Problems
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
962 .LP
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
963 modern emailing
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
964 MIME
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
965 encodings
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
966 largest problem: different feeling
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
967
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
968 .NH 2
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
969 Summary \s-1MH\s0
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
970 .LP
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
971 flexibility, no redundancy, use the shell
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
972
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
973
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
974
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
975 .NH 1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
976 Case study: uzbl
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
977
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
978 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
979 History
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
980 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
981 uzbl is young
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
982
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
983 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
984 Contrasts to similar sw
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
985 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
986 like with nmh
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
987 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
988 addons, plugins, modules
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
989
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
990 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
991 Gains of the design
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
992 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
993
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
994 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
995 Problems
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
996 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
997 broken web
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
998
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
999
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
1000
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1001 .NH 1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1002 Final thoughts
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1003
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1004 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1005 Quick summary
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1006 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1007 good design
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1008 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1009 unix phil
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1010 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1011 case studies
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1012
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1013 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1014 Why people should choose
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1015 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1016 Make the right choice!
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1017
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1018 .nr PI .5i
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1019 .rm ]<
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1020 .de ]<
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1021 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1022 .de FP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1023 .IP \\\\$1.
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1024 \\..
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1025 .rm FS FE
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1026 ..
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1027 .SH
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1028 References
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1029 .[
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1030 $LIST$
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1031 .]
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1032 .wh -1p