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