annotate unix-phil.ms @ 45:ade392f024aa

a lot of rework throughout the whole document
author meillo@marmaro.de
date Mon, 12 Apr 2010 09:33:01 +0200
parents 46e34e433231
children 98a1446744c7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1 .nr PS 11
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
2 .nr VS 13
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
3 .nr lu 0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
4 .de CW
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
5 .nr PQ \\n(.f
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
6 .if t .ft CW
17
ef67aad148f6 substitutet \a with ^ in CW macro
meillo@marmaro.de
parents: 16
diff changeset
7 .ie ^\\$1^^ .if n .ul 999
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
8 .el .if n .ul 1
17
ef67aad148f6 substitutet \a with ^ in CW macro
meillo@marmaro.de
parents: 16
diff changeset
9 .if t .if !^\\$1^^ \&\\$1\f\\n(PQ\\$2
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
10 .if n .if \\n(.$=1 \&\\$1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
11 .if n .if \\n(.$>1 \&\\$1\c
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
12 .if n .if \\n(.$>1 \&\\$2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
13 ..
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
14 .ds [. \ [
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
15 .ds .] ]
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
16
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
17 .rn NH _N
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
18 .de NH
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
19 .if '\\$1'1' .sp 2v
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
20 .if '\\$1'1' .nr PS +2
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
21 ._N \\$1
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
22 .if '\\$1'1' .nr PS -2
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
23 ..
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
24
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
25 .am QP
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
26 .ps -1
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
27 ..
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
28
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
29 .\"----------------------------------------
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
30
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
31 .TL
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
32 .ps +4
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
33 Why the Unix Philosophy still matters
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
34 .AU
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
35 markus schnalke <meillo@marmaro.de>
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
36 .AB
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
37 .ti \n(.iu
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
38 This paper explains the importance of the Unix Philosophy for software design.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
39 Today, few software designers are aware of these concepts,
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
40 and thus a lot of modern software is more limited than necessary
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
41 and makes less use of software leverage than possible.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
42 Knowing and following the guidelines of the Unix Philosophy makes software more valuable.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
43 .AE
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
44
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
45 .FS
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
46 .ps -1
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
47 This paper was prepared for the ``Software Analysis'' seminar at University Ulm.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
48 Mentor was professor Schweiggert. 2010-04-05
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
49 .br
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
50 You may retrieve this document from
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
51 .CW \s-1http://marmaro.de/docs \ .
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
52 .FE
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
53
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
54 .NH 1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
55 Introduction
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
56 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
57 \*(SN Introduction
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
58 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
59 .LP
40
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
60 The Unix Philosophy is the essence of how the Unix operating system,
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
61 especially its toolchest, was designed.
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
62 It is no limited set of fixed rules,
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
63 but a loose set of guidelines which tell how to write software that
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
64 suites well into Unix.
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
65 Actually, the Unix Philosophy describes what is common to typical Unix software.
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
66 The Wikipedia has an accurate definition:
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
67 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
68 wikipedia
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
69 unix philosophy
40
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
70 .]
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
71 .QP
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
72 The \fIUnix philosophy\fP is a set of cultural norms and philosophical
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
73 approaches to developing software based on the experience of leading
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
74 developers of the Unix operating system.
3
aebbe3e76f5e minor rework
meillo@marmaro.de
parents: 2
diff changeset
75 .PP
40
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
76 As there is no single definition of the Unix Philosophy,
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
77 several people have stated their view on what it comprises.
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
78 Best known are:
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
79 .IP \(bu
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
80 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
81 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
82 mahoney
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
83 oral history
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
84 .]
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
85 .IP \(bu
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
86 Mike Gancarz' book ``The UNIX Philosophy''.
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
87 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
88 gancarz
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
89 unix philosophy
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
90 .]
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
91 .IP \(bu
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
92 Eric S. Raymond's book ``The Art of UNIX Programming''.
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
93 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
94 raymond
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
95 art of unix programming
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
96 .]
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
97 .LP
1
9b555c009f19 further text in intro
meillo@marmaro.de
parents: 0
diff changeset
98 These different views on the Unix Philosophy have much in common.
40
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
99 Especially, the main concepts are similar in all of them.
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
100 McIlroy's definition can surely be called the core of the Unix Philosophy,
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
101 but the fundamental idea behind it all, is ``small is beautiful''.
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
102
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
103 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
104 The Unix Philosophy explains how to design good software for Unix.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
105 Many concepts described here, base on facilities of Unix.
40
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
106 Other operating systems may not offer such facilities,
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
107 hence it may not be possible to design software in the way of the
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
108 Unix Philosophy for them.
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
109 .PP
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
110 The Unix Philosophy has an idea of how the process of software development
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
111 should look like, but large parts of the philosophy are quite independent
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
112 from a concrete development process.
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
113 However, one will soon recognize that some development processes work well
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
114 with the ideas of the Unix Philosophy and support them, while others are
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
115 at cross-purposes.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
116 Kent Beck's books about Extreme Programming are valuable supplemental
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
117 resources on this topic.
40
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
118 .PP
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
119 The question of how to actually write code and how the code should looks
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
120 like in detail, are out of focus here.
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
121 ``The Practice of Programming'' by Kernighan and Pike,
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
122 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
123 kernighan pike
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
124 practice of programming
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
125 .]
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
126 is a good book that covers this topic.
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
127 Its point of view matches to the one of this paper.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
128
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
129 .NH 1
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
130 Importance of software design in general
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
131 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
132 .sp .5v
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
133 \*(SN Importance of software design in general
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
134 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
135 .LP
40
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
136 Software design is the planning of how the internal structure
422679bdf384 rework in ch01
meillo@marmaro.de
parents: 39
diff changeset
137 and external interfaces of a software should look like.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
138 It has nothing to do with visual appearance.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
139 If we take a program as a car, then its color is of no matter.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
140 Its design would be the car's size, its shape, the locations of doors,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
141 the passenger/space ratio, the available controls and instruments,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
142 and so forth.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
143 .PP
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
144 Why should software get designed at all?
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
145 It is general knowledge, that even a bad plan is better than no plan.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
146 Not designing software means programming without plan.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
147 This will pretty sure lead to horrible results.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
148 Software that is horrible to use and horrible to maintain.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
149 These two aspects are the visible ones.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
150 Often invisible though, are the wasted possible gains.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
151 Good software design can make these gains available.
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
152 .PP
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
153 A software's design deals with quality properties.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
154 Good design leads to good quality, and quality is important.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
155 Any car may be able to drive from A to B,
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
156 but it depends on the car's properties whether it is a good choice
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
157 for passenger transport or not.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
158 It depends on its properties if it is a good choice
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
159 for a rough mountain area.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
160 And it depends on its properties if the ride will be fun.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
161
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
162 .PP
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
163 Requirements for a software are twofold:
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
164 functional and non-functional.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
165 .IP \(bu
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
166 Functional requirements define directly the software's functions.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
167 They are the reason why software gets written.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
168 Someone has a problem and needs a tool to solve it.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
169 Being able to solve the problem is the main functional goal.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
170 It is the driving force behind all programming effort.
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
171 Functional requirements are easier to define and to verify.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
172 .IP \(bu
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
173 Non-functional requirements are called \fIquality\fP requirements, too.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
174 The quality of a software are the properties that are not directly related to
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
175 the software's basic functions.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
176 Tools of bad quality often do solve the problems they were written for,
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
177 but introduce problems and difficulties for usage and development, later on.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
178 Quality aspects are often overlooked at first sight,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
179 and are often difficult to define clearly and to verify.
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
180 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
181 Quality is hardly interesting when the software gets built initially,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
182 but it has a high impact on usability and maintenance of the software, later.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
183 A short-sighted might see in developing a software, mainly building something up.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
184 But experience shows, that building the software the first time is
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
185 only a small amount of the overall work.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
186 Bug fixing, extending, rebuilding of parts \(en maintenance work \(en
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
187 does soon take over the major part of the time spent on a software.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
188 And of course, the time spent actually using the software.
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
189 These processes are highly influenced by the software's quality.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
190 Thus, quality must not be neglected.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
191 However, the problem with quality is that you hardly ``stumble over''
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
192 bad quality during the first build,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
193 although this is the time when you should care about good quality most.
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
194 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
195 Software design has little to do with the basic function of a software \(en
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
196 this requirement will get satisfied anyway.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
197 Software design is more about quality aspects of the software.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
198 Good design leads to good quality, bad design to bad quality.
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
199 The primary functions of the software will be affected modestly by bad quality,
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
200 but good quality can provide a lot of additional gain,
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
201 even at places where one never expected it.
2
fbd7baf6a61f added content about sw design; some formating
meillo@marmaro.de
parents: 1
diff changeset
202 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
203 The ISO/IEC\|9126-1 standard, part\|1,
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
204 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
205 iso product quality
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
206 .]
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
207 defines the quality model as consisting out of:
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
208 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
209 .I Functionality
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
210 (suitability, accuracy, inter\%operability, security)
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
211 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
212 .I Reliability
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
213 (maturity, fault tolerance, recoverability)
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
214 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
215 .I Usability
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
216 (understandability, learnability, operability, attractiveness)
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
217 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
218 .I Efficiency
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
219 (time behavior, resource utilization)
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
220 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
221 .I Maintainability
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
222 (analyzability, changeability, stability, testability)
6
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
223 .IP \(bu
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
224 .I Portability
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
225 (adaptability, installability, co-existence, replaceability)
a6b837d822b7 rewrote ch02
meillo@marmaro.de
parents: 5
diff changeset
226 .LP
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
227 Good design can improve these properties of a software,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
228 bad designed software likely suffers in these points.
7
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
229 .PP
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
230 One further goal of software design is consistency.
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
231 Consistency eases understanding, working on, and using things.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
232 Consistent internal structure and consistent interfaces to the outside
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
233 can be provided by good design.
7
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
234 .PP
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
235 Software should be well designed because good design avoids many
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
236 problems during a software's lifetime.
39
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
237 And software should be well designed because good design can offer
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
238 much additional gain.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
239 Indeed, much effort should be spent into good design to make software more valuable.
c87143793d82 a lot of rework in ch02
meillo@marmaro.de
parents: 38
diff changeset
240 The Unix Philosophy shows a way of how to design software well.
7
606f0ffca834 added two more paragraphs to ch02
meillo@marmaro.de
parents: 6
diff changeset
241 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
242
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
243
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
244 .NH 1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
245 The Unix Philosophy
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
246 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
247 .sp .5v
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
248 \*(SN The Unix Philosophy
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
249 .XE
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
250 .LP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
251 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
252 This chapter explains the philosophy, oriented on Gancarz,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
253 and shows concrete examples of its application.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
254
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
255 .NH 2
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
256 Pipes
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
257 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
258 \*(SN Pipes
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
259 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
260 .LP
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
261 Following are some examples to demonstrate how applied Unix Philosophy feels like.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
262 Knowledge of using the Unix shell is assumed.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
263 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
264 Counting the number of files in the current directory:
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
265 .DS
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
266 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
267 .ps -1
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
268 ls | wc -l
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
269 .DE
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
270 The
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
271 .CW ls
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
272 command lists all files in the current directory, one per line,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
273 and
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
274 .CW "wc -l
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
275 counts the number of lines.
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
276 .PP
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
277 Counting the number of files that do not contain ``foo'' in their name:
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
278 .DS
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
279 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
280 .ps -1
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
281 ls | grep -v foo | wc -l
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
282 .DE
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
283 Here, the list of files is filtered by
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
284 .CW grep
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
285 to remove all lines that contain ``foo''.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
286 The rest equals the previous example.
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
287 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
288 Finding the five largest entries in the current directory.
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
289 .DS
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
290 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
291 .ps -1
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
292 du -s * | sort -nr | sed 5q
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
293 .DE
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
294 .CW "du -s *
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
295 returns the recursively summed sizes of all files in the current directory
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
296 \(en no matter if they are regular files or directories.
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
297 .CW "sort -nr
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
298 sorts the list numerically in reverse order (descending).
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
299 Finally,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
300 .CW "sed 5q
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
301 quits after it has printed the fifth line.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
302 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
303 The presented command lines are examples of what Unix people would use
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
304 to get the desired output.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
305 There are also other ways to get the same output.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
306 It's a user's decision which way to go.
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
307 .PP
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
308 The examples show that many tasks on a Unix system
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
309 are accomplished by combining several small programs.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
310 The connection between the single programs is denoted by the pipe operator `|'.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
311 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
312 Pipes, and their extensive and easy use, are one of the great
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
313 achievements of the Unix system.
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
314 Pipes between programs have been possible in earlier operating systems,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
315 but it has never been a so central part of the concept.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
316 When, in the early seventies, Doug McIlroy introduced pipes into the
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
317 Unix system,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
318 ``it was this concept and notation for linking several programs together
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
319 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
320 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
321 aughenbaugh
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
322 unix oral history
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
323 .]
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
324 .PP
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
325 Being able to specify pipelines in an easy way is,
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
326 however, not enough by itself.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
327 It is only one half.
4
c707b0c5c849 new text about pipes
meillo@marmaro.de
parents: 3
diff changeset
328 The other is the design of the programs that are used in the pipeline.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
329 They need interfaces that allow them to be used in such a way.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
330
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
331 .NH 2
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
332 Interface design
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
333 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
334 \*(SN Interface design
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
335 .XE
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
336 .LP
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
337 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
338 Files are sequences of bytes, without any special structure.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
339 Programs should be filters, which read a stream of bytes from standard input (stdin)
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
340 and write a stream of bytes to standard output (stdout).
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
341 If the files \fIare\fP sequences of bytes,
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
342 and the programs \fIare\fP filters on byte streams,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
343 then there is exactly one data interface.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
344 Hence it is possible to combine programs in any desired way.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
345 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
346 Even a handful of small programs yields a large set of combinations,
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
347 and thus a large set of different functions.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
348 This is leverage!
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
349 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
350 then the set of different functions is greatest.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
351 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
352 Programs can also have a separate control interface,
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
353 besides their data interface.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
354 The control interface is often called ``user interface'',
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
355 because it is usually designed to be used by humans.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
356 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
357 Interactive use of software is slow use of software,
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
358 because the program waits for user input most of the time.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
359 Interactive software requires the user to be in front of the computer.
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
360 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
361 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
362 Now to come back to the idea of combining several small programs,
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
363 to have a more specific function.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
364 If these single tools would all be interactive,
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
365 how would the user control them?
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
366 It is not only a problem to control several programs at once,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
367 if they run at the same time,
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
368 it also very inefficient to have to control each of the single programs
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
369 that are intended to act as one large program.
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
370 Hence, the Unix Philosophy discourages programs to demand interactive use.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
371 The behavior of programs should be defined at invocation.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
372 This is done by specifying arguments to the program call
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
373 (command line switches).
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
374 Gancarz discusses this topic as ``avoid captive user interfaces''.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
375 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
376 gancarz unix philosophy
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
377 %P 88 ff.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
378 .]
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
379 .ds _p ", p. 88 ff.
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
380 .PP
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
381 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
382 Testing of interactive programs is much more complicated,
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
383 than testing of non-interactive programs.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
384
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
385 .NH 2
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
386 The toolchest approach
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
387 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
388 \*(SN The toolchest approach
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
389 .XE
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
390 .LP
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
391 A toolchest is a set of tools.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
392 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
393 each for one task.
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
394 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
395 .PP
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
396 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
397 that are filters on byte streams.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
398 They are, to a large extend, unrelated in their function.
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
399 Hence, the Unix toolchest provides a large set of functions
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
400 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
401 .PP
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
402 There are also advantages for developing small toolchest programs.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
403 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
404 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
405 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
406 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
407 of functions than the single large program.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
408 Hence, one gets two advantages out of writing small, combinable programs:
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
409 They are easier to write and they offer a greater set of functions through
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
410 combination.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
411 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
412 But there are also two main drawbacks of the toolchest approach.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
413 First, one simple, standardized interface has to be sufficient.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
414 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
415 then a different approach might be of need.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
416 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
417 a stream of bytes is sufficient.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
418 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
419 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
420 a stream of bytes is a sufficient interface.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
421 .PP
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
422 The second drawback of a toolchest affects the users.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
423 A toolchest is often more difficult to use.
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
424 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
425 to be able to use the right one in a given situation.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
426 Additionally, one needs to combine the tools in a senseful way himself.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
427 This is like a sharp knife \(en it is a powerful tool in the hand of a
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
428 master, but of no good value in the hand of an unskilled.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
429 However, learning single, small tools of a toolchest is easier than
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
430 learning a complex tool.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
431 And the user will already have a basic understanding of a yet unknown tool,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
432 if the tools of a toolchest have a common, consistent style.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
433 He will be able to transfer knowledge over from one tool to another.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
434 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
435 Moreover, the second drawback can be removed to a large extend
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
436 by adding wrappers around the basic tools.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
437 Novice users do not need to learn several tools, if a professional wraps
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
438 complete command lines into a higher-level script.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
439 Note that the wrapper script still calls the small tools;
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
440 it is just like a skin around them.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
441 No complexity is added this way.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
442 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
443 .PP
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
444 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
445 could look like this:
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
446 .DS
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
447 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
448 .ps -1
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
449 #!/bin/sh
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
450 du -s * | sort -nr | sed 5q
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
451 .DE
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
452 The script itself is just a text file that calls the command line,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
453 which a professional user would type in directly.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
454 It is probably worth to make the program flexible on the number of
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
455 entries it prints:
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
456 .DS
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
457 .CW
9
529168f49f29 corrected spelling
meillo@marmaro.de
parents: 8
diff changeset
458 .ps -1
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
459 #!/bin/sh
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
460 num=5
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
461 [ $# -eq 1 ] && num="$1"
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
462 du -sh * | sort -nr | sed "${num}q"
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
463 .DE
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
464 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
465 But one can also specify a numerical argument to define the number of lines to print.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
466 One can surely imagine even more flexible versions, however,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
467 they will still relay on the external programs,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
468 which do the actual work.
5
48f1f3465550 new content about interfaces and toolchests
meillo@marmaro.de
parents: 4
diff changeset
469
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
470 .NH 2
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
471 A powerful shell
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
472 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
473 \*(SN A powerful shell
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
474 .XE
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
475 .LP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
476 The Unix shell provides the possibility to combine small programs into large ones.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
477 But a powerful shell is a great feature in other ways, too.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
478 For instance by being scriptable.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
479 Control statements are build into the shell.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
480 The functions, however, are the normal programs of the system.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
481 Thus, as the programs are already known,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
482 learning to program in the shell becomes easy.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
483 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
484 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
485 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
486 The Unix shell encourages to write small scripts,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
487 by combining existing programs, because it is so easy to do.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
488 This is a great step towards automation.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
489 It is wonderful if the effort to automate a task equals the effort
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
490 to do the task a second time by hand.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
491 If this holds,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
492 then the user will be happy to automate everything he does more than once.
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
493 .PP
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
494 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
495 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
496 this will inevitably produce software leverage.
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
497 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
498 .PP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
499 The shell also encourages rapid prototyping.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
500 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
501 and turned into ``real'' programs, written in C, later.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
502 Building a prototype first, is a way to avoid the biggest problems
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
503 in application development.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
504 Fred Brooks explains in ``No Silver Bullet'':
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
505 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
506 brooks
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
507 no silver bullet
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
508 .]
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
509 .QP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
510 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
511 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
512 technical requirements, [...].
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
513 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
514 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
515 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
516 Writing a prototype is a great method for becoming familiar with the requirements
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
517 and to run into real problems early.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
518 .PP
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
519 Prototyping is often seen as a first step in building a software.
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
520 This is, of course, good.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
521 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
522 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
523 \fIgood enough\fP.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
524 Hence, no reimplementation, in a more sophisticated programming language,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
525 might be of need, at least for the moment.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
526 Maybe later, it might be necessary to rewrite the software, but not now.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
527 By delaying further work, one keeps the flexibility to react on
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
528 changing requirements.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
529 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
530
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
531 .NH 2
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
532 Worse is better
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
533 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
534 \*(SN Worse is better
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
535 .XE
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
536 .LP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
537 The Unix Philosophy aims for the 90% solution;
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
538 others call it the ``Worse is better'' approach.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
539 Practical experience shows, that:
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
540 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
541 (1) It is almost never possible to define the
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
542 requirements completely and correctly the first time.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
543 Hence one should not try to; one will fail anyway.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
544 .PP
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
545 (2) Requirements change during time.
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
546 Hence it is best to delay requirement-based design decisions as long as possible.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
547 The software should be small and flexible as long as possible
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
548 to react on changing requirements.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
549 Shell scripts, for example, are more easily adjusted as C programs.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
550 .PP
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
551 (3) Maintenance work is hard work.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
552 Hence, one should keep the amount of code as small as possible;
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
553 it should just fulfill the \fIcurrent\fP requirements.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
554 Software parts that will be written in future,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
555 do not need maintenance till then.
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
556 .PP
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
557 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
558 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
559 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
560 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
561 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
562 .IP \(bu
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
563 When a software is usable and valuable, it gets used, and thus tested.
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
564 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
565 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
566 The prototype might be enough for the moment,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
567 thus further work on the software can get delayed to a time
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
568 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
569 than now.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
570 .IP \(bu
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
571 Implementing now only the parts that are actually needed at the moment,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
572 introduces fewer programming and maintenance work.
10
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
573 .IP \(bu
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
574 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
575 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
576 when a different approach had been used.
355ed69a34a8 more about the shell and worse is better (ch03)
meillo@marmaro.de
parents: 9
diff changeset
577
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
578 .NH 2
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
579 Upgrowth and survival of software
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
580 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
581 \*(SN Upgrowth and survival of software
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
582 .XE
11
b32a43a62cae some rework about interface arch (ch03)
meillo@marmaro.de
parents: 10
diff changeset
583 .LP
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
584 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
585 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
586 they describe.
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
587 The better verb, however, is to \fIgrow\fP.
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
588 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
589 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
590 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
591 compiled program this way.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
592 Its lifetime begins with the initial prototype and ends when the software is not used anymore.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
593 While being alive it will get extended, rearranged, rebuilt.
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
594 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
595 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
596 gancarz
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
597 unix philosophy
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
598 %P 26
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
599 .]
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
600 .PP
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
601 Software can be seen as being controlled by evolutionary processes.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
602 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
603 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
604 Darwin talks about: ``The survival of the fittest.''
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
605 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
606 darwin
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
607 origin of species
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
608 .]
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
609 Transferred to software: The most successful software, is the fittest,
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
610 is the one that survives.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
611 (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
612 The fitness of software is affected mainly by four properties:
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
613 portability of code, portability of data, range of usability, and reusability of parts.
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
614 .\" .IP \(bu
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
615 .\" portability of code
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
616 .\" .IP \(bu
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
617 .\" portability of data
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
618 .\" .IP \(bu
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
619 .\" range of usability
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
620 .\" .IP \(bu
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
621 .\" reuseability of parts
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
622 .PP
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
623 (1)
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
624 .I "Portability of code
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
625 means, using high-level programming languages,
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
626 sticking to the standard,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
627 and avoiding optimizations that introduce dependencies on specific hardware.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
628 Hardware has a much lower lifetime than software.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
629 By chaining software to a specific hardware,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
630 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
631 In contrast, software should be easy to port \(en
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
632 adaptation is the key to success.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
633 .\" cf. practice of prog: ch08
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
634 .PP
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
635 (2)
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
636 .I "Portability of data
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
637 is best achieved by avoiding binary representations
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
638 to store data, because binary representations differ from machine to machine.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
639 Textual representation is favored.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
640 Historically, \s-1ASCII\s0 was the charset of choice.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
641 For the future, \s-1UTF\s0-8 might be the better choice.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
642 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
643 very common charset encoding.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
644 Apart from being able to transfer data between machines,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
645 readable data has the great advantage, that humans are able to directly
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
646 read and edit it with text editors and other tools from the Unix toolchest.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
647 .\" gancarz tenet 5
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
648 .PP
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
649 (3)
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
650 A large
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
651 .I "range of usability
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
652 ensures good adaptation, and thus good survival.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
653 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
654 the original authors did never imagine.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
655 Software that solves problems in a general way will likely be used
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
656 for many kinds of similar problems.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
657 Being too specific limits the range of usability.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
658 Requirements change through time, thus use cases change or even vanish.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
659 As a good example in this point,
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
660 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
661 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
662 allman
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
663 sendmail
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
664 .]
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
665 .QP
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
666 Second, I limited myself to the routing function [...].
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
667 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
668 .QP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
669 Third, the sendmail configuration file was flexible enough to adapt
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
670 to a rapidly changing world [...].
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
671 .LP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
672 Successful software adapts itself to the changing world.
12
018d5f9a2993 wrote about upgrowth and survival (ch03)
meillo@marmaro.de
parents: 11
diff changeset
673 .PP
15
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
674 (4)
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
675 .I "Reuse of parts
00e306ee903b reformated content (ch03)
meillo@marmaro.de
parents: 14
diff changeset
676 is even one step further.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
677 A software may completely lose its field of action,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
678 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
679 to survive this death.
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
680 If software is build by combining small independent programs,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
681 then these parts are readily available for reuse.
13
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
682 Who cares if the large program is a failure,
c665b9e7bf8a more about portability and reuse (ch03)
meillo@marmaro.de
parents: 12
diff changeset
683 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
684
16
f89ca78f289e numbered 2nd level headings
meillo@marmaro.de
parents: 15
diff changeset
685 .NH 2
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
686 Summary
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
687 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
688 \*(SN Summary
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
689 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
690 .LP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
691 This chapter explained central ideas of the Unix Philosophy.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
692 For each of the ideas, the advantages they introduce were explained.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
693 The Unix Philosophy are guidelines that help to write more valuable software.
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
694 From the view point of a software developer or software designer,
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
695 the Unix Philosophy provides answers to many software design problem.
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
696 .PP
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
697 The various ideas of the Unix Philosophy are very interweaved
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
698 and can hardly be applied independently.
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
699 However, the probably most important messages are:
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
700 .I "``Keep it simple!''" ,
14
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
701 .I "``Do one thing well!''" ,
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
702 and
59305c854751 rearrangements of headlines; summary (ch03)
meillo@marmaro.de
parents: 13
diff changeset
703 .I "``Use software leverage!''
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
704
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
705
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
706
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
707 .NH 1
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
708 Case study: \s-1MH\s0
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
709 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
710 .sp .5v
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
711 \*(SN Case study: \s-1MH\s0
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
712 .XE
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
713 .LP
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
714 The previous chapter introduced and explained the Unix Philosophy
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
715 from a general point of view.
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
716 The driving force were the guidelines; references to
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
717 existing software were given only sparsely.
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
718 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
719 the driving force in the discussion.
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
720 .PP
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
721 This first case study is about the mail user agents (\s-1MUA\s0)
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
722 \s-1MH\s0 (``mail handler'') and its descendent \fInmh\fP
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
723 (``new mail handler'').
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
724 \s-1MUA\s0s provide functions to read, compose, and organize mail,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
725 but (ideally) not to transfer it.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
726 In this document, the name \s-1MH\s0 will be used to include nmh.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
727 A distinction will only be made if differences between
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
728 \s-1MH\s0 and nmh are described.
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
729
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
730
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
731 .NH 2
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
732 Historical background
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
733 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
734 \*(SN Historical background
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
735 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
736 .LP
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
737 Electronic mail was available in Unix very early.
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
738 The first \s-1MUA\s0 on Unix was \f(CWmail\fP,
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
739 which was already present in the First Edition.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
740 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
741 salus
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
742 quarter century of unix
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
743 %P 41 f.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
744 .]
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
745 It was a small program that either printed the user's mailbox file
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
746 or appended text to someone elses mailbox file,
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
747 depending on the command line arguments.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
748 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
749 manual mail(1)
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
750 .]
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
751 It was a program that did one job well.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
752 This job was emailing, which was very simple then.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
753 .PP
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
754 Later, emailing became more powerful, and thus more complex.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
755 The simple \f(CWmail\fP, which knew nothing of subjects,
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
756 independent handling of single messages,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
757 and long-time email storage, was not powerful enough anymore.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
758 In 1978 at Berkeley, Kurt Shoens wrote \fIMail\fP (with capital `M')
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
759 to provide additional functions for emailing.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
760 Mail was still one program, but now it was large and did
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
761 several jobs.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
762 Its user interface is modeled after the one of \fIed\fP.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
763 It is designed for humans, but is still scriptable.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
764 \fImailx\fP is the adaptation of Berkeley Mail into System V.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
765 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
766 ritter
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
767 mailx history
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
768 .]
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
769 Elm, pine, mutt, and a whole bunch of graphical \s-1MUA\s0s
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
770 followed Mail's direction.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
771 They are large, monolithic programs which include all emailing functions.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
772 .PP
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
773 A different way was taken by the people of \s-1RAND\s0 Corporation.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
774 In the beginning, they also had used a monolithic mail system,
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
775 called \s-1MS\s0 (for ``mail system'').
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
776 But in 1977, Stockton Gaines and Norman Shapiro
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
777 came up with a proposal of a new email system concept \(en
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
778 one that honored the Unix Philosophy.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
779 The concept was implemented by Bruce Borden in 1978 and 1979.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
780 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
781 .PP
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
782 Since then, \s-1RAND\s0, the University of California at Irvine and
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
783 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
784 However, it's core concepts remained the same.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
785 In the late 90s, when development of \s-1MH\s0 slowed down,
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
786 Richard Coleman started with \fInmh\fP, the new mail handler.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
787 His goal was to improve \s-1MH\s0 especially in regard of
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
788 the requirements of modern emailing.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
789 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
790 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
791 ware
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
792 rand history
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
793 %P 128-137
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
794 .]
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
795 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
796 peek
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
797 mh
18
e2240a387a84 wrote about history of MH and nmh
meillo@marmaro.de
parents: 17
diff changeset
798 .]
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
799
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
800 .NH 2
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
801 Contrasts to monolithic mail systems
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
802 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
803 \*(SN Contrasts to monolithic mail systems
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
804 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
805 .LP
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
806 All \s-1MUA\s0s are monolithic, except \s-1MH\s0.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
807 Although there might actually exist further, very little known,
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
808 toolchest \s-1MUA\s0s, this statement reflects the situation pretty well.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
809 .PP
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
810 Monolithic \s-1MUA\s0s gather all their functions in one program.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
811 In contrast, \s-1MH\s0 is a toolchest of many small tools \(en one for each job.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
812 Following is a list of important programs of \s-1MH\s0's toolchest
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
813 and their function.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
814 It gives a feeling of how the toolchest looks like.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
815 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
816 .CW inc :
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
817 incorporate new mail (this is how mail enters the system)
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
818 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
819 .CW scan :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
820 list messages in folder
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
821 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
822 .CW show :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
823 show message
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
824 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
825 .CW next\fR/\fPprev :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
826 show next/previous message
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
827 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
828 .CW folder :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
829 change current folder
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
830 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
831 .CW refile :
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
832 refile message into different folder
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
833 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
834 .CW rmm :
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
835 remove message
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
836 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
837 .CW comp :
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
838 compose new message
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
839 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
840 .CW repl :
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
841 reply to message
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
842 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
843 .CW forw :
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
844 forward message
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
845 .IP \(bu
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
846 .CW send :
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
847 send prepared message (this is how mail leaves the system)
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
848 .LP
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
849 \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
850 The user does not leave the shell to run \s-1MH\s0,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
851 instead he uses the various \s-1MH\s0 programs within the shell.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
852 Using a monolithic program with a captive user interface
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
853 means ``entering'' the program, using it, and ``exiting'' the program.
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
854 Using toolchests like \s-1MH\s0 means running programs,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
855 alone or in combination with others, also from other toolchests,
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
856 without leaving the shell.
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
857
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
858 .NH 2
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
859 Data storage
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
860 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
861 \*(SN Data storage
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
862 .XE
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
863 .LP
34
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
864 \s-1MH\s0's mail storage is a directory tree under the user's
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
865 \s-1MH\s0 directory (usually \f(CW$HOME/Mail\fP),
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
866 where mail folders are directories and mail messages are text files
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
867 within them.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
868 Each mail folder contains a file \f(CW.mh_sequences\fP which lists
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
869 the public message sequences of that folder,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
870 for instance the \fIunseen\fP sequence for new messages.
34
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
871 Mail messages are text files located in a mail folder.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
872 The files contain the messages as they were received.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
873 They are named by ascending numbers in each folder.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
874 .PP
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
875 This mailbox format is called ``\s-1MH\s0'' after the \s-1MUA\s0.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
876 Alternatives are \fImbox\fP and \fImaildir\fP.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
877 In the mbox format all messages are stored within one file.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
878 This was a good solution in the early days, when messages
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
879 were only a few lines of text and were deleted soon.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
880 Today, when single messages often include several megabytes
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
881 of attachments, it is a bad solution.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
882 Another disadvantage of the mbox format is that it is
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
883 more difficult to write tools that work on mail messages,
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
884 because it is always necessary to first find and extract
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
885 the relevant message in the mbox file.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
886 With the \s-1MH\s0 mailbox format, each message is a separate file.
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
887 Also, the problem of concurrent access to one mailbox is
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
888 reduced to the problem of concurrent access to one message.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
889 The maildir format is generally similar to the \s-1MH\s0 format,
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
890 but modified towards guaranteed reliability.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
891 This involves some complexity, unfortunately.
34
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
892 .PP
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
893 Working with \s-1MH\s0's toolchest on mailboxes is much like
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
894 working with Unix' toolchest on directory trees:
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
895 \f(CWscan\fP is like \f(CWls\fP,
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
896 \f(CWshow\fP is like \f(CWcat\fP,
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
897 \f(CWfolder\fP is like \f(CWcd\fP and \f(CWpwd\fP,
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
898 \f(CWrefile\fP is like \f(CWmv\fP,
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
899 and \f(CWrmm\fP is like \f(CWrm\fP.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
900 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
901 \s-1MH\s0 extends the context of processes in Unix by two more items,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
902 for its tools:
34
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
903 .IP \(bu
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
904 The current mail folder, which is similar to the current working directory.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
905 For mail folders, \f(CWfolder\fP provides the corresponding functionality
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
906 of \f(CWcd\fP and \f(CWpwd\fP for directories.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
907 .IP \(bu
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
908 Sequences, which are named sets of messages in a mail folder.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
909 The current message, relative to a mail folder, is a special sequence.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
910 It enables commands like \f(CWnext\fP and \f(CWprev\fP.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
911 .LP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
912 In contrast to Unix' context, which is maintained by the kernel,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
913 \s-1MH\s0's context must be maintained by the tools themselves.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
914 Usually there is one context per user, which resides in his
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
915 \f(CWcontext\fP file in the \s-1MH\s0 directory,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
916 but a user can have several contexts, too.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
917 Public sequences are an exception, as they belong to a mail folder,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
918 and reside in the \f(CW.mh_sequences\fP file there.
34
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
919 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
920 man page mh-profile mh-sequence
34
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
921 .]
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
922
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
923 .NH 2
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
924 Discussion of the design
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
925 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
926 \*(SN Discussion of the design
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
927 .XE
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
928 .LP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
929 This section discusses \s-1MH\s0 in regard to the tenets
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
930 of the Unix Philosophy that Gancarz identified.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
931
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
932 .PP
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
933 .B "Small is beautiful
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
934 and
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
935 .B "do one thing well
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
936 are two design goals that are directly visible in \s-1MH\s0.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
937 Gancarz actually presents \s-1MH\s0 in his book as example under the
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
938 headline ``Making \s-1UNIX\s0 Do One Thing Well'':
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
939 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
940 gancarz
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
941 unix philosophy
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
942 %P 125
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
943 .]
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
944 .QP
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
945 [\s-1MH\s0] consists of a series of programs which
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
946 when combined give the user an enormous ability
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
947 to manipulate electronic mail messages.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
948 A complex application, it shows that not only is it
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
949 possible to build large applications from smaller
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
950 components, but also that such designs are actually preferable.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
951 .LP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
952 The various programs of \s-1MH\s0 were relatively easy to write,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
953 because each of them is small, limited to one function,
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
954 and has clear boundaries.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
955 For the same reasons, they are also good to maintain.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
956 Further more, the system can easily get extended.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
957 One only needs to put a new program into the toolchest.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
958 This was done, for instance, when \s-1MIME\s0 support was added
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
959 (e.g. \f(CWmhbuild\fP).
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
960 Also, different programs can exist to do the basically same job
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
961 in different ways (e.g. in nmh: \f(CWshow\fP and \f(CWmhshow\fP).
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
962 .PP
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
963 If someone needs a mail system with some additionally
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
964 functions that are not available anywhere yet, he best expands a
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
965 toolchest system like \s-1MH\s0.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
966 There he can add new functionality by simply adding additional
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
967 programs to the toolchest.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
968 There he does not risk to break existing functionality by doing so.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
969
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
970 .PP
34
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
971 .B "Store data in flat text files
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
972 is followed by \s-1MH\s0.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
973 This is not surprising, because email messages are already plain text.
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
974 \s-1MH\s0 stores the messages as it receives them,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
975 thus any other tool that works on \s-1RFC\s0\|2822 mail messages can operate
34
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
976 on the messages in an \s-1MH\s0 mailbox.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
977 All other files \s-1MH\s0 uses are plain text, too.
34
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
978 It is therefore possible and encouraged to use the text processing
0b2cf026d93d rework of MH's data storage section
meillo@marmaro.de
parents: 33
diff changeset
979 tools of Unix' toolchest to extend \s-1MH\s0's toolchest.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
980
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
981 .PP
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
982 .B "Avoid captive user interfaces" .
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
983 \s-1MH\s0 is perfectly suited for non-interactive use.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
984 It offers all functions directly and without captive user interfaces.
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
985 If, nonetheless, users want a graphical user interface,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
986 they can have it with \fIxmh\fP or \fIexmh\fP.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
987 These are graphical frontends for the \s-1MH\s0 toolchest.
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
988 This means, all email-related work is still done by \s-1MH\s0 tools,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
989 but the frontend calls the appropriate commands when the user
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
990 clicks on buttons.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
991 .PP
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
992 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
993 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
994 The frontend will anyway only be able to make a subset of the
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
995 backend's power and flexibility available to the user.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
996 But if it is a separate program,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
997 then the missing parts can still be accessed at the backend directly.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
998 If it is integrated, then this will hardly be possible.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
999 An additional advantage is the possibility to have different frontends
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1000 to the same backend.
19
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
1001
d8f428cee0d1 about mh (ch04)
meillo@marmaro.de
parents: 18
diff changeset
1002 .PP
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
1003 .B "Choose portability over efficiency
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1004 and
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
1005 .B "use shell scripts to increase leverage and portability" .
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1006 These two tenets are indirectly, but nicely, demonstrated by
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1007 Bolsky and Korn in their book about the Korn Shell.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1008 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
1009 bolsky korn
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
1010 korn shell
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1011 .]
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1012 Chapter\|18 of the book shows a basic implementation
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1013 of a subset of \s-1MH\s0 in ksh scripts.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1014 Of course, this is just a demonstration, but a brilliant one.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1015 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
1016 and how readable they are.
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1017 The implementation in the scripting language may not be very fast,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1018 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
1019 By having the code in an interpreted language, like the shell,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1020 portability becomes a minor issue, if we assume the interpreter
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1021 to be widespread.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1022 .PP
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1023 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
1024 of a toolchest software.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1025 Eight tools (two of them have multiple names) and 16 functions
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1026 with supporting code are presented to the reader.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1027 The tools comprise less than 40 lines of ksh each,
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1028 in total about 200 lines.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1029 The functions comprise less than 80 lines of ksh each,
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1030 in total about 450 lines.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1031 Such small software is easy to write, easy to understand,
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1032 and thus easy to maintain.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1033 A toolchest improves the possibility to only write some parts
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1034 and though create a working result.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1035 Expanding the toolchest, even without global changes,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1036 will likely be possible.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1037
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1038 .PP
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
1039 .B "Use software leverage to your advantage
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1040 and the lesser tenet
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
1041 .B "allow the user to tailor the environment
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1042 are ideally followed in the design of \s-1MH\s0.
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1043 Tailoring the environment is heavily encouraged by the ability to
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1044 directly define default options to programs.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1045 It is even possible to define different default options
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1046 depending on the name under which a program is called.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1047 Software leverage is heavily encouraged by the ease of
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1048 creating shell scripts that run a specific command line,
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1049 built of several \s-1MH\s0 programs.
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1050 There is few software that so much wants users to tailor their
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1051 environment and to leverage the use of the software, like \s-1MH\s0.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1052 .PP
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1053 Just to make one example:
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1054 One might prefer a different listing format for the \f(CWscan\fP
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1055 program.
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1056 It is possible to take one of the distributed format files
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1057 or to write one yourself.
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1058 To use the format as default for \f(CWscan\fP, a single line,
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1059 reading
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1060 .DS
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1061 .CW
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1062 scan: -form FORMATFILE
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1063 .DE
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1064 must be added to \f(CW.mh_profile\fP.
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1065 If one wants this different format as an additional command,
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1066 instead of changing the default, he needs to create a link to
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1067 \f(CWscan\fP, for instance titled \f(CWscan2\fP.
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1068 The line in \f(CW.mh_profile\fP would then start with \f(CWscan2\fP,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1069 as the option should only be in effect for a program that is called as
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1070 \f(CWscan2\fP.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1071
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1072 .PP
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
1073 .B "Make every program a filter
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1074 is hard to find in \s-1MH\s0.
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1075 The reason therefore is that most of \s-1MH\s0's tools provide
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1076 basic file system operations for mailboxes.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1077 It is the same reason because of which \f(CWls\fP, \f(CWcp\fP, \f(CWmv\fP,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1078 and \f(CWrm\fP aren't filters neither.
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1079 \s-1MH\s0 does not provide many filters itself, but it is a basis
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1080 to write filters for.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1081 An example would be a mail text highlighter,
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1082 that means a program that makes use of a color terminal to display
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1083 header lines, quotations, and signatures in distinct colors.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1084 The author's version of such a program is an awk script with 25 lines.
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1085
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1086 .PP
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
1087 .B "Build a prototype as soon as possible
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1088 was again well followed by \s-1MH\s0.
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1089 This tenet, of course, focuses on early development, which is
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1090 long time ago for \s-1MH\s0.
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1091 But without following this guideline at the very beginning,
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1092 Bruce Borden may have not convinced the management of \s-1RAND\s0
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1093 to ever create \s-1MH\s0.
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1094 In Bruce' own words:
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
1095 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
1096 ware rand history
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
1097 %P 132
41
13ef7042fa28 some rework in ch01; nicer formating
meillo@marmaro.de
parents: 40
diff changeset
1098 .]
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1099 .QP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1100 [...] but [Stockton Gaines and Norm Shapiro] were not able
23
f0511a56416e rework in ch04 and spell check
meillo@marmaro.de
parents: 22
diff changeset
1101 to convince anyone that such a system would be fast enough to be usable.
21
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1102 I proposed a very short project to prove the basic concepts,
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1103 and my management agreed.
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1104 Looking back, I realize that I had been very lucky with my first design.
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1105 Without nearly enough design work,
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1106 I built a working environment and some header files
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1107 with key structures and wrote the first few \s-1MH\s0 commands:
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1108 inc, show/next/prev, and comp.
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1109 [...]
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1110 With these three, I was able to convince people that the structure was viable.
ca929b042039 more on MH (ch04)
meillo@marmaro.de
parents: 20
diff changeset
1111 This took about three weeks.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1112
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1113 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1114 Problems
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1115 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1116 \*(SN Problems
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1117 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1118 .LP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1119 \s-1MH\s0 is not without problems.
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1120 There are two main problems: one is technical, the other is about human behavior.
22
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1121 .PP
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1122 \s-1MH\s0 is old and email today is very different to email in the time
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1123 when \s-1MH\s0 was designed.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1124 \s-1MH\s0 adapted to the changes pretty well, but it is limited, though.
22
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1125 \s-1MIME\s0 support and support for different character encodings
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1126 is available, but only on a moderate level.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1127 This comes from limited development resources.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1128 More active developers could quickly change this.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1129 But \s-1MH\s0 is also limited by design, which is the larger problem.
22
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1130 \s-1IMAP\s0, for example, conflicts with \s-1MH\s0's design to a large extend.
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1131 These design conflicts are not easily solvable.
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1132 Possibly, they require a redesign.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1133 \s-1IMAP\s0 may be too different to the classic mail model,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1134 which \s-1MH\s0 covers, so that \s-1MH\s0 may never support it well.
22
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1135 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1136 The other kind of problem are human habits.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1137 In this world, where almost all \s-1MUA\s0s are monolithic,
22
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1138 it is very difficult to convince people to use a toolbox style \s-1MUA\s0
4c21f5b8d716 wrote about problems of MH (ch04)
meillo@marmaro.de
parents: 21
diff changeset
1139 like \s-1MH\s0.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1140 The habits are so strong, that even people who understand the concept
30
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1141 and advantages of \s-1MH\s0 do not like to switch,
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1142 simply because \s-1MH\s0 is different.
ec17b3a969c7 various minor rework in ch04
meillo@marmaro.de
parents: 23
diff changeset
1143 Unfortunately, the frontends to \s-1MH\s0, which could provide familiar look'n'feel,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1144 are quite outdated and thus not very appealing, compared to the modern interfaces
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1145 of many monolithic \s-1MUA\s0s.
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1146
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1147 .NH 2
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1148 Summary \s-1MH\s0
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1149 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1150 \*(SN Summary \s-1MH\s0
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1151 .XE
20
578d5c84e5c0 a lot about mh (ch04)
meillo@marmaro.de
parents: 19
diff changeset
1152 .LP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1153 \s-1MH\s0 is an \s-1MUA\s0 that follows the Unix Philosophy in its design.
31
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1154 It consists of a toolchest of small tools, each of them does one job well.
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1155 The toolchest approach offers great flexibility to the user.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1156 It is possible to utilize the complete power of the Unix shell with \s-1MH\s0.
31
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1157 This makes \s-1MH\s0 a very powerful mail system.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1158 Extending and customizing \s-1MH\s0 is easy and encouraged.
31
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1159 .PP
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1160 Apart from the user's perspective, \s-1MH\s0 is development-friendly.
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1161 Its overall design follows clear rules.
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1162 The single tools do only one job, thus they are easy to understand,
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1163 easy to write, and good to maintain.
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1164 They are all independent and do not interfere with the others.
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1165 Automated testing of their function is a straight forward task.
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1166 .PP
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1167 It is sad, that \s-1MH\s0's differentness is its largest problem,
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1168 as its differentness is also its largest advantage.
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1169 Unfortunately, for most people their habits are stronger
0caa9760fca8 wrote summary of ch04
meillo@marmaro.de
parents: 30
diff changeset
1170 than the attraction of the clear design and the power, \s-1MH\s0 offers.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1171
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
1172
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
1173
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1174 .NH 1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1175 Case study: uzbl
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1176 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1177 .sp .5v
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1178 \*(SN Case study: uzbl
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1179 .XE
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1180 .LP
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1181 The last chapter took a look on the \s-1MUA\s0 \s-1MH\s0,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1182 which is an old and established software.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1183 This chapter covers uzbl, a fresh new project.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1184 Uzbl is a web browser that adheres to the Unix Philosophy.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1185 Its name comes from the \fILolspeak\fP word for ``usable'';
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1186 it is pronounced identical.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1187
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1188 .NH 2
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1189 Historical background
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1190 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1191 \*(SN Historical background
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1192 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1193 .LP
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1194 Uzbl was started by Dieter Plaetinck in April 2009.
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
1195 The idea was born in a thread in the Arch Linux Forums.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1196 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
1197 arch linux forums
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
1198 browser
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1199 .]
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1200 After some discussion about failures of well known web browsers,
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1201 Plaetinck (alias Dieter@be) came up with a very sketchy proposal
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1202 of how a better web browser could look like.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1203 To the question of another member, if Plaetinck would write that program,
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1204 because it would sound fantastic, Plaetinck replied:
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1205 ``Maybe, if I find the time ;-)''.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1206 .PP
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1207 Fortunately, he found the time.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1208 One day later, the first prototype was out.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1209 One week later, uzbl had an own website.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1210 One month after the first code showed up,
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1211 a mailing list was installed to coordinate and discuss further development.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1212 Then a wiki followed to store documentation and scripts that showed up on the
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1213 mailing list and elsewhere.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1214 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1215 In the, now, one year of uzbl's existence, it was heavily developed on various branches.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1216 Plaetinck's task became more and more to only merge the best code from the
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1217 different branches into his main branch, and to apply patches.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1218 About once a month, Plaetinck released a new version.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1219 In September 2009, he presented several forks of uzbl.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1220 Uzbl, actually, opened the field for a whole family of web browsers with similar shape.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1221 .PP
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1222 In July 2009, \fILinux Weekly News\fP published an interview with Plaetinck about uzbl.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1223 In September 2009, the uzbl web browser was on \fISlashdot\fP.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1224
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1225 .NH 2
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1226 Contrasts to other web browsers
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1227 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1228 \*(SN Contrasts to other web browsers
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1229 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1230 .LP
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1231 Like most \s-1MUA\s0s are monolithic, but \s-1MH\s0 is a toolchest,
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1232 most web browsers are monolithic, but uzbl is a frontend to a toolchest.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1233 .PP
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1234 Today, uzbl is divided into uzbl-core and uzbl-browser.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1235 Uzbl-core is, how its name already indicates, the core of uzbl.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1236 It handles commands and events to interface other programs,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1237 and also displays webpages by using \fIwebkit\fP as render engine.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1238 Uzbl-browser combines uzbl-core with a bunch of handler scripts, a status bar,
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1239 an event manager, yanking, pasting, page searching, zooming, and more stuff,
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1240 to form a ``complete'' web browser.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1241 In the following text, the term ``uzbl'' usually stands for uzbl-browser,
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1242 so uzbl-core is included.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1243 .PP
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1244 Unlike most other web browsers, uzbl is mainly the mediator between the
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1245 various tools that cover single jobs.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1246 Therefore, uzbl listens for commands on a named pipe (fifo), a Unix socket,
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1247 and on stdin, and it writes events to a Unix socket and to stdout.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1248 Loading a webpage in a running uzbl instance requires only:
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1249 .DS
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1250 .CW
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1251 echo 'uri http://example.org' >/path/to/uzbl-fifo
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1252 .DE
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1253 The graphical rendering of the webpage is done by webkit,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1254 a web content engine.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1255 Uzbl-core is built around libwebkit.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1256 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1257 Downloads, browsing history, bookmarks, and the like are not provided
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1258 by the core itself, like they are in other web browsers.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1259 Uzbl-browser also only provides, so called, handler scripts that wrap
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1260 external applications which provide the actual functionality.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1261 For instance, \fIwget\fP is used to download files and uzbl-browser
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1262 includes a script that calls wget with appropriate options in
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1263 a prepared environment.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1264 .PP
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1265 Modern web browsers are proud to have addons, plugins, and modules, instead.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1266 This is their effort to achieve similar goals.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1267 But instead of using existing, external programs, modern web browsers
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1268 include these functions.
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1269
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1270 .NH 2
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1271 Discussion of the design
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1272 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1273 \*(SN Discussion of the design
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1274 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1275 .LP
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1276 This section discusses uzbl in regard of the Unix Philosophy,
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1277 as identified by Gancarz.
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1278
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1279 .PP
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1280 .B "Make each program do one thing well" .
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1281 Uzbl tries to be a web browser and nothing else.
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1282 The common definition of a web browser is, of course, highly influenced by
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1283 existing implementations of web browsers, although they are degenerated.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1284 Web browsers should be programs to browse the web, and nothing more.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1285 This is the one thing they should do.
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1286 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1287 Web browsers should not, for instance, manage downloads.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1288 This is the job download managers exist for.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1289 Download managers do primary care about being good in downloading files.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1290 Modern web browsers provide download management only as a secondary feature.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1291 How could they do this job better, than programs that exist only for
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1292 this very job?
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1293 And how could anyone want less than the best download manager available?
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1294 .PP
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1295 A web browser's job is to let the user browse the web.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1296 This means, navigating through websites by following links.
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1297 Rendering the \s-1HTML\s0 sources is a different job, too.
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1298 It is covered by the webkit render engine, in uzbl's case.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1299 Audio and video content and files like PostScript, \s-1PDF\s0, and the like,
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1300 are also not the job of a web browser.
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1301 They should be handled by external applications \(en
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1302 ones which's job is to handle such data.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1303 Uzbl strives to do it this way.
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1304 .PP
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1305 Remember Doug McIlroy:
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1306 .I
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1307 ``Write programs that do one thing and do it well.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1308 Write programs to work together.''
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1309 .R
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1310 .PP
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1311 The lesser tenet
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1312 .B "allow the user to tailor the environment
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1313 matches good here.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1314 There was the question, how anyone could want anything less than the
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1315 best program for the job.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1316 But as personal preferences matter, it is probably more important to ask:
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1317 How could anyone want something else than his preferred program for the job?
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1318 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1319 Usually users want one program for a specific job.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1320 Hence, whenever the task is, for instance, downloading,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1321 the same download manager should be used.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1322 More advanced users might want to have this download manager in this
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1323 situation and that one in that situation.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1324 They should be able to configure it this way.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1325 With uzbl, one can use any download manager the user wants.
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1326 To switch to a different one, only one line in a small handler script
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1327 needs to be changed.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1328 Alternatively it would be possible to query the program to use by
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1329 reading a global file or an environment variable, in the handler script.
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1330 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1331 Uzbl does neither have its own download manager nor depends on a
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1332 specific one, hence uzbl's browsing abilities will not be lowered by having
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1333 a bad download manager.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1334 Uzbl's download capabilities will be just as good as the ones of the best
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1335 download manager available on the system.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1336 Of course, this applies to all of the other supplementary tools, too.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1337
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1338 .PP
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1339 .B "Use software leverage to your advantage" .
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1340 Uzbl is designed to be extended by external tools.
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1341 These external tools are usually wrapped by small handler shell scripts.
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1342 Shell scripts are the glue in this approach.
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1343 They make the various parts fit together.
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1344 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1345 The history mechanism of uzbl shall be presented as an example.
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1346 Uzbl is configured to spawn a script to append an entry to the history
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1347 whenever the event of a fully loaded page occurs.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1348 The script to append the entry to the history is not much more than:
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1349 .DS
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1350 .CW
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1351 #!/bin/sh
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1352 file=/path/to/uzbl-history
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1353 echo `date +'%Y-%m-%d %H:%M:%S'`" $6 $7" >> $file
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1354 .DE
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1355 \f(CW$6\fP and \f(CW$7\fP expand to the \s-1URL\s0 and the page title.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1356 .PP
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1357 For loading an entry, a key is bound to spawn a load-from-history script.
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1358 The script reverses the history to have newer entries first,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1359 then displays \fIdmenu\fP to let the user select an item,
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1360 and afterwards writes the selected \s-1URL\s0 into uzbl's command input pipe.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1361 With error checking and corner case handling removed,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1362 the script looks like this:
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1363 .DS
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1364 .CW
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1365 #!/bin/sh
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1366 file=/path/to/uzbl-history
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1367 goto=`tac $file | dmenu | cut -d' ' -f 3`
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1368 echo "uri $goto" > $4
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1369 .DE
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1370 \f(CW$4\fP expands to the path of the command input pipe of the current
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1371 uzbl instance.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1372
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1373 .PP
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
1374 .B "Avoid captive user interfaces" .
36
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1375 One could say, that uzbl, to a large extend, actually \fIis\fP
4f2b2defbc8c some rework and more about uzbl design (ch05)
meillo@marmaro.de
parents: 35
diff changeset
1376 a captive user interface.
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1377 But the difference to most other web browsers is, that uzbl is only
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1378 the captive user interface frontend (and the core of the backend).
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1379 Many parts of the backend are independent of uzbl.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1380 Some are distributed with uzbl, for some external programs,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1381 handler scripts are distributed,
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1382 but arbitrary additional functionality can be added if desired.
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1383 .PP
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1384 The frontend is captive \(en that is true.
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1385 This is okay for the task of browsing the web, as this task is only relevant
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1386 for humans.
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1387 Automated programs would \fIcrawl\fP the web.
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1388 That means, they read the source directly.
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1389 The source includes all the semantics.
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1390 The graphical representation is just for humans to transfer the semantics
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1391 more intuitively.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1392
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1393 .PP
33
0bd43c4ad9f8 removed quotes and used bold instead of italic
meillo@marmaro.de
parents: 32
diff changeset
1394 .B "Make every program a filter" .
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1395 Graphical web browsers are almost dead ends in the chain of information flow.
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1396 Thus it is difficult to see what graphical web browsers should filter.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1397 Graphical web browsers exist almost only to be interactively used by humans.
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1398 The only case when one might want to automate the rendering function is
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1399 to generate images of rendered webpages.
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1400
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1401 .PP
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1402 .B "Small is beautiful"
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1403 is not easy to apply to a web browser, because modern web technology
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1404 is very complex, hence the rendering task is very complex.
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1405 Modern web browsers have to consist of many thousand lines of code,
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1406 unfortunately.
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1407 Using the toolchest approach and wrappers can split the browser into
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1408 several small parts, tough.
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1409 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1410 As of March 2010, uzbl-core consists of about 3\,500 lines of C code.
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1411 The distribution includes another 3\,500 lines of Shell and Python code,
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1412 which are the handler scripts and plugins like a modal interface.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1413 Further more, uzbl uses functionality of external tools like
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1414 \fIwget\fP and \fInetcat\fP.
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1415 Up to this point, uzbl looks pretty neat and small.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1416 The ugly part of uzbl is the web content renderer, webkit.
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1417 Webkit consists of roughly 400\,000 (!) lines of code.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1418 Unfortunately, small web render engines are not possible anymore
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1419 because of the modern web.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1420
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1421 .PP
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1422 .B "Build a prototype as soon as possible" .
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1423 Plaetinck made his code public, right from the beginning.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1424 Discussion and development was, and still is, open to everyone interested.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1425 Development versions of uzbl can be obtained very simply from the code
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1426 repository.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1427 Within the first year of uzbl's existence, a new version was released
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1428 more often than once a month.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1429 Different forks and branches arose.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1430 They introduced new features, which were tested for suitability
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1431 for the main branch.
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1432 The experiences of using prototypes influenced further development.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1433 Actually, all development was community driven.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1434 Plaetinck says, three months after uzbl's birth:
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1435 ``Right now I hardly code anything myself for Uzbl.
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1436 I just merge in other people's code, ponder a lot, and lead the discussions.''
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1437 .[
44
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
1438 lwn
46e34e433231 moved bibliography to external file
meillo@marmaro.de
parents: 42
diff changeset
1439 uzbl
35
f11406a85319 some minor rework; new content in ch05
meillo@marmaro.de
parents: 34
diff changeset
1440 .]
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1441
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1442
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1443 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1444 Problems
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1445 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1446 \*(SN Problems
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1447 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1448 .LP
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1449 Similar to \s-1MH\s0, uzbl, too suffers from being different.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1450 It is sad, but people use what they know.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1451 Fortunately, uzbl's user interface can look and feel very much the
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1452 same as the one of the well known web browsers,
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1453 hiding the internal differences.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1454 But uzbl has to provide this similar look and feel to be accepted
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1455 as a ``normal'' browser by ``normal'' users.
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1456 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1457 Though, the more important problem is the modern web.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1458 The modern web is simply broken.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1459 It has state in a state-less protocol,
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1460 it misuses technologies,
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1461 and it is helplessly overloaded.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1462 The result are web content render engines that must consist
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1463 of hundreds of thousands lines of code.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1464 They also must combine and integrate many different technologies,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1465 only to make our modern web accessible.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1466 Website to image converter are hardly possible to run without
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1467 human interaction because of state in sessions, impossible
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1468 deep-linking, and unautomatable technologies.
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1469 .PP
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1470 The web was misused to provide all kinds of imaginable wishes.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1471 Now web browsers, and eventually the users, suffer from it.
37
9282c4cea18c more about uzbl design
meillo@marmaro.de
parents: 36
diff changeset
1472
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
1473
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1474 .NH 2
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1475 Summary uzbl
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1476 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1477 \*(SN Summary uzbl
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1478 .XE
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1479 .LP
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1480 ``Uzbl is a browser that adheres to the Unix Philosophy'',
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1481 that is how uzbl is seen by its authors.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1482 Indeed, uzbl follows the Unix Philosophy in many ways.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1483 It consists of independent parts that work together,
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1484 while its core is mainly a mediator which glues the parts together.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1485 .PP
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1486 Software leverage can excellently be seen in uzbl.
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1487 External tools are used, independent tasks are separated
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1488 in independent parts and glued together with small handler scripts.
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1489 .PP
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1490 As uzbl, more or less, consists of a set of tools and a bit
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1491 of glue, anyone can put the parts together and expand it
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1492 in any desired way.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1493 Uzbl is very flexible and customizable.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1494 These properties make it valuable for advanced users,
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1495 but may keep novice users from using it.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1496 .PP
45
ade392f024aa a lot of rework throughout the whole document
meillo@marmaro.de
parents: 44
diff changeset
1497 But uzbl's main problem is the modern web, that makes it hard
38
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1498 to design a sane web browser.
3628e9649046 wrote uzbl summary and did several spell fixes
meillo@marmaro.de
parents: 37
diff changeset
1499 Despite this bad situation, uzbl does a fairly good job.
32
d632de027d77 wrote about uzbl (ch05)
meillo@marmaro.de
parents: 31
diff changeset
1500
8
924b2ac2d477 new text about toolchest and shell (ch03)
meillo@marmaro.de
parents: 7
diff changeset
1501
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1502 .NH 1
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1503 Final thoughts
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1504 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1505 .sp .5v
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1506 \*(SN Final thoughts
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1507 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1508
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1509 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1510 Quick summary
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1511 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1512 \*(SN Quick summary
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1513 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1514 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1515 good design
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1516 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1517 unix phil
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1518 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1519 case studies
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1520
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1521 .NH 2
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1522 Why people should choose
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1523 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1524 \*(SN Why people should choose
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1525 .XE
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1526 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1527 Make the right choice!
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1528
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1529 .nr PI .3i
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1530 .rm ]<
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1531 .de ]<
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1532 .LP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1533 .de FP
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1534 .IP \\\\$1.
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1535 \\..
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1536 .rm FS FE
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1537 ..
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1538 .ds CH "
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1539 .bp
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1540 .rs
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1541 .sp .3i
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1542 .TL
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1543 References
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1544 .LP
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1545 .XS
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1546 .sp .5v
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1547 References
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1548 .XE
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1549 .sp 2v
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1550 .nr PS -1
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1551 .nr VS -1
0
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1552 .[
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1553 $LIST$
cecef8bfa812 early version, mainly the outline
meillo@marmaro.de
parents:
diff changeset
1554 .]
42
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1555 .\".wh -1p
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1556 .bp
303e8f449e77 added TOC and improved visual appearance
meillo@marmaro.de
parents: 41
diff changeset
1557 .PX