docs/master

view colophon.roff @ 235:e58400695ae2

Added tag final version for changeset 348b92755bef
author markus schnalke <meillo@marmaro.de>
date Mon, 16 Jul 2012 11:25:04 +0200
parents a1468cf505fd
children
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 clumsy 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 diagram 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 is modeled 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.