docs/master
annotate style @ 91:87bc954b9e6a
style: Let's have an own version of the QP macro. It indents paragraphs.
author | markus schnalke <meillo@marmaro.de> |
---|---|
date | Fri, 15 Jun 2012 17:14:06 +0200 |
parents | 106fd9f80dd8 |
children | d894191d7a33 |
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 .fp 1 R LinLibertine_R otf |
meillo@0 | 9 .feature R +onum |
meillo@0 | 10 .fp 2 I LinLibertine_RI otf |
meillo@0 | 11 .feature I +onum |
meillo@0 | 12 .fp 3 B LinLibertine_RB otf |
meillo@0 | 13 .feature B +onum |
meillo@0 | 14 .fp 4 BI LinLibertine_RBI otf |
meillo@0 | 15 .feature BI +onum |
meillo@0 | 16 .fp 5 CW TerminusMedium-4.36 ttf |
meillo@0 | 17 .fp 0 CI TerminusMediumItalic-4.36 ttf |
meillo@0 | 18 .fp 0 CB TerminusBold-4.36 ttf |
meillo@0 | 19 .fp 0 L TerminusMedium-4.36 ttf |
meillo@82 | 20 .ftr CW -\-`\`'\' |
meillo@82 | 21 .ftr CI -\-`\`'\' |
meillo@82 | 22 .ftr CB -\-`\`'\' |
meillo@82 | 23 .ftr L -\-`\`'\' |
meillo@15 | 24 .fp 0 SC LinLibertine_R otf |
meillo@15 | 25 .feature SC +onum +smcp |
meillo@15 | 26 .fp 0 IC LinLibertine_RI otf |
meillo@15 | 27 .feature IC +onum +smcp |
meillo@0 | 28 .fp 0 BC LinLibertine_RB otf |
meillo@0 | 29 .feature BC +onum +smcp |
meillo@0 | 30 |
meillo@0 | 31 .ig |
meillo@75 | 32 . nr PS 11 |
meillo@75 | 33 . nr VS 13 |
meillo@75 | 34 . padj |
meillo@0 | 35 .. |
meillo@0 | 36 |
meillo@0 | 37 .nr PI 3n |
meillo@41 | 38 .nr PD .3v |
meillo@91 | 39 .nr QI 6n |
meillo@0 | 40 .nr lu 0 |
meillo@0 | 41 .af PN i |
meillo@0 | 42 |
meillo@15 | 43 .ds _E '\\\\n(PN''\f(SCMarkus Schnalke: The Modern Mail Handler\fP' \" left |
meillo@15 | 44 .ds _O '\f(SCChapter \\\\n(H1\ \ \\\\*(_C\fP''\\\\n(PN' \" right |
meillo@29 | 45 .ds _o '\f(SC\\\\*(_C\fP''\\\\n(PN' \" right |
meillo@0 | 46 .ds CH " |
meillo@0 | 47 |
meillo@0 | 48 .nr HM 3.3c |
meillo@0 | 49 .nr FM 6.6c |
meillo@75 | 50 .nr LL 13c |
meillo@75 | 51 .ll 13c |
meillo@0 | 52 .nr LT \n(LL |
meillo@75 | 53 .if t .nr PO 3.3c |
meillo@0 | 54 |
meillo@81 | 55 . \" _M - change margins for text block on next page |
meillo@81 | 56 .de _M |
meillo@75 | 57 .if t .if o .nr PO +(21c-\n(.lu-(2u*3.3c))c |
meillo@75 | 58 .if t .if e .nr PO -(21c-\n(.lu-(2u*3.3c))c |
meillo@0 | 59 .ds CF " |
meillo@0 | 60 .. |
meillo@0 | 61 .wh -1u _M |
meillo@0 | 62 |
meillo@90 | 63 . \" Lp - enlarge the current page by one line to avoid widows |
meillo@90 | 64 .de Lp |
meillo@90 | 65 .ch FO -\n(FMu+1v |
meillo@90 | 66 .. |
meillo@90 | 67 |
meillo@81 | 68 . \" CW - Set text in CW font (similar to .B and .I) |
meillo@0 | 69 .de CW |
meillo@0 | 70 .nr PQ \\n(.f |
meillo@0 | 71 .if t \{\ |
meillo@0 | 72 . ft CW |
meillo@0 | 73 . if !^\\$1^^ \&\\$1\f\\n(PQ\\$2 |
meillo@0 | 74 .\} |
meillo@0 | 75 .if n \{\ |
meillo@0 | 76 . ie ^\\$1^^ .ul 999 |
meillo@0 | 77 . el .ul 1 |
meillo@0 | 78 . if \\n(.$=1 \&\\$1 |
meillo@0 | 79 . if \\n(.$>1 \&\\$1\c |
meillo@0 | 80 . if \\n(.$>1 \&\\$2 |
meillo@0 | 81 .\} |
meillo@0 | 82 .. |
meillo@0 | 83 |
meillo@81 | 84 . \" refer(1) stuff |
meillo@35 | 85 .ds [. " [ |
meillo@0 | 86 .ds .] ] |
meillo@0 | 87 .rm ]< |
meillo@0 | 88 .de ]< |
meillo@0 | 89 . LP |
meillo@0 | 90 . de FP |
meillo@0 | 91 . IP \\\\$1. |
meillo@0 | 92 \\.. |
meillo@0 | 93 . rm FS FE |
meillo@0 | 94 .. |
meillo@0 | 95 |
meillo@81 | 96 . \" PT - page top macro of ms |
meillo@0 | 97 .am PT |
meillo@0 | 98 . rs |
meillo@0 | 99 .. |
meillo@0 | 100 |
meillo@81 | 101 |
meillo@81 | 102 . \" RN - Reset PN and continue on an odd page ($1=number-format) |
meillo@81 | 103 .de RN |
meillo@81 | 104 .ie e .pn 1 |
meillo@81 | 105 .el \{ |
meillo@81 | 106 . pn 0 |
meillo@81 | 107 . bp |
meillo@81 | 108 .\} |
meillo@81 | 109 .ie \\n(.$=1 .af PN \\$1 |
meillo@81 | 110 .el .af PN 1 |
meillo@81 | 111 .. |
meillo@81 | 112 |
meillo@81 | 113 |
meillo@81 | 114 . \" T_ - Add TOC entry ($1=pre-space $2=indent-level $3=text) |
meillo@81 | 115 .de T_ |
meillo@79 | 116 .tm TOC____.sp \\$1 |
meillo@79 | 117 .tm TOC____\&\\h'\\$2u*2u*\\n(PIu'\\$3\0\0\a\t\\n(PN\fR |
meillo@79 | 118 .. |
meillo@79 | 119 |
meillo@81 | 120 . \" NH - redefine numbered heading |
meillo@0 | 121 .de NH |
meillo@0 | 122 .SH |
meillo@0 | 123 .nr NS \\$1 |
meillo@0 | 124 .if !\\n(.$ .nr NS 1 |
meillo@0 | 125 .if !\\n(NS .nr NS 1 |
meillo@0 | 126 .nr H\\n(NS +1 |
meillo@6 | 127 .if \\n(NS<2 .nr H2 0 |
meillo@6 | 128 .if \\n(NS<3 .nr H3 0 |
meillo@0 | 129 .ds SN \\n(H1 |
meillo@6 | 130 .if \\n(NS>1 .as SN \&.\\n(H2 |
meillo@6 | 131 .if \\n(NS>2 .as SN \&.\\n(H3 |
meillo@0 | 132 .. |
meillo@0 | 133 |
meillo@81 | 134 . \" H- - Chapter unnumbered and not in TOC ($2=="no" -> no page hdrs) |
meillo@40 | 135 .de H- |
meillo@29 | 136 .EH " |
meillo@29 | 137 .OH " |
meillo@29 | 138 .bp |
meillo@81 | 139 .if e .rs \" move to an odd page |
meillo@29 | 140 .if e .bp |
meillo@29 | 141 .lg 0 |
meillo@29 | 142 .nr PS +6 |
meillo@29 | 143 .nr VS +6 |
meillo@29 | 144 .SH |
meillo@29 | 145 .ce 1 |
meillo@29 | 146 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
meillo@29 | 147 \&\\$1 |
meillo@29 | 148 .br |
meillo@29 | 149 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
meillo@29 | 150 .nr PS -6 |
meillo@29 | 151 .nr VS -6 |
meillo@29 | 152 .lg |
meillo@40 | 153 .if !,\\$2,no, \{ |
meillo@40 | 154 . EH "\\\\*(_E |
meillo@40 | 155 . ie \\n(H1 .OH "\\\\*(_O |
meillo@40 | 156 . el .OH "\\\\*(_o |
meillo@40 | 157 . ds CF \\n(PN |
meillo@40 | 158 .\} |
meillo@81 | 159 .RT |
meillo@29 | 160 .sp 4 |
meillo@29 | 161 .nr PP 0 |
meillo@29 | 162 .. |
meillo@29 | 163 |
meillo@81 | 164 . \" H0 - Chapter ($2=="no" -> not numbered) |
meillo@0 | 165 .de H0 |
meillo@0 | 166 .EH " |
meillo@0 | 167 .OH " |
meillo@0 | 168 .bp |
meillo@81 | 169 .if e .rs \" begin chapter on an odd page |
meillo@0 | 170 .if e .bp |
meillo@81 | 171 .lg 0 |
meillo@81 | 172 .nr PS +6 |
meillo@81 | 173 .nr VS +6 |
meillo@81 | 174 .ie ,\\$2,no, .SH |
meillo@81 | 175 .el \{\ |
meillo@0 | 176 . NH 1 |
meillo@0 | 177 . ce 1 |
meillo@0 | 178 Chapter \\*(SN |
meillo@0 | 179 . sp .5 |
meillo@0 | 180 .\} |
meillo@81 | 181 .ce 1 |
meillo@81 | 182 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
meillo@0 | 183 \&\\$1 |
meillo@81 | 184 .br |
meillo@81 | 185 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
meillo@81 | 186 .nr PS -6 |
meillo@81 | 187 .nr VS -6 |
meillo@81 | 188 .lg |
meillo@81 | 189 .\" add to TOC |
meillo@79 | 190 .rm t_ |
meillo@79 | 191 .if !,\\$2,no, .ds t_ \\*(SN\0\0 |
meillo@79 | 192 .T_ .5v 0 "\fB\\*(t_\\$1 |
meillo@81 | 193 .\" set page headers and footers |
meillo@29 | 194 .EH "\\\\*(_E |
meillo@81 | 195 .ds _C "\\$1 |
meillo@29 | 196 .ie \\n(H1 .OH "\\\\*(_O |
meillo@29 | 197 .el .OH "\\\\*(_o |
meillo@29 | 198 .ds CF \\n(PN |
meillo@81 | 199 .RT |
meillo@0 | 200 .sp 4 |
meillo@0 | 201 .nr PP 0 |
meillo@0 | 202 .. |
meillo@0 | 203 |
meillo@39 | 204 |
meillo@81 | 205 . \" H1 - Section ($2=="no" -> not numbered) |
meillo@0 | 206 .de H1 |
meillo@0 | 207 .br |
meillo@0 | 208 .ne 7 |
meillo@1 | 209 .sp |
meillo@81 | 210 .lg 0 |
meillo@81 | 211 .nr PS +2 |
meillo@81 | 212 .nr VS +2 |
meillo@81 | 213 .ie '\\$2'no' .SH |
meillo@81 | 214 .el .NH 2 |
meillo@6 | 215 .if !'\\$2'no' \&\\*(SN |
meillo@81 | 216 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ |
meillo@81 | 217 \&\\$1 |
meillo@81 | 218 .br |
meillo@81 | 219 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz |
meillo@81 | 220 .nr PS -2 |
meillo@81 | 221 .nr VS -2 |
meillo@81 | 222 .lg |
meillo@81 | 223 .if !'\\$2'no' .T_ .3v 1 "\\*(SN\0\0\\$1 \" add to TOC |
meillo@81 | 224 .RT |
meillo@6 | 225 .nr PP 0 |
meillo@6 | 226 .. |
meillo@6 | 227 |
meillo@81 | 228 . \" H2 - Subsection |
meillo@6 | 229 .de H2 |
meillo@6 | 230 .br |
meillo@7 | 231 .ne 4 |
meillo@59 | 232 .NH 3 |
meillo@81 | 233 \&\\*(SN \\$1 |
meillo@81 | 234 .T_ 0 2 "\\*(SN\0\0\\$1 \" add to TOC |
meillo@11 | 235 .RT |
meillo@11 | 236 .nr PP 0 |
meillo@11 | 237 .. |
meillo@11 | 238 |
meillo@81 | 239 . \" U2 - Subsection unnumbered |
meillo@11 | 240 .de U2 |
meillo@11 | 241 .br |
meillo@11 | 242 .ne 4 |
meillo@11 | 243 .SH |
meillo@81 | 244 \&\\$1 |
meillo@11 | 245 .RT |
meillo@0 | 246 .nr PP 0 |
meillo@0 | 247 .. |
meillo@0 | 248 |
meillo@81 | 249 . \" U3 - Subsubsection unnumbered |
meillo@73 | 250 .de U3 |
meillo@73 | 251 .br |
meillo@73 | 252 .ne 4 |
meillo@73 | 253 .RT |
meillo@73 | 254 .sp |
meillo@73 | 255 .I "\\$1 |
meillo@73 | 256 .RT |
meillo@73 | 257 .nr PP 0 |
meillo@73 | 258 .. |
meillo@73 | 259 |
meillo@81 | 260 . \" P - Paragraph (indented unless following a heading) |
meillo@0 | 261 .de P |
meillo@0 | 262 .ie \\n(PP .PP |
meillo@0 | 263 .el .LP |
meillo@0 | 264 .nr PP 1 |
meillo@0 | 265 .. |
meillo@0 | 266 |
meillo@81 | 267 . \" IP - Paragraph with hanging label |
meillo@0 | 268 .am IP |
meillo@0 | 269 .nr PP 0 |
meillo@0 | 270 .. |
meillo@0 | 271 |
meillo@81 | 272 . \" BU - Bulleted paragraph |
meillo@6 | 273 .de BU |
meillo@6 | 274 .IP \(bu |
meillo@6 | 275 .. |
meillo@6 | 276 |
meillo@81 | 277 . \" QP - Block quote paragraph |
meillo@91 | 278 .de QP |
meillo@91 | 279 .ti \\n(.iu |
meillo@91 | 280 .if \\n(QP .nr Qp 1 |
meillo@91 | 281 .RT |
meillo@91 | 282 .sp \\n(PDu |
meillo@91 | 283 .ne 1.1 |
meillo@0 | 284 .ps -1 |
meillo@91 | 285 .in +\\n(QIu |
meillo@91 | 286 .ll -\\n(QIu |
meillo@91 | 287 .ti \\n(.iu |
meillo@91 | 288 .if \\n(Qp .ti +\\n(PIu |
meillo@91 | 289 .if \\n(TM .ls 1 |
meillo@91 | 290 .nr QP 1 |
meillo@91 | 291 .rr Qp |
meillo@0 | 292 .. |
meillo@0 | 293 |
meillo@81 | 294 . \" DS - Code display |
meillo@0 | 295 .am DS |
meillo@0 | 296 .ft CW |
meillo@0 | 297 .ps -1 |
meillo@0 | 298 .ta T 8n |
meillo@0 | 299 .. |
meillo@0 | 300 |
meillo@82 | 301 . \" VS - verbatim text start (\\ -> ^G; ' -> disabled; . -> ^B) |
meillo@82 | 302 .de VS |
meillo@82 | 303 .br |
meillo@82 | 304 .ne 4 |
meillo@82 | 305 .sp \n(DDu |
meillo@82 | 306 .if t .in +.5i |
meillo@82 | 307 .if n .in +8n |
meillo@82 | 308 .nf |
meillo@82 | 309 .ft CW |
meillo@82 | 310 .\" ps -1 |
meillo@82 | 311 .ta T 8n |
meillo@82 | 312 .\" set up verbatim environment |
meillo@82 | 313 \.blm |
meillo@82 | 314 \.ec |
meillo@82 | 315 \.c2 "" |
meillo@82 | 316 \.cc |
meillo@82 | 317 .. |
meillo@82 | 318 |
meillo@82 | 319 . \" VE - verbatim text end (NOTE: Needs to be called as ^BVE !) |
meillo@82 | 320 .de VE |
meillo@82 | 321 \" restore the special characters |
meillo@82 | 322 cc |
meillo@82 | 323 .c2 |
meillo@82 | 324 .ec |
meillo@82 | 325 .blm __ |
meillo@82 | 326 .if t .in -.5i |
meillo@82 | 327 .if n .in -8n |
meillo@82 | 328 .sp \n(DDu |
meillo@82 | 329 .ft P |
meillo@82 | 330 .fi |
meillo@82 | 331 .TA |
meillo@82 | 332 .. |
meillo@82 | 333 |
meillo@83 | 334 . \" VF - verbatim text from file ($1=filename) |
meillo@83 | 335 .de VF |
meillo@83 | 336 .VS |
meillo@83 | 337 so $1 |
meillo@83 | 338 VE |
meillo@83 | 339 .. |
meillo@83 | 340 |
meillo@81 | 341 . \" FA - XXX somehow related to footnotes? |
meillo@0 | 342 .am FA |
meillo@0 | 343 .ps 8 |
meillo@0 | 344 .vs 9 |
meillo@0 | 345 .. |
meillo@18 | 346 |
meillo@18 | 347 .de Fn \" file name |
meillo@18 | 348 .CW "\\$1" "\\$2 |
meillo@18 | 349 .. |
meillo@18 | 350 .de Pn \" program name |
meillo@18 | 351 .CW "\\$1" "\\$2 |
meillo@18 | 352 .. |
meillo@18 | 353 .de Fu \" function |
meillo@18 | 354 .CW "\\$1" "\\$2 |
meillo@18 | 355 .. |
meillo@19 | 356 .de Ev \" env variable |
meillo@19 | 357 .CW "\\$1" "\\$2 |
meillo@19 | 358 .. |
meillo@18 | 359 .de Cl \" command line |
meillo@18 | 360 `\c |
meillo@18 | 361 .CW "\\$1" "'\\$2 |
meillo@18 | 362 .. |
meillo@18 | 363 .de Sw \" switch |
meillo@18 | 364 .CW "\\$1" "\\$2 |
meillo@18 | 365 .. |
meillo@84 | 366 .de Ar \" argument |
meillo@84 | 367 .CW "\f(CI\\$1" "\\$2 |
meillo@84 | 368 .. |
meillo@18 | 369 .de Mp \" man page |
meillo@18 | 370 .I "\\$1" "\\$2 |
meillo@18 | 371 .. |
meillo@18 | 372 .de Pe \" profile entry |
meillo@18 | 373 .CW "\\$1" "\\$2 |
meillo@18 | 374 .. |
meillo@84 | 375 .de Hd \" mail header field |
meillo@84 | 376 .CW "\\$1:\&" "\\$2 |
meillo@84 | 377 .. |
meillo@67 | 378 |
meillo@81 | 379 .de Ci \" commit hash ref |
meillo@70 | 380 .ds _t \\$1 |
meillo@70 | 381 .substring _t 0 6 |
meillo@67 | 382 [\(rh |
meillo@70 | 383 .CW "\\*(_t" "]\\$2 |
meillo@67 | 384 .. |
meillo@77 | 385 |
meillo@77 | 386 .de Cf \" cf. (ref within document) |
meillo@77 | 387 (\(-> \\$1)\\$2 |
meillo@77 | 388 .. |