docs/master

view style @ 79:f3c95ee96cc4

Moved TOC from end to beginning; extended makefile. The TOC generation concept and idea was inspired by the book ``UNIX Text Processing''.
author markus schnalke <meillo@marmaro.de>
date Wed, 06 Jun 2012 10:56:14 +0200
parents 0947c24dd4c6
children 5fb821ed6f3c
line source
1 .do xflag 3
2 .de __
3 ..
4 .blm __ \" ignore empty lines in input
5 .lc_ctype en_US.utf8
6 .mediasize a4
8 .fp 1 R LinLibertine_R otf
9 .feature R +onum
10 .fp 2 I LinLibertine_RI otf
11 .feature I +onum
12 .fp 3 B LinLibertine_RB otf
13 .feature B +onum
14 .fp 4 BI LinLibertine_RBI otf
15 .feature BI +onum
16 .fp 5 CW TerminusMedium-4.36 ttf
17 .fp 0 CI TerminusMediumItalic-4.36 ttf
18 .fp 0 CB TerminusBold-4.36 ttf
19 .fp 0 L TerminusMedium-4.36 ttf
20 .ftr CW -\-
21 .ftr CI -\-
22 .ftr CB -\-
23 .ftr L -\-
24 .fp 0 SC LinLibertine_R otf
25 .feature SC +onum +smcp
26 .fp 0 IC LinLibertine_RI otf
27 .feature IC +onum +smcp
28 .fp 0 BC LinLibertine_RB otf
29 .feature BC +onum +smcp
31 .ig
32 . nr PS 11
33 . nr VS 13
34 . padj
35 ..
37 .nr PI 3n
38 .nr PD .3v
39 .nr lu 0
40 .af PN i
42 .ds _E '\\\\n(PN''\f(SCMarkus Schnalke: The Modern Mail Handler\fP' \" left
43 .ds _O '\f(SCChapter \\\\n(H1\ \ \\\\*(_C\fP''\\\\n(PN' \" right
44 .ds _o '\f(SC\\\\*(_C\fP''\\\\n(PN' \" right
45 .ds CH "
47 .nr HM 3.3c
48 .nr FM 6.6c
49 .nr LL 13c
50 .ll 13c
51 .nr LT \n(LL
52 .if t .nr PO 3.3c
54 .de _M \" change margins for text block on next page
55 .if t .if o .nr PO +(21c-\n(.lu-(2u*3.3c))c
56 .if t .if e .nr PO -(21c-\n(.lu-(2u*3.3c))c
57 .ds CF "
58 ..
59 .wh -1u _M
61 .de CW
62 .nr PQ \\n(.f
63 .if t \{\
64 . ft CW
65 . if !^\\$1^^ \&\\$1\f\\n(PQ\\$2
66 .\}
67 .if n \{\
68 . ie ^\\$1^^ .ul 999
69 . el .ul 1
70 . if \\n(.$=1 \&\\$1
71 . if \\n(.$>1 \&\\$1\c
72 . if \\n(.$>1 \&\\$2
73 .\}
74 ..
76 .ds [. " [
77 .ds .] ]
78 .rm ]<
79 .de ]<
80 . LP
81 . de FP
82 . IP \\\\$1.
83 \\..
84 . rm FS FE
85 ..
87 .am PT
88 . rs
89 ..
91 .de T_ \" add entry to TOC: .T_ pre-space indent-level text
92 .tm TOC____.sp \\$1
93 .tm TOC____\&\\h'\\$2u*2u*\\n(PIu'\\$3\0\0\a\t\\n(PN\fR
94 ..
96 .rm NH
97 .de NH
98 .SH
99 .nr NS \\$1
100 .if !\\n(.$ .nr NS 1
101 .if !\\n(NS .nr NS 1
102 .nr H\\n(NS +1
103 .if \\n(NS<2 .nr H2 0
104 .if \\n(NS<3 .nr H3 0
105 .ds SN \\n(H1
106 .if \\n(NS>1 .as SN \&.\\n(H2
107 .if \\n(NS>2 .as SN \&.\\n(H3
108 ..
110 .de H-
111 .EH "
112 .OH "
113 .bp
114 .rs
115 .if e .bp
116 .lg 0
117 .nr PS +6
118 .nr VS +6
119 .SH
120 .ce 1
121 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
122 \&\\$1
123 .br
124 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
125 .nr PS -6
126 .nr VS -6
127 .lg
128 .RT
129 .if !,\\$2,no, \{
130 . EH "\\\\*(_E
131 . ie \\n(H1 .OH "\\\\*(_O
132 . el .OH "\\\\*(_o
133 . ds CF \\n(PN
134 .\}
135 .sp 4
136 .nr PP 0
137 ..
139 .de H0
140 .EH "
141 .OH "
142 .bp
143 .rs
144 .if e .bp
145 . lg 0
146 . nr PS +6
147 . nr VS +6
148 .ie \\n(.$=1 \{\
149 . NH 1
150 . ce 1
151 Chapter \\*(SN
152 . sp .5
153 .\}
154 .el .if ,\\$2,no, .SH
155 . ce 1
156 . tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
157 \&\\$1
158 . br
159 . tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
160 . nr PS -6
161 . nr VS -6
162 . lg
163 .ds _C "\\$1
164 . RT
165 .rm t_
166 .if !,\\$2,no, .ds t_ \\*(SN\0\0
167 .T_ .5v 0 "\fB\\*(t_\\$1
168 .EH "\\\\*(_E
169 .ie \\n(H1 .OH "\\\\*(_O
170 .el .OH "\\\\*(_o
171 .ds CF \\n(PN
172 .sp 4
173 .nr PP 0
174 ..
177 .\" Reset page Numbers, set page number format ($1) and move to a right page.
178 .de RN
179 .ie e .pn 1
180 .el \{
181 . pn 0
182 . bp
183 .\}
184 .ie \\n(.$=1 .af PN \\$1
185 .el .af PN 1
186 ..
189 .de H1
190 .br
191 .ne 7
192 .sp
193 . nr PS +2
194 . nr VS +2
195 .if '\\$2'no' .SH
196 .if \\n(.$=1 .NH 2
197 . lg 0
198 . tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
199 .if !'\\$2'no' \&\\*(SN
200 \\$1
201 . br
202 . tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
203 . nr PS -2
204 . nr VS -2
205 . lg
206 . RT
207 .if !'\\$2'no' \{\
208 . ds _S "\\$1
209 . T_ .3v 1 "\\*(SN\0\0\\$1
210 .\}
211 .nr PP 0
212 ..
214 .de H2
215 .br
216 .ne 4
217 .NH 3
218 \&\\*(SN
219 \\$1
220 .RT
221 .ds _S "\\$1
222 .T_ 0 2 "\\*(SN\0\0\\$1
223 .nr PP 0
224 ..
226 .de U2
227 .br
228 .ne 4
229 .SH
230 \\$1
231 .RT
232 .nr PP 0
233 ..
235 .de U3
236 .br
237 .ne 4
238 .RT
239 .sp
240 .I "\\$1
241 .RT
242 .nr PP 0
243 ..
245 .de P
246 .ie \\n(PP .PP
247 .el .LP
248 .nr PP 1
249 ..
251 .am IP
252 .nr PP 0
253 ..
255 .de BU
256 .IP \(bu
257 ..
259 .am QP
260 .ps -1
261 ..
263 .am DS
264 .ft CW
265 .ps -1
266 .ta T 8n
267 ..
269 .am FA
270 .ps 8
271 .vs 9
272 ..
274 .de Fn \" file name
275 .CW "\\$1" "\\$2
276 ..
277 .de Pn \" program name
278 .CW "\\$1" "\\$2
279 ..
280 .de Fu \" function
281 .CW "\\$1" "\\$2
282 ..
283 .de Ev \" env variable
284 .CW "\\$1" "\\$2
285 ..
286 .de Cl \" command line
287 `\c
288 .CW "\\$1" "'\\$2
289 ..
290 .de Sw \" switch
291 .CW "\\$1" "\\$2
292 ..
293 .de Mp \" man page
294 .I "\\$1" "\\$2
295 ..
296 .de Pe \" profile entry
297 .CW "\\$1" "\\$2
298 ..
300 .de Ci \" commit ref
301 .ds _t \\$1
302 .substring _t 0 6
303 [\(rh
304 .CW "\\*(_t" "]\\$2
305 ..
307 .de Cf \" cf. (ref within document)
308 (\(-> \\$1)\\$2
309 ..