Mercurial > docs > master

annotate colophon.roff @ 216:91999f2cddeb

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