docs/master

annotate colophon.roff @ 185:6f8adf7d190c

style: Extended the system to handle appendices and fixed the page hdrs.
author markus schnalke <meillo@marmaro.de>
date Wed, 11 Jul 2012 11:05:22 +0200
parents eb6eeb10afd5
children a0b5050878a0
rev   line source
meillo@185 1 .H- Colophon
meillo@147 2 .P
meillo@147 3 This document was typeset with the
meillo@147 4 .I troff
meillo@147 5 document preparation system on Unix.
meillo@159 6 After having typset my diploma thesis with LaTeX,
meillo@159 7 the choice for troff was similar to prefering MH over mutt.
meillo@147 8 .P
meillo@147 9 I used the troff implementation of the Heirloom doctools,
meillo@147 10 and built upon the
meillo@147 11 .I ms
meillo@147 12 macro package.
meillo@147 13 To meet my personal wishes, I added further macros and replaced
meillo@147 14 clumpsy parts of ms.
meillo@147 15 My own macro code comprises about 400 lines.
meillo@147 16 Unfortunately, I must admit that the troff sources are not perfectly
meillo@147 17 portable as I accessed Heirloom troff extensions and ms internals,
meillo@147 18 occasionally.
meillo@147 19 .P
meillo@147 20 My troff setup was inspired and guided by
meillo@147 21 Dougherty and O'Reilly's
meillo@147 22 .I "UNIX Text Processing
meillo@147 23 and by chapter seven of Bourne's
meillo@147 24 .I "The UNIX System" .
meillo@147 25 The
meillo@147 26 .I "Nroff/Troff User's Manual
meillo@147 27 added definitive answers.
meillo@147 28 .P
meillo@147 29 The typesetting command line read something like:
meillo@147 30 .VS
meillo@147 31 export TROFFONTS=fonts REFER=bib
meillo@147 32 soelim style *.roff | refer -e -P -sLAD -l,2 -k | \
meillo@147 33 grap | pic | troff -Tps -ms 2>err.ig | dpost >thesis.ps
meillo@147 34 VE
meillo@147 35 .P
meillo@160 36 The text and heading font is Philipp Poll's \fILinux Libertine\fP.
meillo@160 37 The monospace font used for code listings is a TrueType variant of
meillo@160 38 Dimitar Zhekov's \fITerminus\fP font.
meillo@160 39 Both are free typefaces.
meillo@160 40 .P
meillo@160 41 The page layout of the document was greatly inspired by the German book
meillo@160 42 \fIEinf\[udieresis]hrung in die Automatentheorie,
meillo@160 43 Formale Sprache und Komplexit\[adieresis]tstheorie\fP
meillo@160 44 by Hopcroft and Ullman, Addison-Wesley, 1990.
meillo@160 45 .P
meillo@179 46 For measuring code size, I used David A. Wheeler's
meillo@179 47 .Pn sloccount .
meillo@179 48 .P
meillo@147 49 The complete sources of this document, as well as final versions in
meillo@147 50 PDF and Postscript format, are available on my website:
meillo@147 51 .L http://marmaro.de/docs \^.
meillo@176 52
meillo@160 53 .sp 2
meillo@160 54 .LP
meillo@147 55 This document may be copied and redistributed in complete form.
meillo@147 56 Apart from that, follow the scientific custom:
meillo@147 57 Quote and acknowledge the reference.
meillo@176 58
meillo@181 59 .sp 3c
meillo@176 60 .LP
meillo@176 61 Dijkstra's words on page
meillo@176 62 .Cf dijkstra.page
meillo@176 63 are a quotation of EWD\|648.