docs/master

view colophon.roff @ 220:95257474a123

Further improvements in the discussion; added build dependency graphs.
author markus schnalke <meillo@marmaro.de>
date Sun, 15 Jul 2012 18:41:35 +0200
parents de8172bcdc5e
children 37d9398c779a
line source
1 .H- Colophon
3 .P
4 This document was typeset with the
5 .I troff
6 document preparation system on Unix.
7 After having typeset my diploma thesis with LaTeX,
8 the choice for troff was similar to preferring MH over mutt.
9 .P
10 I used the troff implementation of the Heirloom doctools,
11 and built upon the
12 .I ms
13 macro package.
14 To meet my personal wishes, I added further macros and replaced
15 clumpsy parts of ms.
16 My own macro code comprises about 400 lines.
17 Unfortunately, I must admit that the troff sources are not perfectly
18 portable as I accessed Heirloom troff extensions and ms internals,
19 occasionally.
20 .P
21 My document preparation setup was inspired and guided by
22 Dougherty and O'Reilly's
23 .I "UNIX Text Processing
24 and by chapter seven of Bourne's
25 .I "The UNIX System" .
26 The
27 .I "Nroff/Troff User's Manual
28 helped with definitive answers.
29 .P
30 The typesetting command line read something like:
31 .VS
32 export TROFFONTS=fonts REFER=bib
33 soelim style *.roff | refer -e -P -sLAD -l,2 -k | \
34 tbl | grap | pic | troff -Tps -ms 2>err.ig | dpost >thesis.ps
35 VE
36 .P
37 The text and heading font is Philipp Poll's \fILinux Libertine\fP.
38 The monospace font used for code listings is a TrueType variant of
39 Dimitar Zhekov's \fITerminus\fP font.
40 Both are free typefaces.
41 .P
42 The layout of the inner pages of this document were modelled after
43 the German book \fIEinf\[udieresis]hrung in die Automatentheorie,
44 Formale Sprache und Komplexit\[adieresis]tstheorie\fP
45 by Hopcroft and Ullman, Addison-Wesley, 1990.
46 The title page was inspired by books of the 19th century,
47 mainly by the ones of Charles Darwin.
48 .P
49 For programming and for writing this document, I used the
50 .Pn ex-vi
51 editor because
52 .Pn ed
53 would have been a bit too heavy, even for me. ;-)
55 .sp 2
56 .LP
57 The complete sources of this document, as well as final versions in
58 PDF and Postscript format, are available on my website:
59 .CW http://marmaro.de/docs \^.
60 .P
61 This document may be copied and redistributed in complete form.
62 Apart from that, follow the scientific custom:
63 Quote and acknowledge the reference.
65 .sp 2.5c
66 .LP
67 Dijkstra's words on page
68 .Cf dijkstra.page
69 are a quotation of EWD\|648.