Mercurial > docs > master

annotate colophon.roff @ 235:e58400695ae2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added tag final version for changeset 348b92755bef
author markus schnalke <meillo@marmaro.de>
date Mon, 16 Jul 2012 11:25:04 +0200
parents 96778c1afc3e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
185
6f8adf7d190c style: Extended the system to handle appendices and fixed the page hdrs.
markus schnalke <meillo@marmaro.de>
parents: 181
diff changeset
1 .H- Colophon
213
de8172bcdc5e Improvements and rework of various kind.
markus schnalke <meillo@marmaro.de>
parents: 200
diff changeset
2
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
3 .P
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
4 This document was typeset with the
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
5 .I troff
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
6 document preparation system on Unix.
200
c299ed65d015 Spell checked.
markus schnalke <meillo@marmaro.de>
parents: 188
diff changeset
7 After having typeset my diploma thesis with LaTeX,
c299ed65d015 Spell checked.
markus schnalke <meillo@marmaro.de>
parents: 188
diff changeset
8 the choice for troff was similar to preferring MH over mutt.
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
9 .P
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
10 I used the troff implementation of the Heirloom doctools,
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
11 and built upon the
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
12 .I ms
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
13 macro package.
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
14 To meet my personal wishes, I added further macros and replaced
228
a1468cf505fd Spellchecked.
markus schnalke <meillo@marmaro.de>
parents: 221
diff changeset
15 clumsy parts of ms.
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
16 My own macro code comprises about 400 lines.
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
17 Unfortunately, I must admit that the troff sources are not perfectly
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
18 portable as I accessed Heirloom troff extensions and ms internals,
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
19 occasionally.
221
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
20 The typesetting command line read something like:
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
21 .VS
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
22 export TROFFONTS=fonts REFER=bib
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
23 soelim style *.roff | \
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
24 refer -e -P -sLAD -l,2 -k | tbl | grap | pic | \
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
25 troff -Tps -ms -mpictures 2>err.ig | dpost >thesis.ps
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
26 VE
216
91999f2cddeb Updates of the Colophon.
markus schnalke <meillo@marmaro.de>
parents: 213
diff changeset
27 My document preparation setup was inspired and guided by
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
28 Dougherty and O'Reilly's
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
29 .I "UNIX Text Processing
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
30 and by chapter seven of Bourne's
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
31 .I "The UNIX System" .
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
32 The
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
33 .I "Nroff/Troff User's Manual
216
91999f2cddeb Updates of the Colophon.
markus schnalke <meillo@marmaro.de>
parents: 213
diff changeset
34 helped with definitive answers.
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
35 .P
228
a1468cf505fd Spellchecked.
markus schnalke <meillo@marmaro.de>
parents: 221
diff changeset
36 The mail agent diagram was written in
221
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
37 .I pic .
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
38 The figures displaying the number of switches and the amount of
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
39 code through time were created with
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
40 .I grap .
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
41 The build dependency graph was generated with
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
42 .I dot .
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
43 Source data was preprocessed with
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
44 .I awk .
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
45 For programming and for writing this document, I used the
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
46 .I ex-vi
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
47 editor because
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
48 .I ed
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
49 would have been a bit too heavy, even for me. ;-)
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
50 .P
160
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
51 The text and heading font is Philipp Poll's \fILinux Libertine\fP.
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
52 The monospace font used for code listings is a TrueType variant of
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
53 Dimitar Zhekov's \fITerminus\fP font.
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
54 Both are free typefaces.
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
55 .P
230
96778c1afc3e More cleanups.
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
56 The layout of the inner pages of this document is modeled after
216
91999f2cddeb Updates of the Colophon.
markus schnalke <meillo@marmaro.de>
parents: 213
diff changeset
57 the German book \fIEinf\[udieresis]hrung in die Automatentheorie,
160
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
58 Formale Sprache und Komplexit\[adieresis]tstheorie\fP
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
59 by Hopcroft and Ullman, Addison-Wesley, 1990.
216
91999f2cddeb Updates of the Colophon.
markus schnalke <meillo@marmaro.de>
parents: 213
diff changeset
60 The title page was inspired by books of the 19th century,
91999f2cddeb Updates of the Colophon.
markus schnalke <meillo@marmaro.de>
parents: 213
diff changeset
61 mainly by the ones of Charles Darwin.
176
25d05add0d97 Mentioned the source of the Dijkstra quote and fixed the ref system.
markus schnalke <meillo@marmaro.de>
parents: 160
diff changeset
62
160
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
63 .sp 2
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
64 .LP
213
de8172bcdc5e Improvements and rework of various kind.
markus schnalke <meillo@marmaro.de>
parents: 200
diff changeset
65 The complete sources of this document, as well as final versions in
de8172bcdc5e Improvements and rework of various kind.
markus schnalke <meillo@marmaro.de>
parents: 200
diff changeset
66 PDF and Postscript format, are available on my website:
de8172bcdc5e Improvements and rework of various kind.
markus schnalke <meillo@marmaro.de>
parents: 200
diff changeset
67 .CW http://marmaro.de/docs \^.
de8172bcdc5e Improvements and rework of various kind.
markus schnalke <meillo@marmaro.de>
parents: 200
diff changeset
68 .P
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
69 This document may be copied and redistributed in complete form.
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
70 Apart from that, follow the scientific custom:
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
71 Quote and acknowledge the reference.
176
25d05add0d97 Mentioned the source of the Dijkstra quote and fixed the ref system.
markus schnalke <meillo@marmaro.de>
parents: 160
diff changeset
72
221
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
73
37d9398c779a Updated the colophon.
markus schnalke <meillo@marmaro.de>
parents: 216
diff changeset
74 .sp \n(.tu-1u
176
25d05add0d97 Mentioned the source of the Dijkstra quote and fixed the ref system.
markus schnalke <meillo@marmaro.de>
parents: 160
diff changeset
75 Dijkstra's words on page
25d05add0d97 Mentioned the source of the Dijkstra quote and fixed the ref system.
markus schnalke <meillo@marmaro.de>
parents: 160
diff changeset
76 .Cf dijkstra.page
25d05add0d97 Mentioned the source of the Dijkstra quote and fixed the ref system.
markus schnalke <meillo@marmaro.de>
parents: 160
diff changeset
77 are a quotation of EWD\|648.