Mercurial > docs > master

comparison preface.roff @ 223:1fa5a74bf138

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Reworked References structure: Collect them all in one Chapter. Have list of websites separately.
author markus schnalke <meillo@marmaro.de>
date Sun, 15 Jul 2012 19:16:35 +0200
parents de8172bcdc5e
children 96778c1afc3e
comparison
equal deleted inserted replaced
222:2427d1dadb57 223:1fa5a74bf138
1 .H0 "Preface" no 1 .H0 "Preface" no
2 2
3 .P 3 .P
4 I have discovered the mail client \fInmh\fP 4 I have discovered the mail client \fInmh\fP
5 .[
6 nmh website homepage
7 .]
8 in fall 2009. 5 in fall 2009.
9 At that time I used \fImutt\fP, 6 At that time I used \fImutt\fP,
10 .[
11 mutt website
12 .]
13 as many advanced Unix users do. 7 as many advanced Unix users do.
14 When I read about nmh, its concepts convinced me at once. 8 When I read about nmh, its concepts convinced me at once.
15 The transition from mutt to nmh was similar to beginning with 9 The transition from mutt to nmh was similar to beginning with
16 file management in the Unix shell when being used to the 10 file management in the Unix shell when being used to the
17 \fImidnight commander\fP, 11 \fImidnight commander\fP,
18 .[
19 midnight commander website
20 .]
21 or like starting with vi when being used to modeless editors. 12 or like starting with vi when being used to modeless editors.
22 Such a change is not trivial, but, in being convinced by the 13 Such a change is not trivial, but, in being convinced by the
23 concepts and by having done similar transitions for file management 14 concepts and by having done similar transitions for file management
24 and editing already, it was not too difficult. 15 and editing already, it was not too difficult.
25 In contrast, setting up nmh to a convenient state became a tedious task 16 In contrast, setting up nmh to a convenient state became a tedious task
110 101
111 .U2 "Focus of this Document 102 .U2 "Focus of this Document
112 .P 103 .P
113 This document explains the design goals and implementation decisions 104 This document explains the design goals and implementation decisions
114 for mmh, 105 for mmh,
115 .[
116 mmh website homepage
117 .]
118 an experimental version of nmh. 106 an experimental version of nmh.
119 It discusses technical, historical, social and philosophical considerations. 107 It discusses technical, historical, social and philosophical considerations.
120 On the technical side, this document 108 On the technical side, this document
121 explains how an existing project was streamlined by removing rough edges 109 explains how an existing project was streamlined by removing rough edges
122 and better exploitation of the central concepts. 110 and better exploitation of the central concepts.
255 kernighan pike unix programming env 243 kernighan pike unix programming env
256 .]]''. 244 .]]''.
257 Citations of email messages and websites are distinguished by 245 Citations of email messages and websites are distinguished by
258 ``mail:'' and ``web:'' prefixes. 246 ``mail:'' and ``web:'' prefixes.
259 All references are collected at the end of the document. 247 All references are collected at the end of the document.
248 The websites of the software projects mentioned are collected
249 in a list in the appendix.
260 .P 250 .P
261 This document describes practical programming work. 251 This document describes practical programming work.
262 The code of mmh is managed with the 252 The code of mmh is managed with the
263 .Pn git 253 .Pn git
264 version control system. 254 version control system.
265 .[
266 git website
267 .]
268 All code changes were checked in. 255 All code changes were checked in.
269 In the discussions, references to corresponding code changes are printed 256 In the discussions, references to corresponding code changes are printed
270 as ``\c 257 as ``\c
271 .Ci 1a2b3c4 ''. 258 .Ci 1a2b3c4 ''.
272 The identifier is the seven-letter-prefix of the changeset hash value, 259 The identifier is the seven-letter-prefix of the changeset hash value,
279 At the time of writing, changesets can be looked up online at: 266 At the time of writing, changesets can be looked up online at:
280 .CW "http://git.marmaro.de/?p=mmh;a=commitdiff;h=XXX" . 267 .CW "http://git.marmaro.de/?p=mmh;a=commitdiff;h=XXX" .
281 But as we all know, URIs are always at risk to change. 268 But as we all know, URIs are always at risk to change.
282 .P 269 .P
283 Whenever lines of code were determined, David A. Wheeler's \fIsloccount\fP 270 Whenever lines of code were determined, David A. Wheeler's \fIsloccount\fP
284 .[
285 sloccount website
286 .]
287 was used to measure the amount in a comparable way. 271 was used to measure the amount in a comparable way.
288 272
289 273
290 .U2 "Acknowledgments 274 .U2 "Acknowledgments
291 .P 275 .P
292 To be written at the very end. 276 .\"so thanks
293 .P
294 XXX FIXME