Mercurial > docs > master

annotate colophon.roff @ 197:05a243dffaca

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added refs to the Preface; splitted the bib.
author markus schnalke <meillo@marmaro.de>
date Thu, 12 Jul 2012 00:39:41 +0200
parents a0b5050878a0
children c299ed65d015
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
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
2 .P
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
3 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
4 .I troff
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
5 document preparation system on Unix.
159
8b411125645d Corrections and improvements by Kate, Phil, Matou, Michi, Lydi.
markus schnalke <meillo@marmaro.de>
parents: 153
diff changeset
6 After having typset my diploma thesis with LaTeX,
8b411125645d Corrections and improvements by Kate, Phil, Matou, Michi, Lydi.
markus schnalke <meillo@marmaro.de>
parents: 153
diff changeset
7 the choice for troff was similar to prefering 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
8 .P
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
9 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
10 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
11 .I ms
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
12 macro package.
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
13 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
14 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
15 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
16 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
17 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
18 occasionally.
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
19 .P
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
20 My troff setup was inspired and guided by
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
21 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
22 .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
23 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
24 .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
25 The
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
26 .I "Nroff/Troff User's Manual
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
27 added definitive answers.
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
28 .P
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
29 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
30 .VS
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
31 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
32 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
33 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
34 VE
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
35 .P
160
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
36 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
37 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
38 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
39 Both are free typefaces.
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
40 .P
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
41 The page layout of the document was greatly inspired by the German book
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
42 \fIEinf\[udieresis]hrung in die Automatentheorie,
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
43 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
44 by Hopcroft and Ullman, Addison-Wesley, 1990.
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
45 .P
179
b59201e345e5 Applied further corrections by Aaron.
markus schnalke <meillo@marmaro.de>
parents: 176
diff changeset
46 For measuring code size, I used David A. Wheeler's
b59201e345e5 Applied further corrections by Aaron.
markus schnalke <meillo@marmaro.de>
parents: 176
diff changeset
47 .Pn sloccount .
b59201e345e5 Applied further corrections by Aaron.
markus schnalke <meillo@marmaro.de>
parents: 176
diff changeset
48 .P
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
49 The complete sources of this document, as well as final versions in
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
50 PDF and Postscript format, are available on my website:
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
51 .L http://marmaro.de/docs \^.
176
25d05add0d97 Mentioned the source of the Dijkstra quote and fixed the ref system.
markus schnalke <meillo@marmaro.de>
parents: 160
diff changeset
52
160
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
53 .sp 2
160b62e77f55 colophon: A bit more information on typefaces and the layout.
markus schnalke <meillo@marmaro.de>
parents: 159
diff changeset
54 .LP
147
e7b5e465a8e0 Added the confirmation of own work and a colophon, listing the tools used.
markus schnalke <meillo@marmaro.de>
parents:
diff changeset
55 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
56 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
57 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
58
181
eb6eeb10afd5 Various stuff: Checked quotes, s/further more/furthermore/, etc
markus schnalke <meillo@marmaro.de>
parents: 179
diff changeset
59 .sp 3c
176
25d05add0d97 Mentioned the source of the Dijkstra quote and fixed the ref system.
markus schnalke <meillo@marmaro.de>
parents: 160
diff changeset
60 .LP
25d05add0d97 Mentioned the source of the Dijkstra quote and fixed the ref system.
markus schnalke <meillo@marmaro.de>
parents: 160
diff changeset
61 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
62 .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
63 are a quotation of EWD\|648.