docs/master

annotate 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
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@75 20 .ftr CW -\-
meillo@75 21 .ftr CI -\-
meillo@75 22 .ftr CB -\-
meillo@75 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@0 54 .de _M \" change margins for text block on next page
meillo@75 55 .if t .if o .nr PO +(21c-\n(.lu-(2u*3.3c))c
meillo@75 56 .if t .if e .nr PO -(21c-\n(.lu-(2u*3.3c))c
meillo@0 57 .ds CF "
meillo@0 58 ..
meillo@0 59 .wh -1u _M
meillo@0 60
meillo@0 61 .de CW
meillo@0 62 .nr PQ \\n(.f
meillo@0 63 .if t \{\
meillo@0 64 . ft CW
meillo@0 65 . if !^\\$1^^ \&\\$1\f\\n(PQ\\$2
meillo@0 66 .\}
meillo@0 67 .if n \{\
meillo@0 68 . ie ^\\$1^^ .ul 999
meillo@0 69 . el .ul 1
meillo@0 70 . if \\n(.$=1 \&\\$1
meillo@0 71 . if \\n(.$>1 \&\\$1\c
meillo@0 72 . if \\n(.$>1 \&\\$2
meillo@0 73 .\}
meillo@0 74 ..
meillo@0 75
meillo@35 76 .ds [. " [
meillo@0 77 .ds .] ]
meillo@0 78 .rm ]<
meillo@0 79 .de ]<
meillo@0 80 . LP
meillo@0 81 . de FP
meillo@0 82 . IP \\\\$1.
meillo@0 83 \\..
meillo@0 84 . rm FS FE
meillo@0 85 ..
meillo@0 86
meillo@0 87 .am PT
meillo@0 88 . rs
meillo@0 89 ..
meillo@0 90
meillo@79 91 .de T_ \" add entry to TOC: .T_ pre-space indent-level text
meillo@79 92 .tm TOC____.sp \\$1
meillo@79 93 .tm TOC____\&\\h'\\$2u*2u*\\n(PIu'\\$3\0\0\a\t\\n(PN\fR
meillo@79 94 ..
meillo@79 95
meillo@0 96 .rm NH
meillo@0 97 .de NH
meillo@0 98 .SH
meillo@0 99 .nr NS \\$1
meillo@0 100 .if !\\n(.$ .nr NS 1
meillo@0 101 .if !\\n(NS .nr NS 1
meillo@0 102 .nr H\\n(NS +1
meillo@6 103 .if \\n(NS<2 .nr H2 0
meillo@6 104 .if \\n(NS<3 .nr H3 0
meillo@0 105 .ds SN \\n(H1
meillo@6 106 .if \\n(NS>1 .as SN \&.\\n(H2
meillo@6 107 .if \\n(NS>2 .as SN \&.\\n(H3
meillo@0 108 ..
meillo@0 109
meillo@40 110 .de H-
meillo@29 111 .EH "
meillo@29 112 .OH "
meillo@29 113 .bp
meillo@44 114 .rs
meillo@29 115 .if e .bp
meillo@29 116 .lg 0
meillo@29 117 .nr PS +6
meillo@29 118 .nr VS +6
meillo@29 119 .SH
meillo@29 120 .ce 1
meillo@29 121 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
meillo@29 122 \&\\$1
meillo@29 123 .br
meillo@29 124 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
meillo@29 125 .nr PS -6
meillo@29 126 .nr VS -6
meillo@29 127 .lg
meillo@29 128 .RT
meillo@40 129 .if !,\\$2,no, \{
meillo@40 130 . EH "\\\\*(_E
meillo@40 131 . ie \\n(H1 .OH "\\\\*(_O
meillo@40 132 . el .OH "\\\\*(_o
meillo@40 133 . ds CF \\n(PN
meillo@40 134 .\}
meillo@29 135 .sp 4
meillo@29 136 .nr PP 0
meillo@29 137 ..
meillo@29 138
meillo@0 139 .de H0
meillo@0 140 .EH "
meillo@0 141 .OH "
meillo@0 142 .bp
meillo@44 143 .rs
meillo@0 144 .if e .bp
meillo@0 145 . lg 0
meillo@0 146 . nr PS +6
meillo@0 147 . nr VS +6
meillo@35 148 .ie \\n(.$=1 \{\
meillo@0 149 . NH 1
meillo@0 150 . ce 1
meillo@0 151 Chapter \\*(SN
meillo@0 152 . sp .5
meillo@0 153 .\}
meillo@35 154 .el .if ,\\$2,no, .SH
meillo@0 155 . ce 1
meillo@0 156 . tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
meillo@0 157 \&\\$1
meillo@0 158 . br
meillo@0 159 . tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
meillo@0 160 . nr PS -6
meillo@0 161 . nr VS -6
meillo@0 162 . lg
meillo@0 163 .ds _C "\\$1
meillo@0 164 . RT
meillo@79 165 .rm t_
meillo@79 166 .if !,\\$2,no, .ds t_ \\*(SN\0\0
meillo@79 167 .T_ .5v 0 "\fB\\*(t_\\$1
meillo@29 168 .EH "\\\\*(_E
meillo@29 169 .ie \\n(H1 .OH "\\\\*(_O
meillo@29 170 .el .OH "\\\\*(_o
meillo@29 171 .ds CF \\n(PN
meillo@0 172 .sp 4
meillo@0 173 .nr PP 0
meillo@0 174 ..
meillo@0 175
meillo@39 176
meillo@39 177 .\" Reset page Numbers, set page number format ($1) and move to a right page.
meillo@39 178 .de RN
meillo@39 179 .ie e .pn 1
meillo@39 180 .el \{
meillo@39 181 . pn 0
meillo@39 182 . bp
meillo@39 183 .\}
meillo@39 184 .ie \\n(.$=1 .af PN \\$1
meillo@39 185 .el .af PN 1
meillo@39 186 ..
meillo@39 187
meillo@39 188
meillo@0 189 .de H1
meillo@0 190 .br
meillo@0 191 .ne 7
meillo@1 192 .sp
meillo@0 193 . nr PS +2
meillo@0 194 . nr VS +2
meillo@6 195 .if '\\$2'no' .SH
meillo@6 196 .if \\n(.$=1 .NH 2
meillo@0 197 . lg 0
meillo@0 198 . tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
meillo@6 199 .if !'\\$2'no' \&\\*(SN
meillo@6 200 \\$1
meillo@0 201 . br
meillo@0 202 . tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
meillo@0 203 . nr PS -2
meillo@0 204 . nr VS -2
meillo@0 205 . lg
meillo@0 206 . RT
meillo@6 207 .if !'\\$2'no' \{\
meillo@79 208 . ds _S "\\$1
meillo@79 209 . T_ .3v 1 "\\*(SN\0\0\\$1
meillo@6 210 .\}
meillo@6 211 .nr PP 0
meillo@6 212 ..
meillo@6 213
meillo@6 214 .de H2
meillo@6 215 .br
meillo@7 216 .ne 4
meillo@59 217 .NH 3
meillo@11 218 \&\\*(SN
meillo@6 219 \\$1
meillo@11 220 .RT
meillo@6 221 .ds _S "\\$1
meillo@79 222 .T_ 0 2 "\\*(SN\0\0\\$1
meillo@11 223 .nr PP 0
meillo@11 224 ..
meillo@11 225
meillo@11 226 .de U2
meillo@11 227 .br
meillo@11 228 .ne 4
meillo@11 229 .SH
meillo@11 230 \\$1
meillo@11 231 .RT
meillo@0 232 .nr PP 0
meillo@0 233 ..
meillo@0 234
meillo@73 235 .de U3
meillo@73 236 .br
meillo@73 237 .ne 4
meillo@73 238 .RT
meillo@73 239 .sp
meillo@73 240 .I "\\$1
meillo@73 241 .RT
meillo@73 242 .nr PP 0
meillo@73 243 ..
meillo@73 244
meillo@0 245 .de P
meillo@0 246 .ie \\n(PP .PP
meillo@0 247 .el .LP
meillo@0 248 .nr PP 1
meillo@0 249 ..
meillo@0 250
meillo@0 251 .am IP
meillo@0 252 .nr PP 0
meillo@0 253 ..
meillo@0 254
meillo@6 255 .de BU
meillo@6 256 .IP \(bu
meillo@6 257 ..
meillo@6 258
meillo@0 259 .am QP
meillo@0 260 .ps -1
meillo@0 261 ..
meillo@0 262
meillo@0 263 .am DS
meillo@0 264 .ft CW
meillo@0 265 .ps -1
meillo@0 266 .ta T 8n
meillo@0 267 ..
meillo@0 268
meillo@0 269 .am FA
meillo@0 270 .ps 8
meillo@0 271 .vs 9
meillo@0 272 ..
meillo@18 273
meillo@18 274 .de Fn \" file name
meillo@18 275 .CW "\\$1" "\\$2
meillo@18 276 ..
meillo@18 277 .de Pn \" program name
meillo@18 278 .CW "\\$1" "\\$2
meillo@18 279 ..
meillo@18 280 .de Fu \" function
meillo@18 281 .CW "\\$1" "\\$2
meillo@18 282 ..
meillo@19 283 .de Ev \" env variable
meillo@19 284 .CW "\\$1" "\\$2
meillo@19 285 ..
meillo@18 286 .de Cl \" command line
meillo@18 287 `\c
meillo@18 288 .CW "\\$1" "'\\$2
meillo@18 289 ..
meillo@18 290 .de Sw \" switch
meillo@18 291 .CW "\\$1" "\\$2
meillo@18 292 ..
meillo@18 293 .de Mp \" man page
meillo@18 294 .I "\\$1" "\\$2
meillo@18 295 ..
meillo@18 296 .de Pe \" profile entry
meillo@18 297 .CW "\\$1" "\\$2
meillo@18 298 ..
meillo@67 299
meillo@67 300 .de Ci \" commit ref
meillo@70 301 .ds _t \\$1
meillo@70 302 .substring _t 0 6
meillo@67 303 [\(rh
meillo@70 304 .CW "\\*(_t" "]\\$2
meillo@67 305 ..
meillo@77 306
meillo@77 307 .de Cf \" cf. (ref within document)
meillo@77 308 (\(-> \\$1)\\$2
meillo@77 309 ..