docs/bib-ref2

annotate style @ 24:0ad432eaeb71

makefile: we have a table too now, thus pipe through tbl(1)
author markus schnalke <meillo@marmaro.de>
date Wed, 05 Mar 2014 12:48:21 +0100
parents deab4a0f4fb0
children b07970cdf8a7
rev   line source
meillo@0 1 .do xflag 3
meillo@0 2 .de __
meillo@0 3 ..
meillo@0 4 .blm __ \" ignore empty lines in input
meillo@0 5 .lc_ctype en_US.utf8
meillo@0 6 .mediasize a4
meillo@0 7
meillo@0 8 .ds _f libertine
meillo@0 9
meillo@0 10 .if '\*(_f'bookman' \{\
meillo@0 11 .fp 1 R urw/bookman/ubkl8a pfb
meillo@0 12 .fp 2 I urw/bookman/ubkli8a pfb
meillo@0 13 .fp 3 B urw/bookman/ubkd8a pfb
meillo@0 14 .fp 4 BI urw/bookman/ubkdi8a pfb
meillo@0 15 .\}
meillo@0 16 .if '\*(_f'sabon' \{\
meillo@0 17 .fp 1 R sabon-t1/psbr8a pfb
meillo@0 18 .fp 2 I sabon-t1/psbri8 pfb
meillo@0 19 .fp 3 B sabon-t1/psbb8 pfb
meillo@0 20 .fp 4 BI sabon-t1/psbbi8 pfb
meillo@0 21 .\}
meillo@0 22 .if '\*(_f'palatino' \{\
meillo@0 23 .fp 1 R urw/palatino/uplr8a pfb
meillo@0 24 .fp 2 I urw/palatino/uplri8 pfb
meillo@0 25 .fp 3 B urw/palatino/uplb8 pfb
meillo@0 26 .fp 4 BI urw/palatino/uplbi8 pfb
meillo@0 27 .\}
meillo@0 28 .if '\*(_f'libertine' \{\
meillo@0 29 .fp 1 R LinLibertine_R otf
meillo@0 30 .feature R +onum
meillo@0 31 .fp 2 I LinLibertine_RI otf
meillo@0 32 .feature I +onum
meillo@0 33 .fp 3 B LinLibertine_RB otf
meillo@0 34 .feature B +onum
meillo@0 35 .fp 4 BI LinLibertine_RBI otf
meillo@0 36 .feature BI +onum
meillo@0 37 .\}
meillo@0 38
meillo@0 39
meillo@0 40 .ss 12 0 \" the second (non-portable) argument requests french spacing
meillo@0 41
meillo@0 42 .nr PI 4n
meillo@0 43 .nr PD 0 \".3v
meillo@0 44 .nr QI 2u*\n(PIu
meillo@0 45 .nr lu 0
meillo@0 46 .af PN i
meillo@0 47 .af % i
meillo@0 48
meillo@0 49 .hylang de_DE
meillo@0 50
meillo@5 51 .nr PS 12
meillo@5 52 .nr VS 20
meillo@0 53
meillo@0 54 .ds CH "
meillo@0 55
meillo@0 56 .nr PO 2.5c
meillo@0 57 .nr HM 3.5c
meillo@0 58 .nr FM 3.5c
meillo@0 59 .nr LL 15c
meillo@0 60 .ll 15c
meillo@0 61 .nr LT \n(LL
meillo@0 62
meillo@0 63 . \" _M - change margins for text block on next page
meillo@0 64 .de _M
meillo@0 65 .\" if t .if o .nr PO 5c
meillo@0 66 .\" if t .if e .nr PO 3c
meillo@0 67 .\" nr PO 2.5c
meillo@0 68 .\" ds CF "
meillo@0 69 ..
meillo@0 70 .\" .wh -1u _M
meillo@0 71
meillo@0 72 .de _H
meillo@0 73 'sp |\n(HMu-1.5c
meillo@0 74 .ps 12
meillo@0 75 .vs 14
meillo@0 76 .ft I
meillo@3 77 .\" .tl 'Markus Schnalke: Open Access aus der Perspektive der Freien Software''%'
meillo@19 78 .\" .tl 'Markus Schnalke: Open Access und Freie Software''%'
meillo@19 79 .tl 'Markus Schnalke: Open Access, Freie Software und Co.''%'
meillo@0 80 .ft P
meillo@0 81 .ps
meillo@0 82 .vs
meillo@0 83 ..
meillo@0 84 .wh 1u _H
meillo@0 85
meillo@0 86 . \" ZZ - enlarge or shorten the text block on the current
meillo@0 87 . \" page to avoid widows
meillo@0 88 . \" .ZZ -> enlarge by one line
meillo@0 89 . \" .ZZ +3 -> enlarge by three lines
meillo@0 90 . \" .ZZ -2 -> shorten by two lines
meillo@0 91 . \" .ZZ +1c -> enlarge by one centimeter
meillo@0 92 . \" .ZZ "" -> reset to the default
meillo@0 93 .de ZZ
meillo@0 94 .ie \\n(.$=0 .ch FO -\\n(FMu+1v
meillo@0 95 .el .ch FO -\\n(FMu\\$1
meillo@0 96 ..
meillo@0 97
meillo@0 98 . \" CW - Set text in CW font (similar to .B and .I)
meillo@0 99 .de CW
meillo@0 100 .nr PQ \\n(.f
meillo@0 101 .if t \{\
meillo@0 102 . ft CW
meillo@0 103 . if !^\\$1^^ \&\\$1\f\\n(PQ\\$2
meillo@0 104 .\}
meillo@0 105 .if n \{\
meillo@0 106 . ie ^\\$1^^ .ul 999
meillo@0 107 . el .ul 1
meillo@0 108 . if \\n(.$=1 \&\\$1
meillo@0 109 . if \\n(.$>1 \&\\$1\c
meillo@0 110 . if \\n(.$>1 \&\\$2
meillo@0 111 .\}
meillo@0 112 ..
meillo@0 113
meillo@0 114 . \" refer(1) stuff
meillo@0 115 .ds [. " [
meillo@0 116 .ds .] ]
meillo@0 117 .rm ]<
meillo@0 118 .de ]<
meillo@0 119 . de FP
meillo@0 120 . IP \\\\$1
meillo@0 121 \\..
meillo@0 122 . rm FS FE
meillo@0 123 ..
meillo@0 124
meillo@0 125 . \" PT - page top macro of ms
meillo@0 126 .am PT
meillo@0 127 . rs
meillo@0 128 ..
meillo@0 129
meillo@0 130
meillo@0 131 . \" RN - Reset PN and continue on an odd page ($1=number-format)
meillo@0 132 .de RN
meillo@0 133 .ie e .pn 1
meillo@0 134 .el \{
meillo@0 135 . pn 0
meillo@0 136 . bp
meillo@0 137 .\}
meillo@0 138 .ie \\n(.$=1 \{\
meillo@0 139 . af PN \\$1
meillo@0 140 . af % \\$1
meillo@0 141 .\}
meillo@0 142 .el \{\
meillo@0 143 . af PN 1
meillo@0 144 . af % 1
meillo@0 145 .\}
meillo@0 146 ..
meillo@0 147
meillo@0 148
meillo@0 149 . \" T_ - Add TOC entry ($1=pre-space $2=indent-level $3=text)
meillo@0 150 .de T_
meillo@0 151 .tm TOC____.sp \\$1
meillo@0 152 .tm TOC____\&\\h'\\$2u*2u*\\n(PIu'\\$3\0\0\a\t\\n(PN\fR
meillo@0 153 ..
meillo@0 154
meillo@0 155 . \" NH - redefine numbered heading
meillo@0 156 .de NH
meillo@0 157 .SH
meillo@0 158 .nr NS \\$1
meillo@0 159 .if !\\n(.$ .nr NS 1
meillo@0 160 .if !\\n(NS .nr NS 1
meillo@0 161 .nr H\\n(NS +1
meillo@0 162 .if \\n(NS<2 .nr H2 0
meillo@0 163 .if \\n(NS<3 .nr H3 0
meillo@0 164 .ds SN \\n(H1
meillo@0 165 .if \\n(NS>1 .as SN \&.\\n(H2
meillo@0 166 .if \\n(NS>2 .as SN \&.\\n(H3
meillo@0 167 ..
meillo@0 168
meillo@0 169 . \" H- - Chapter not numbered and not in TOC ($2==yes -> TOC)
meillo@0 170 .de H-
meillo@0 171 .ig IG
meillo@0 172 .EH "
meillo@0 173 .OH "
meillo@0 174 .IG
meillo@0 175 .bp
meillo@0 176 .\" .if e .rs \" move to an odd page
meillo@0 177 .\" .if e .bp
meillo@0 178 .lg 0
meillo@0 179 .nr PS +6
meillo@0 180 .nr VS +6
meillo@0 181 .SH
meillo@0 182 .ce 1
meillo@0 183 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZäÄöÖüÜ
meillo@0 184 \&\\$1
meillo@0 185 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzzääööüü
meillo@0 186 .br
meillo@0 187 .nr PS -6
meillo@0 188 .nr VS -6
meillo@0 189 .lg
meillo@0 190 .ig IG
meillo@0 191 .EH "\\\\*(_E
meillo@0 192 .OH "\\\\*(_o
meillo@0 193 .IG
meillo@0 194 .\" .ds CF \\n(PN
meillo@0 195 .if '\\$2'yes' \{
meillo@0 196 .rm t_
meillo@0 197 .T_ .5v 0 "\fB\\*(t_\\$1
meillo@0 198 .\}
meillo@0 199 .RT
meillo@0 200 .sp 2
meillo@0 201 .nr PP 0
meillo@0 202 ..
meillo@0 203
meillo@0 204 . \" AP - Start the Appendix
meillo@0 205 .de AP
meillo@0 206 .nr _A 1
meillo@0 207 .nr H1 0
meillo@0 208 .af H1 A
meillo@0 209 ..
meillo@0 210
meillo@0 211 . \" H0 - Chapter ($2=="no" -> not numbered)
meillo@0 212 .de H0
meillo@0 213 .\" bp
meillo@0 214 .\" .if e .rs \" begin chapter on an odd page
meillo@0 215 .\" .if e .bp
meillo@0 216 .br
meillo@0 217 .lg 0
meillo@0 218 .nr PS +4
meillo@0 219 .nr VS +4
meillo@0 220 .ie ,\\$2,no, \{\
meillo@0 221 . SH
meillo@0 222 . ce 99
meillo@0 223 .if !,\\$3,no, .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZäÄöÖüÜ
meillo@0 224 \&\\$1
meillo@0 225 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzzääööüü
meillo@0 226 .\}
meillo@0 227 .el \{\
meillo@0 228 . NH 1
meillo@0 229 . ce 99
meillo@0 230 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZäÄöÖüÜ
meillo@0 231 . ie \\n(_A Appendix \\*(SN. \\$1
meillo@0 232 . el \\*(SN. \\$1
meillo@0 233 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzzääööüü
meillo@0 234 .\}
meillo@0 235 .br
meillo@0 236 .ce 0
meillo@0 237 .nr PS -4
meillo@0 238 .nr VS -4
meillo@0 239 .lg
meillo@0 240 .\" add to TOC
meillo@0 241 .rm t_
meillo@0 242 .if !,\\$2,no, .ds t_ \\Z'\\*(SN'\\h'3n'
meillo@10 243 .if !,\\$2,no, .T_ .5v 0 "\fB\\*(t_\\$1
meillo@0 244 .RT
meillo@0 245 .sp .5
meillo@0 246 .ns
meillo@0 247 .nr PP 0
meillo@0 248 ..
meillo@0 249
meillo@0 250
meillo@0 251 . \" H1 - Section ($2=="no" -> not numbered)
meillo@0 252 .de H1
meillo@0 253 .br
meillo@0 254 .ne 7
meillo@0 255 .sp
meillo@0 256 .lg 0
meillo@0 257 .nr PS +2
meillo@0 258 .nr VS +2
meillo@0 259 .ie '\\$2'no' .SH
meillo@0 260 .el .NH 2
meillo@0 261 .if !'\\$2'no' \&\\*(SN
meillo@0 262 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZäÄöÖüÜ
meillo@0 263 \&\\$1
meillo@0 264 .br
meillo@0 265 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzzääööüü
meillo@0 266 .nr PS -2
meillo@0 267 .nr VS -2
meillo@0 268 .lg
meillo@0 269 .if !'\\$2'no' .T_ .3v 1 "\\Z'\\*(SN'\\h'4n'\\$1 \" add to TOC
meillo@0 270 .RT
meillo@0 271 .nr PP 0
meillo@0 272 ..
meillo@0 273
meillo@0 274 . \" H2 - Subsection
meillo@0 275 .de H2
meillo@0 276 .br
meillo@0 277 .ne 4
meillo@0 278 .NH 3
meillo@0 279 \&\\*(SN \\$1
meillo@0 280 .T_ 0 2 "\\Z'\\*(SN'\\h'5.5n'\\$1 \" add to TOC
meillo@0 281 .RT
meillo@0 282 .nr PP 0
meillo@0 283 ..
meillo@0 284
meillo@0 285 . \" U1 - Section ($2=="yes" -> add to TOC)
meillo@0 286 .de U1
meillo@0 287 .sp .5
meillo@0 288 .ne 7
meillo@0 289 .lg 0
meillo@0 290 .nr PS +2
meillo@0 291 .nr VS +2
meillo@0 292 .ns
meillo@0 293 .SH
meillo@0 294 \&\\$1
meillo@0 295 .br
meillo@0 296 .nr PS -2
meillo@0 297 .nr VS -2
meillo@0 298 .lg
meillo@0 299 .T_ .3v 1 "\\$1 \" add to TOC
meillo@0 300 .RT
meillo@0 301 .nr PP 0
meillo@0 302 ..
meillo@0 303
meillo@0 304
meillo@0 305 . \" U2 - Subsection unnumbered ($2=="yes" -> add to TOC)
meillo@0 306 .de U2
meillo@0 307 .sp .5
meillo@0 308 .ne 4
meillo@0 309 .ns
meillo@0 310 .SH
meillo@0 311 \&\\$1
meillo@0 312 .if '\\$2'yes' .T_ 0 2 "\\Z'\\*(SN'\\h'5.5n'\\$1 \" add to TOC
meillo@0 313 .RT
meillo@0 314 .nr PP 0
meillo@0 315 ..
meillo@0 316
meillo@0 317 . \" U3 - Subsubsection unnumbered
meillo@0 318 .de U3
meillo@0 319 .br
meillo@0 320 .ne 4
meillo@0 321 .RT
meillo@0 322 .sp
meillo@0 323 .I "\\$1
meillo@0 324 .RT
meillo@0 325 .nr PP 0
meillo@0 326 ..
meillo@0 327
meillo@0 328 . \" P - Paragraph (indented unless following a heading)
meillo@0 329 .de P
meillo@0 330 .ie \\n(PP .PP
meillo@0 331 .el .LP
meillo@0 332 .nr PP 1
meillo@0 333 ..
meillo@0 334
meillo@0 335 .am LP
meillo@0 336 .nr PP 1
meillo@0 337 ..
meillo@0 338
meillo@0 339
meillo@0 340 . \" LI - Numbered paragraph ``list item'' ($1=label)
meillo@0 341 .de LI
meillo@0 342 .ie \\n(.$ .IP "\\h'\\n(PIu'\\$1." 2u*\\n(PIu
meillo@0 343 .el .IP "\\h'\\n(PIu'\\(bu" 2u*\\n(PIu
meillo@0 344 .nr PP 1
meillo@0 345 ..
meillo@0 346 .ig \" backup
meillo@0 347 .ie \\n(.$ .IP "\h'1n'\\$1"
meillo@0 348 .el .IP "\h'1.5n'\\(bu"
meillo@0 349 ..
meillo@0 350
meillo@0 351 . \" BU - Bulleted paragraph
meillo@0 352 .de BU
meillo@0 353 .LI
meillo@0 354 ..
meillo@0 355
meillo@0 356 . \" QS - Block quote start
meillo@0 357 .de QS
meillo@0 358 .ti \\n(.iu
meillo@0 359 .\"RT
meillo@0 360 .sp 2u*\\n(PDu
meillo@0 361 .ne 1.1
meillo@0 362 .ps -1
meillo@0 363 .vs -1
meillo@0 364 .in +\\n(QIu
meillo@0 365 .ll -\\n(QIu
meillo@0 366 .ti \\n(.iu
meillo@0 367 .\"if \\n(Qp .ti +\\n(PIu
meillo@0 368 .\"nr QP 1
meillo@0 369 .\"rr Qp
meillo@0 370 ..
meillo@0 371
meillo@0 372 . \" QP - Block quote paragraph
meillo@0 373 .de QP
meillo@0 374 .sp \n(PDu
meillo@0 375 .ne 1.1
meillo@0 376 .ti +\\n(PIu
meillo@0 377 ..
meillo@0 378
meillo@0 379 . \" QP - Block quote end
meillo@0 380 .de QE
meillo@0 381 .sp \\n(PDu
meillo@0 382 .in -\\n(QIu
meillo@0 383 .ll +\\n(QIu
meillo@0 384 .ti \\n(.iu
meillo@0 385 .ps +1
meillo@0 386 .vs +1
meillo@0 387 ..
meillo@0 388
meillo@0 389 . \" DS - Code display
meillo@0 390 .am DS
meillo@0 391 .ft CW
meillo@0 392 .ps -1
meillo@0 393 .ta T 8n
meillo@0 394 ..
meillo@0 395
meillo@0 396 . \" VS - verbatim text start (\\ -> ^G; ' -> disabled; . -> ^B)
meillo@0 397 .de VS
meillo@0 398 .br
meillo@0 399 .ne 3
meillo@0 400 .sp \n(DDu
meillo@0 401 .di _V
meillo@0 402 .nf
meillo@0 403 .ft CW
meillo@0 404 .ps -.5
meillo@0 405 .\" set up verbatim environment
meillo@0 406 \.blm
meillo@0 407 \.ec 
meillo@0 408 \.c2 ""
meillo@0 409 \.cc 
meillo@0 410 ..
meillo@0 411
meillo@0 412 . \" VE - verbatim text end (NOTE: Needs to be called as ^BVE !)
meillo@0 413 .de VE
meillo@0 414 \" restore the special characters
meillo@0 415 cc
meillo@0 416 .c2
meillo@0 417 .ec
meillo@0 418 .br
meillo@0 419 .di
meillo@0 420 .ne \\n(dnu+1v \" ensure enough space on the page
meillo@0 421 .in +2u*\\n(PIu
meillo@0 422 .ta T 8n
meillo@0 423 \.ec  \" set up verbatim environment, once again
meillo@0 424 \.c2 ""
meillo@0 425 \.cc 
meillo@0 426 _V \" output the verbatim content
meillo@0 427 \" restore the special characters
meillo@0 428 cc
meillo@0 429 .c2
meillo@0 430 .ec
meillo@0 431 .blm __
meillo@0 432 .in -2u*\\n(PIu
meillo@0 433 .sp \n(DDu
meillo@0 434 .ps +.5
meillo@0 435 .ft P
meillo@0 436 .fi
meillo@0 437 .TA
meillo@0 438 ..
meillo@0 439
meillo@0 440 . \" VF - verbatim text from file ($1=filename)
meillo@0 441 .de VF
meillo@0 442 .VS
meillo@0 443 so $1
meillo@0 444 VE
meillo@0 445 ..
meillo@0 446
meillo@0 447 .de Fn \" file name
meillo@0 448 .CW "\\$1" "\\$2
meillo@0 449 ..
meillo@0 450 .de Pn \" program name
meillo@0 451 .CW "\\$1" "\\$2
meillo@0 452 ..
meillo@0 453 .de Fu \" function
meillo@0 454 .CW "\\$1" "\\$2
meillo@0 455 ..
meillo@0 456 .de Ev \" env variable
meillo@0 457 .CW "\\$1" "\\$2
meillo@0 458 ..
meillo@0 459 .de Cl \" command line
meillo@0 460 `\c
meillo@0 461 .CW "\\$1" "'\\$2
meillo@0 462 ..
meillo@0 463 .de Sw \" switch
meillo@0 464 .CW "\\$1" "\\$2
meillo@0 465 ..
meillo@0 466 .de Ar \" argument
meillo@0 467 .CW "\f(CI\\$1" "\\$2
meillo@0 468 ..
meillo@0 469 .de Mp \" man page
meillo@0 470 .I "\\$1" "\\$2
meillo@0 471 ..
meillo@0 472 .de Pe \" profile entry
meillo@0 473 .CW "\\$1" "\\$2
meillo@0 474 ..
meillo@0 475 .de Hd \" mail header field
meillo@0 476 .CW "\\$1:\&" "\\$2
meillo@0 477 ..
meillo@0 478
meillo@0 479 .de Ci \" commit hash ref
meillo@0 480 .ds _t \\$1
meillo@0 481 .substring _t 0 6
meillo@0 482 [\(rh\|\fL\\*(_t\fP]\\$2
meillo@0 483 ..
meillo@0 484
meillo@0 485 . \" Cf - reference within the document ($1=name of ref file)
meillo@0 486 .de Cf
meillo@0 487 \.if !\\nZ .so refs/\\$1 \c
meillo@0 488 \\$2
meillo@0 489 ..
meillo@0 490
meillo@0 491 . \" Id - put a referenceable marker here ($1=identifier)
meillo@0 492 .de Id
meillo@0 493 .tm REF____\\$1\t\\*(SN\t\\n(PN
meillo@0 494 ..