docs/master
view style @ 236:49d3aa0d128a
style: Removed unused macro code.
| author | markus schnalke <meillo@marmaro.de> |
|---|---|
| date | Mon, 16 Jul 2012 11:31:25 +0200 |
| parents | 8be9e84be526 |
| children |
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 .fp 0 U TerminusMedium-4.36 ttf
21 .ftr CW -\-`\`'\'
22 .ftr CI -\-`\`'\'
23 .ftr CB -\-`\`'\'
24 .ftr L -\-`\`'\'
25 .ftr U -\-`\`'\'
26 .fzoom U .9
27 .fp 0 SC LinLibertine_R otf
28 .feature SC +onum +smcp
29 .fp 0 IC LinLibertine_RI otf
30 .feature IC +onum +smcp
31 .fp 0 BC LinLibertine_RB otf
32 .feature BC +onum +smcp
34 .ss 12 0 \" the second (non-portable) argument requests french spacing
36 .nr PI 4n
37 .nr PD .3v
38 .nr QI 2u*\n(PIu
39 .nr lu 0
40 .af PN i
42 .ds _E '\\\\n(PN''\f(SCMarkus Schnalke: The Modern Mail Handler\fP' \" left
43 .ds _a '\f(SCAppendix \\\\n(H1\ \ \\\\*(_C\fP''\\\\n(PN' \" right
44 .ds _O '\f(SCChapter \\\\n(H1\ \ \\\\*(_C\fP''\\\\n(PN' \" right
45 .ds _o '\f(SC\\\\*(_C\fP''\\\\n(PN' \" right
46 .ds CH "
48 .nr HM 3.3c
49 .nr FM 6.6c
50 .nr LL 13c
51 .ll 13c
52 .nr LT \n(LL
54 . \" _M - change margins for text block on next page
55 .de _M
56 .if t .if o .nr PO 5c
57 .if t .if e .nr PO 3c
58 .ds CF "
59 ..
60 .wh -1u _M
62 . \" ZZ - enlarge or shorten the text block on the current
63 . \" page to avoid widows
64 . \" .ZZ -> enlarge by one line
65 . \" .ZZ +3 -> enlarge by three lines
66 . \" .ZZ -2 -> shorten by two lines
67 . \" .ZZ +1c -> enlarge by one centimeter
68 . \" .ZZ "" -> reset to the default
69 .de ZZ
70 .ie \\n(.$=0 .ch FO -\\n(FMu+1v
71 .el .ch FO -\\n(FMu\\$1
72 ..
74 . \" CW - Set text in CW font (similar to .B and .I)
75 .de CW
76 .nr PQ \\n(.f
77 .if t \{\
78 . ft CW
79 . if !^\\$1^^ \&\\$1\f\\n(PQ\\$2
80 .\}
81 .if n \{\
82 . ie ^\\$1^^ .ul 999
83 . el .ul 1
84 . if \\n(.$=1 \&\\$1
85 . if \\n(.$>1 \&\\$1\c
86 . if \\n(.$>1 \&\\$2
87 .\}
88 ..
90 . \" refer(1) stuff
91 .ds [. " [
92 .ds .] ]
93 .rm ]<
94 .de ]<
95 . de FP
96 . IP \\\\$1
97 \\..
98 . rm FS FE
99 ..
101 . \" PT - page top macro of ms
102 .am PT
103 . rs
104 ..
107 . \" RN - Reset PN and continue on an odd page ($1=number-format)
108 .de RN
109 .ie e .pn 1
110 .el \{
111 . pn 0
112 . bp
113 .\}
114 .ie \\n(.$=1 .af PN \\$1
115 .el .af PN 1
116 ..
119 . \" T_ - Add TOC entry ($1=pre-space $2=indent-level $3=text)
120 .de T_
121 .tm TOC____.sp \\$1
122 .tm TOC____\&\\h'\\$2u*2u*\\n(PIu'\\$3\0\0\a\t\\n(PN\fR
123 ..
125 . \" NH - redefine numbered heading
126 .de NH
127 .SH
128 .nr NS \\$1
129 .if !\\n(.$ .nr NS 1
130 .if !\\n(NS .nr NS 1
131 .nr H\\n(NS +1
132 .if \\n(NS<2 .nr H2 0
133 .if \\n(NS<3 .nr H3 0
134 .ds SN \\n(H1
135 .if \\n(NS>1 .as SN \&.\\n(H2
136 .if \\n(NS>2 .as SN \&.\\n(H3
137 ..
139 . \" H- - Chapter not numbered and not in TOC
140 .de H-
141 .EH "
142 .OH "
143 .bp
144 .if e .rs \" move to an odd page
145 .if e .bp
146 .lg 0
147 .nr PS +6
148 .nr VS +6
149 .SH
150 .ce 1
151 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
152 \&\\$1
153 .br
154 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
155 .nr PS -6
156 .nr VS -6
157 .lg
158 .EH "\\\\*(_E
159 .OH "\\\\*(_o
160 .ds CF \\n(PN
161 .RT
162 .sp 4
163 .nr PP 0
164 ..
166 . \" AP - Start the Appendix
167 .de AP
168 .nr _A 1
169 .nr H1 0
170 .af H1 A
171 ..
173 . \" H0 - Chapter ($2=="no" -> not numbered)
174 .de H0
175 .EH "
176 .OH "
177 .bp
178 .if e .rs \" begin chapter on an odd page
179 .if e .bp
180 .lg 0
181 .nr PS +6
182 .nr VS +6
183 .ie ,\\$2,no, .SH
184 .el \{\
185 . NH 1
186 . ce 1
187 .ie \\n(_A Appendix \\*(SN
188 .el Chapter \\*(SN
189 . sp .5
190 .\}
191 .ce 1
192 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
193 \&\\$1
194 .br
195 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
196 .nr PS -6
197 .nr VS -6
198 .lg
199 .\" add to TOC
200 .rm t_
201 .if !,\\$2,no, .ds t_ \\Z'\\*(SN'\\h'3n'
202 .T_ .5v 0 "\fB\\*(t_\\$1
203 .\" set page headers and footers
204 .EH "\\\\*(_E
205 .ds _C "\\$1
206 .ie ,\\$2,no, .OH "\\\\*(_o
207 .el .ie \\n(_A .OH "\\\\*(_a
208 .el .OH "\\\\*(_O
209 .ds CF \\n(PN
210 .RT
211 .sp 4
212 .nr PP 0
213 ..
216 . \" H1 - Section ($2=="no" -> not numbered)
217 .de H1
218 .br
219 .ne 7
220 .sp
221 .lg 0
222 .nr PS +2
223 .nr VS +2
224 .ie '\\$2'no' .SH
225 .el .NH 2
226 .if !'\\$2'no' \&\\*(SN
227 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
228 \&\\$1
229 .br
230 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
231 .nr PS -2
232 .nr VS -2
233 .lg
234 .if !'\\$2'no' .T_ .3v 1 "\\Z'\\*(SN'\\h'4n'\\$1 \" add to TOC
235 .RT
236 .nr PP 0
237 ..
239 . \" H2 - Subsection
240 .de H2
241 .br
242 .ne 4
243 .NH 3
244 \&\\*(SN \\$1
245 .T_ 0 2 "\\Z'\\*(SN'\\h'5.5n'\\$1 \" add to TOC
246 .RT
247 .nr PP 0
248 ..
250 . \" U2 - Subsection unnumbered
251 .de U2
252 .br
253 .ne 4
254 .SH
255 \&\\$1
256 .RT
257 .nr PP 0
258 ..
260 . \" U3 - Subsubsection unnumbered
261 .de U3
262 .br
263 .ne 4
264 .RT
265 .sp
266 .I "\\$1
267 .RT
268 .nr PP 0
269 ..
271 . \" P - Paragraph (indented unless following a heading)
272 .de P
273 .ie \\n(PP .PP
274 .el .LP
275 .nr PP 1
276 ..
278 .am LP
279 .nr PP 1
280 ..
283 . \" LI - Numbered paragraph ``list item'' ($1=label)
284 .de LI
285 .ie \\n(.$ .IP "\\h'\\n(PIu'\\$1." 2u*\\n(PIu
286 .el .IP "\\h'\\n(PIu'\\(bu" 2u*\\n(PIu
287 .nr PP 1
288 ..
289 .ig \" backup
290 .ie \\n(.$ .IP "\h'1n'\\$1"
291 .el .IP "\h'1.5n'\\(bu"
292 ..
294 . \" BU - Bulleted paragraph
295 .de BU
296 .LI
297 ..
299 . \" QS - Block quote start
300 .de QS
301 .ti \\n(.iu
302 .\"RT
303 .sp 2u*\\n(PDu
304 .ne 1.1
305 .ps -1
306 .vs -1
307 .in +\\n(QIu
308 .ll -\\n(QIu
309 .ti \\n(.iu
310 .\"if \\n(Qp .ti +\\n(PIu
311 .\"nr QP 1
312 .\"rr Qp
313 ..
315 . \" QP - Block quote paragraph
316 .de QP
317 .sp \n(PDu
318 .ne 1.1
319 .ti +\\n(PIu
320 ..
322 . \" QP - Block quote end
323 .de QE
324 .sp \\n(PDu
325 .in -\\n(QIu
326 .ll +\\n(QIu
327 .ti \\n(.iu
328 .ps +1
329 .vs +1
330 ..
332 . \" DS - Code display
333 .am DS
334 .ft CW
335 .ps -1
336 .ta T 8n
337 ..
339 . \" VS - verbatim text start (\\ -> ^G; ' -> disabled; . -> ^B)
340 .de VS
341 .br
342 .ne 3
343 .sp \n(DDu
344 .di _V
345 .nf
346 .ft CW
347 .ps -.5
348 .\" set up verbatim environment
349 \.blm
350 \.ec
351 \.c2 ""
352 \.cc
353 ..
355 . \" VE - verbatim text end (NOTE: Needs to be called as ^BVE !)
356 .de VE
357 \" restore the special characters
358 cc
359 .c2
360 .ec
361 .br
362 .di
363 .ne \\n(dnu+1v \" ensure enough space on the page
364 .in +2u*\\n(PIu
365 .ta T 8n
366 \.ec \" set up verbatim environment, once again
367 \.c2 ""
368 \.cc
369 _V \" output the verbatim content
370 \" restore the special characters
371 cc
372 .c2
373 .ec
374 .blm __
375 .in -2u*\\n(PIu
376 .sp \n(DDu
377 .ps +.5
378 .ft P
379 .fi
380 .TA
381 ..
383 . \" VF - verbatim text from file ($1=filename)
384 .de VF
385 .VS
386 so $1
387 VE
388 ..
390 .de Fn \" file name
391 .CW "\\$1" "\\$2
392 ..
393 .de Pn \" program name
394 .CW "\\$1" "\\$2
395 ..
396 .de Fu \" function
397 .CW "\\$1" "\\$2
398 ..
399 .de Ev \" env variable
400 .CW "\\$1" "\\$2
401 ..
402 .de Cl \" command line
403 `\c
404 .CW "\\$1" "'\\$2
405 ..
406 .de Sw \" switch
407 .CW "\\$1" "\\$2
408 ..
409 .de Ar \" argument
410 .CW "\f(CI\\$1" "\\$2
411 ..
412 .de Mp \" man page
413 .I "\\$1" "\\$2
414 ..
415 .de Pe \" profile entry
416 .CW "\\$1" "\\$2
417 ..
418 .de Hd \" mail header field
419 .CW "\\$1:\&" "\\$2
420 ..
422 .de Ci \" commit hash ref
423 .ds _t \\$1
424 .substring _t 0 6
425 [\(rh\|\fL\\*(_t\fP]\\$2
426 ..
428 . \" Cf - reference within the document ($1=name of ref file)
429 .de Cf
430 \.if !\\nZ .so refs/\\$1 \c
431 \\$2
432 ..
434 . \" Id - put a referenceable marker here ($1=identifier)
435 .de Id
436 .tm REF____\\$1\t\\*(SN\t\\n(PN
437 ..