docs/master

view colophon.roff @ 227:157c92fc1597

Further improvements.
author markus schnalke <meillo@marmaro.de>
date Sun, 15 Jul 2012 23:44:15 +0200
parents 91999f2cddeb
children a1468cf505fd
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 The typesetting command line read something like:
21 .VS
22 export TROFFONTS=fonts REFER=bib
23 soelim style *.roff | \
24 refer -e -P -sLAD -l,2 -k | tbl | grap | pic | \
25 troff -Tps -ms -mpictures 2>err.ig | dpost >thesis.ps
26 VE
27 My document preparation setup was inspired and guided by
28 Dougherty and O'Reilly's
29 .I "UNIX Text Processing
30 and by chapter seven of Bourne's
31 .I "The UNIX System" .
32 The
33 .I "Nroff/Troff User's Manual
34 helped with definitive answers.
35 .P
36 The mail agent diagramm was written in
37 .I pic .
38 The figures displaying the number of switches and the amount of
39 code through time were created with
40 .I grap .
41 The build dependency graph was generated with
42 .I dot .
43 Source data was preprocessed with
44 .I awk .
45 For programming and for writing this document, I used the
46 .I ex-vi
47 editor because
48 .I ed
49 would have been a bit too heavy, even for me. ;-)
50 .P
51 The text and heading font is Philipp Poll's \fILinux Libertine\fP.
52 The monospace font used for code listings is a TrueType variant of
53 Dimitar Zhekov's \fITerminus\fP font.
54 Both are free typefaces.
55 .P
56 The layout of the inner pages of this document were modelled after
57 the German book \fIEinf\[udieresis]hrung in die Automatentheorie,
58 Formale Sprache und Komplexit\[adieresis]tstheorie\fP
59 by Hopcroft and Ullman, Addison-Wesley, 1990.
60 The title page was inspired by books of the 19th century,
61 mainly by the ones of Charles Darwin.
63 .sp 2
64 .LP
65 The complete sources of this document, as well as final versions in
66 PDF and Postscript format, are available on my website:
67 .CW http://marmaro.de/docs \^.
68 .P
69 This document may be copied and redistributed in complete form.
70 Apart from that, follow the scientific custom:
71 Quote and acknowledge the reference.
74 .sp \n(.tu-1u
75 Dijkstra's words on page
76 .Cf dijkstra.page
77 are a quotation of EWD\|648.