docs/master

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