/ H4CK3R 14 / hacker14.iso / programacao / pythonwin / python.exe / PYTHON23.CHM / doc / module-markup.html

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 3c 21 44 4f 43 54 59 50 | 45 20 68 74 6d 6c 20 50 |<!DOCTYP|E html P|
|00000010| 55 42 4c 49 43 20 22 2d | 2f 2f 57 33 43 2f 2f 44 |UBLIC "-|//W3C//D|
|00000020| 54 44 20 48 54 4d 4c 20 | 34 2e 30 20 54 72 61 6e |TD HTML |4.0 Tran|
|00000030| 73 69 74 69 6f 6e 61 6c | 2f 2f 45 4e 22 3e 0a 3c |sitional|//EN">.<|
|00000040| 68 74 6d 6c 3e 0a 3c 68 | 65 61 64 3e 0a 3c 6c 69 |html>.<h|ead>.<li|
|00000050| 6e 6b 20 72 65 6c 3d 22 | 53 54 59 4c 45 53 48 45 |nk rel="|STYLESHE|
|00000060| 45 54 22 20 68 72 65 66 | 3d 22 64 6f 63 2e 63 73 |ET" href|="doc.cs|
|00000070| 73 22 20 74 79 70 65 3d | 27 74 65 78 74 2f 63 73 |s" type=|'text/cs|
|00000080| 73 27 3e 0a 3c 6c 69 6e | 6b 20 72 65 6c 3d 22 53 |s'>.<lin|k rel="S|
|00000090| 48 4f 52 54 43 55 54 20 | 49 43 4f 4e 22 20 68 72 |HORTCUT |ICON" hr|
|000000a0| 65 66 3d 22 2e 2e 2f 69 | 63 6f 6e 73 2f 70 79 66 |ef="../i|cons/pyf|
|000000b0| 61 76 2e 67 69 66 22 3e | 0a 3c 6c 69 6e 6b 20 72 |av.gif">|.<link r|
|000000c0| 65 6c 3d 27 73 74 61 72 | 74 27 20 68 72 65 66 3d |el='star|t' href=|
|000000d0| 27 2e 2e 2f 69 6e 64 65 | 78 2e 68 74 6d 6c 27 20 |'../inde|x.html' |
|000000e0| 74 69 74 6c 65 3d 27 50 | 79 74 68 6f 6e 20 44 6f |title='P|ython Do|
|000000f0| 63 75 6d 65 6e 74 61 74 | 69 6f 6e 20 49 6e 64 65 |cumentat|ion Inde|
|00000100| 78 27 3e 0a 3c 6c 69 6e | 6b 20 72 65 6c 3d 22 66 |x'>.<lin|k rel="f|
|00000110| 69 72 73 74 22 20 68 72 | 65 66 3d 22 64 6f 63 2e |irst" hr|ef="doc.|
|00000120| 68 74 6d 6c 22 20 74 69 | 74 6c 65 3d 27 44 6f 63 |html" ti|tle='Doc|
|00000130| 75 6d 65 6e 74 69 6e 67 | 20 50 79 74 68 6f 6e 27 |umenting| Python'|
|00000140| 3e 0a 3c 6c 69 6e 6b 20 | 72 65 6c 3d 27 63 6f 6e |>.<link |rel='con|
|00000150| 74 65 6e 74 73 27 20 68 | 72 65 66 3d 27 63 6f 6e |tents' h|ref='con|
|00000160| 74 65 6e 74 73 2e 68 74 | 6d 6c 27 20 74 69 74 6c |tents.ht|ml' titl|
|00000170| 65 3d 22 43 6f 6e 74 65 | 6e 74 73 22 3e 0a 3c 6c |e="Conte|nts">.<l|
|00000180| 69 6e 6b 20 72 65 6c 3d | 27 6c 61 73 74 27 20 68 |ink rel=|'last' h|
|00000190| 72 65 66 3d 27 61 62 6f | 75 74 2e 68 74 6d 6c 27 |ref='abo|ut.html'|
|000001a0| 20 74 69 74 6c 65 3d 27 | 41 62 6f 75 74 20 74 68 | title='|About th|
|000001b0| 69 73 20 64 6f 63 75 6d | 65 6e 74 2e 2e 2e 27 3e |is docum|ent...'>|
|000001c0| 0a 3c 6c 69 6e 6b 20 72 | 65 6c 3d 27 68 65 6c 70 |.<link r|el='help|
|000001d0| 27 20 68 72 65 66 3d 27 | 61 62 6f 75 74 2e 68 74 |' href='|about.ht|
|000001e0| 6d 6c 27 20 74 69 74 6c | 65 3d 27 41 62 6f 75 74 |ml' titl|e='About|
|000001f0| 20 74 68 69 73 20 64 6f | 63 75 6d 65 6e 74 2e 2e | this do|cument..|
|00000200| 2e 27 3e 0a 3c 4c 49 4e | 4b 20 52 45 4c 3d 22 6e |.'>.<LIN|K REL="n|
|00000210| 65 78 74 22 20 68 72 65 | 66 3d 22 6c 69 62 72 61 |ext" hre|f="libra|
|00000220| 72 79 2d 6d 61 72 6b 75 | 70 2e 68 74 6d 6c 22 3e |ry-marku|p.html">|
|00000230| 0a 3c 4c 49 4e 4b 20 52 | 45 4c 3d 22 70 72 65 76 |.<LINK R|EL="prev|
|00000240| 22 20 68 72 65 66 3d 22 | 6d 69 73 63 2d 74 65 78 |" href="|misc-tex|
|00000250| 74 2d 6d 61 72 6b 75 70 | 2e 68 74 6d 6c 22 3e 0a |t-markup|.html">.|
|00000260| 3c 4c 49 4e 4b 20 52 45 | 4c 3d 22 70 61 72 65 6e |<LINK RE|L="paren|
|00000270| 74 22 20 68 72 65 66 3d | 22 73 70 65 63 69 61 6c |t" href=|"special|
|00000280| 2d 63 6f 6e 73 74 72 75 | 63 74 73 2e 68 74 6d 6c |-constru|cts.html|
|00000290| 22 3e 0a 3c 4c 49 4e 4b | 20 52 45 4c 3d 22 6e 65 |">.<LINK| REL="ne|
|000002a0| 78 74 22 20 68 72 65 66 | 3d 22 6c 69 62 72 61 72 |xt" href|="librar|
|000002b0| 79 2d 6d 61 72 6b 75 70 | 2e 68 74 6d 6c 22 3e 0a |y-markup|.html">.|
|000002c0| 3c 6d 65 74 61 20 68 74 | 74 70 2d 65 71 75 69 76 |<meta ht|tp-equiv|
|000002d0| 3d 22 43 6f 6e 74 65 6e | 74 2d 54 79 70 65 22 20 |="Conten|t-Type" |
|000002e0| 63 6f 6e 74 65 6e 74 3d | 22 74 65 78 74 2f 68 74 |content=|"text/ht|
|000002f0| 6d 6c 3b 20 63 68 61 72 | 73 65 74 3d 69 73 6f 2d |ml; char|set=iso-|
|00000300| 38 38 35 39 2d 31 22 3e | 0a 3c 6d 65 74 61 20 6e |8859-1">|.<meta n|
|00000310| 61 6d 65 3d 27 61 65 73 | 6f 70 27 20 63 6f 6e 74 |ame='aes|op' cont|
|00000320| 65 6e 74 3d 27 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |ent='inf|ormation|
|00000330| 27 3e 0a 3c 4d 45 54 41 | 20 4e 41 4d 45 3d 22 64 |'>.<META| NAME="d|
|00000340| 65 73 63 72 69 70 74 69 | 6f 6e 22 20 43 4f 4e 54 |escripti|on" CONT|
|00000350| 45 4e 54 3d 22 4d 6f 64 | 75 6c 65 2d 73 70 65 63 |ENT="Mod|ule-spec|
|00000360| 69 66 69 63 20 4d 61 72 | 6b 75 70 20 22 3e 0a 3c |ific Mar|kup ">.<|
|00000370| 4d 45 54 41 20 4e 41 4d | 45 3d 22 6b 65 79 77 6f |META NAM|E="keywo|
|00000380| 72 64 73 22 20 43 4f 4e | 54 45 4e 54 3d 22 64 6f |rds" CON|TENT="do|
|00000390| 63 22 3e 0a 3c 4d 45 54 | 41 20 4e 41 4d 45 3d 22 |c">.<MET|A NAME="|
|000003a0| 72 65 73 6f 75 72 63 65 | 2d 74 79 70 65 22 20 43 |resource|-type" C|
|000003b0| 4f 4e 54 45 4e 54 3d 22 | 64 6f 63 75 6d 65 6e 74 |ONTENT="|document|
|000003c0| 22 3e 0a 3c 4d 45 54 41 | 20 4e 41 4d 45 3d 22 64 |">.<META| NAME="d|
|000003d0| 69 73 74 72 69 62 75 74 | 69 6f 6e 22 20 43 4f 4e |istribut|ion" CON|
|000003e0| 54 45 4e 54 3d 22 67 6c | 6f 62 61 6c 22 3e 0a 3c |TENT="gl|obal">.<|
|000003f0| 74 69 74 6c 65 3e 36 2e | 37 20 4d 6f 64 75 6c 65 |title>6.|7 Module|
|00000400| 2d 73 70 65 63 69 66 69 | 63 20 4d 61 72 6b 75 70 |-specifi|c Markup|
|00000410| 20 3c 2f 74 69 74 6c 65 | 3e 0a 3c 2f 68 65 61 64 | </title|>.</head|
|00000420| 3e 0a 3c 62 6f 64 79 3e | 3c 73 63 72 69 70 74 20 |>.<body>|<script |
|00000430| 6c 61 6e 67 75 61 67 65 | 3d 22 6a 61 76 61 73 63 |language|="javasc|
|00000440| 72 69 70 74 22 3e 0a 69 | 66 20 28 77 69 6e 64 6f |ript">.i|f (windo|
|00000450| 77 2e 6e 61 6d 65 20 21 | 3d 20 22 63 6f 6e 74 65 |w.name !|= "conte|
|00000460| 6e 74 22 29 0a 20 20 20 | 20 64 6f 63 75 6d 65 6e |nt").   | documen|
|00000470| 74 2e 77 72 69 74 65 28 | 22 3c 63 65 6e 74 65 72 |t.write(|"<center|
|00000480| 3e 3c 61 20 68 72 65 66 | 3d 27 2e 2e 2f 69 6e 64 |><a href|='../ind|
|00000490| 65 78 2e 68 74 6d 6c 3f | 70 61 67 65 3d 64 6f 63 |ex.html?|page=doc|
|000004a0| 2f 6d 6f 64 75 6c 65 2d | 6d 61 72 6b 75 70 2e 68 |/module-|markup.h|
|000004b0| 74 6d 6c 27 3e 73 68 6f | 77 20 66 72 61 6d 69 6e |tml'>sho|w framin|
|000004c0| 67 3c 2f 61 3e 3c 2f 63 | 65 6e 74 65 72 3e 22 29 |g</a></c|enter>")|
|000004d0| 0a 3c 2f 73 63 72 69 70 | 74 3e 0a 3c 44 49 56 20 |.</scrip|t>.<DIV |
|000004e0| 43 4c 41 53 53 3d 22 6e | 61 76 69 67 61 74 69 6f |CLASS="n|avigatio|
|000004f0| 6e 22 3e 0a 3c 74 61 62 | 6c 65 20 61 6c 69 67 6e |n">.<tab|le align|
|00000500| 3d 22 63 65 6e 74 65 72 | 22 20 77 69 64 74 68 3d |="center|" width=|
|00000510| 22 31 30 30 25 22 20 63 | 65 6c 6c 70 61 64 64 69 |"100%" c|ellpaddi|
|00000520| 6e 67 3d 22 30 22 20 63 | 65 6c 6c 73 70 61 63 69 |ng="0" c|ellspaci|
|00000530| 6e 67 3d 22 32 22 3e 0a | 3c 74 72 3e 0a 3c 74 64 |ng="2">.|<tr>.<td|
|00000540| 3e 3c 61 20 72 65 6c 3d | 22 70 72 65 76 22 20 74 |><a rel=|"prev" t|
|00000550| 69 74 6c 65 3d 22 36 2e | 36 20 4d 69 73 63 65 6c |itle="6.|6 Miscel|
|00000560| 6c 61 6e 65 6f 75 73 20 | 54 65 78 74 20 4d 61 72 |laneous |Text Mar|
|00000570| 6b 75 70 22 20 0a 20 20 | 68 72 65 66 3d 22 6d 69 |kup" .  |href="mi|
|00000580| 73 63 2d 74 65 78 74 2d | 6d 61 72 6b 75 70 2e 68 |sc-text-|markup.h|
|00000590| 74 6d 6c 22 3e 3c 69 6d | 67 20 73 72 63 3d 27 2e |tml"><im|g src='.|
|000005a0| 2e 2f 69 63 6f 6e 73 2f | 70 72 65 76 69 6f 75 73 |./icons/|previous|
|000005b0| 2e 67 69 66 27 0a 20 20 | 62 6f 72 64 65 72 3d 27 |.gif'.  |border='|
|000005c0| 30 27 20 68 65 69 67 68 | 74 3d 27 33 32 27 20 20 |0' heigh|t='32'  |
|000005d0| 61 6c 74 3d 27 50 72 65 | 76 69 6f 75 73 20 50 61 |alt='Pre|vious Pa|
|000005e0| 67 65 27 20 77 69 64 74 | 68 3d 27 33 32 27 3e 3c |ge' widt|h='32'><|
|000005f0| 2f 41 3e 3c 2f 74 64 3e | 0a 3c 74 64 3e 3c 61 20 |/A></td>|.<td><a |
|00000600| 72 65 6c 3d 22 70 61 72 | 65 6e 74 22 20 74 69 74 |rel="par|ent" tit|
|00000610| 6c 65 3d 22 36 20 53 70 | 65 63 69 61 6c 20 4d 61 |le="6 Sp|ecial Ma|
|00000620| 72 6b 75 70 20 43 6f 6e | 73 74 72 75 63 74 73 22 |rkup Con|structs"|
|00000630| 20 0a 20 20 68 72 65 66 | 3d 22 73 70 65 63 69 61 | .  href|="specia|
|00000640| 6c 2d 63 6f 6e 73 74 72 | 75 63 74 73 2e 68 74 6d |l-constr|ucts.htm|
|00000650| 6c 22 3e 3c 69 6d 67 20 | 73 72 63 3d 27 2e 2e 2f |l"><img |src='../|
|00000660| 69 63 6f 6e 73 2f 75 70 | 2e 67 69 66 27 0a 20 20 |icons/up|.gif'.  |
|00000670| 62 6f 72 64 65 72 3d 27 | 30 27 20 68 65 69 67 68 |border='|0' heigh|
|00000680| 74 3d 27 33 32 27 20 20 | 61 6c 74 3d 27 55 70 20 |t='32'  |alt='Up |
|00000690| 4f 6e 65 20 4c 65 76 65 | 6c 27 20 77 69 64 74 68 |One Leve|l' width|
|000006a0| 3d 27 33 32 27 3e 3c 2f | 41 3e 3c 2f 74 64 3e 0a |='32'></|A></td>.|
|000006b0| 3c 74 64 3e 3c 61 20 72 | 65 6c 3d 22 6e 65 78 74 |<td><a r|el="next|
|000006c0| 22 20 74 69 74 6c 65 3d | 22 36 2e 38 20 4c 69 62 |" title=|"6.8 Lib|
|000006d0| 72 61 72 79 2d 6c 65 76 | 65 6c 20 4d 61 72 6b 75 |rary-lev|el Marku|
|000006e0| 70 22 20 0a 20 20 68 72 | 65 66 3d 22 6c 69 62 72 |p" .  hr|ef="libr|
|000006f0| 61 72 79 2d 6d 61 72 6b | 75 70 2e 68 74 6d 6c 22 |ary-mark|up.html"|
|00000700| 3e 3c 69 6d 67 20 73 72 | 63 3d 27 2e 2e 2f 69 63 |><img sr|c='../ic|
|00000710| 6f 6e 73 2f 6e 65 78 74 | 2e 67 69 66 27 0a 20 20 |ons/next|.gif'.  |
|00000720| 62 6f 72 64 65 72 3d 27 | 30 27 20 68 65 69 67 68 |border='|0' heigh|
|00000730| 74 3d 27 33 32 27 20 20 | 61 6c 74 3d 27 4e 65 78 |t='32'  |alt='Nex|
|00000740| 74 20 50 61 67 65 27 20 | 77 69 64 74 68 3d 27 33 |t Page' |width='3|
|00000750| 32 27 3e 3c 2f 41 3e 3c | 2f 74 64 3e 0a 3c 74 64 |2'></A><|/td>.<td|
|00000760| 20 61 6c 69 67 6e 3d 22 | 63 65 6e 74 65 72 22 20 | align="|center" |
|00000770| 77 69 64 74 68 3d 22 31 | 30 30 25 22 3e 44 6f 63 |width="1|00%">Doc|
|00000780| 75 6d 65 6e 74 69 6e 67 | 20 50 79 74 68 6f 6e 3c |umenting| Python<|
|00000790| 2f 74 64 3e 0a 3c 74 64 | 3e 3c 61 20 72 65 6c 3d |/td>.<td|><a rel=|
|000007a0| 22 63 6f 6e 74 65 6e 74 | 73 22 20 74 69 74 6c 65 |"content|s" title|
|000007b0| 3d 22 54 61 62 6c 65 20 | 6f 66 20 43 6f 6e 74 65 |="Table |of Conte|
|000007c0| 6e 74 73 22 20 0a 20 20 | 68 72 65 66 3d 22 63 6f |nts" .  |href="co|
|000007d0| 6e 74 65 6e 74 73 2e 68 | 74 6d 6c 22 3e 3c 69 6d |ntents.h|tml"><im|
|000007e0| 67 20 73 72 63 3d 27 2e | 2e 2f 69 63 6f 6e 73 2f |g src='.|./icons/|
|000007f0| 63 6f 6e 74 65 6e 74 73 | 2e 67 69 66 27 0a 20 20 |contents|.gif'.  |
|00000800| 62 6f 72 64 65 72 3d 27 | 30 27 20 68 65 69 67 68 |border='|0' heigh|
|00000810| 74 3d 27 33 32 27 20 20 | 61 6c 74 3d 27 43 6f 6e |t='32'  |alt='Con|
|00000820| 74 65 6e 74 73 27 20 77 | 69 64 74 68 3d 27 33 32 |tents' w|idth='32|
|00000830| 27 3e 3c 2f 41 3e 3c 2f | 74 64 3e 0a 3c 74 64 3e |'></A></|td>.<td>|
|00000840| 3c 69 6d 67 20 73 72 63 | 3d 27 2e 2e 2f 69 63 6f |<img src|='../ico|
|00000850| 6e 73 2f 62 6c 61 6e 6b | 2e 67 69 66 27 0a 20 20 |ns/blank|.gif'.  |
|00000860| 62 6f 72 64 65 72 3d 27 | 30 27 20 68 65 69 67 68 |border='|0' heigh|
|00000870| 74 3d 27 33 32 27 20 20 | 61 6c 74 3d 27 27 20 77 |t='32'  |alt='' w|
|00000880| 69 64 74 68 3d 27 33 32 | 27 3e 3c 2f 74 64 3e 0a |idth='32|'></td>.|
|00000890| 3c 2f 74 72 3e 3c 2f 74 | 61 62 6c 65 3e 0a 3c 62 |</tr></t|able>.<b|
|000008a0| 20 63 6c 61 73 73 3d 22 | 6e 61 76 6c 61 62 65 6c | class="|navlabel|
|000008b0| 22 3e 50 72 65 76 69 6f | 75 73 3a 3c 2f 62 3e 0a |">Previo|us:</b>.|
|000008c0| 3c 61 20 63 6c 61 73 73 | 3d 22 73 65 63 74 72 65 |<a class|="sectre|
|000008d0| 66 22 20 72 65 6c 3d 22 | 70 72 65 76 22 20 68 72 |f" rel="|prev" hr|
|000008e0| 65 66 3d 22 6d 69 73 63 | 2d 74 65 78 74 2d 6d 61 |ef="misc|-text-ma|
|000008f0| 72 6b 75 70 2e 68 74 6d | 6c 22 3e 36 2e 36 20 4d |rkup.htm|l">6.6 M|
|00000900| 69 73 63 65 6c 6c 61 6e | 65 6f 75 73 20 54 65 78 |iscellan|eous Tex|
|00000910| 74 20 4d 61 72 6b 75 70 | 3c 2f 41 3e 0a 3c 62 20 |t Markup|</A>.<b |
|00000920| 63 6c 61 73 73 3d 22 6e | 61 76 6c 61 62 65 6c 22 |class="n|avlabel"|
|00000930| 3e 55 70 3a 3c 2f 62 3e | 0a 3c 61 20 63 6c 61 73 |>Up:</b>|.<a clas|
|00000940| 73 3d 22 73 65 63 74 72 | 65 66 22 20 72 65 6c 3d |s="sectr|ef" rel=|
|00000950| 22 70 61 72 65 6e 74 22 | 20 68 72 65 66 3d 22 73 |"parent"| href="s|
|00000960| 70 65 63 69 61 6c 2d 63 | 6f 6e 73 74 72 75 63 74 |pecial-c|onstruct|
|00000970| 73 2e 68 74 6d 6c 22 3e | 36 20 53 70 65 63 69 61 |s.html">|6 Specia|
|00000980| 6c 20 4d 61 72 6b 75 70 | 20 43 6f 6e 73 74 72 75 |l Markup| Constru|
|00000990| 63 74 73 3c 2f 41 3e 0a | 3c 62 20 63 6c 61 73 73 |cts</A>.|<b class|
|000009a0| 3d 22 6e 61 76 6c 61 62 | 65 6c 22 3e 4e 65 78 74 |="navlab|el">Next|
|000009b0| 3a 3c 2f 62 3e 0a 3c 61 | 20 63 6c 61 73 73 3d 22 |:</b>.<a| class="|
|000009c0| 73 65 63 74 72 65 66 22 | 20 72 65 6c 3d 22 6e 65 |sectref"| rel="ne|
|000009d0| 78 74 22 20 68 72 65 66 | 3d 22 6c 69 62 72 61 72 |xt" href|="librar|
|000009e0| 79 2d 6d 61 72 6b 75 70 | 2e 68 74 6d 6c 22 3e 36 |y-markup|.html">6|
|000009f0| 2e 38 20 4c 69 62 72 61 | 72 79 2d 6c 65 76 65 6c |.8 Libra|ry-level|
|00000a00| 20 4d 61 72 6b 75 70 3c | 2f 41 3e 0a 3c 62 72 3e | Markup<|/A>.<br>|
|00000a10| 3c 68 72 3e 0a 3c 2f 44 | 49 56 3e 0a 3c 21 2d 2d |<hr>.</D|IV>.<!--|
|00000a20| 45 6e 64 20 6f 66 20 4e | 61 76 69 67 61 74 69 6f |End of N|avigatio|
|00000a30| 6e 20 50 61 6e 65 6c 2d | 2d 3e 0a 0a 3c 48 32 3e |n Panel-|->..<H2>|
|00000a40| 3c 41 20 4e 41 4d 45 3d | 22 53 45 43 54 49 4f 4e |<A NAME=|"SECTION|
|00000a50| 30 30 30 37 37 30 30 30 | 30 30 30 30 30 30 30 30 |00077000|00000000|
|00000a60| 30 30 30 30 30 22 3e 26 | 6e 62 73 70 3b 3c 2f 41 |00000">&|nbsp;</A|
|00000a70| 3e 0a 3c 42 52 3e 0a 36 | 2e 37 20 4d 6f 64 75 6c |>.<BR>.6|.7 Modul|
|00000a80| 65 2d 73 70 65 63 69 66 | 69 63 20 4d 61 72 6b 75 |e-specif|ic Marku|
|00000a90| 70 20 0a 3c 2f 48 32 3e | 0a 0a 3c 50 3e 0a 54 68 |p .</H2>|..<P>.Th|
|00000aa0| 65 20 6d 61 72 6b 75 70 | 20 64 65 73 63 72 69 62 |e markup| describ|
|00000ab0| 65 64 20 69 6e 20 74 68 | 69 73 20 73 65 63 74 69 |ed in th|is secti|
|00000ac0| 6f 6e 20 69 73 20 75 73 | 65 64 20 74 6f 20 70 72 |on is us|ed to pr|
|00000ad0| 6f 76 69 64 65 20 69 6e | 66 6f 72 6d 61 74 69 6f |ovide in|formatio|
|00000ae0| 6e 0a 20 20 61 62 6f 75 | 74 20 61 20 6d 6f 64 75 |n.  abou|t a modu|
|00000af0| 6c 65 20 62 65 69 6e 67 | 20 64 6f 63 75 6d 65 6e |le being| documen|
|00000b00| 74 65 64 2e 20 20 41 20 | 74 79 70 69 63 61 6c 20 |ted.  A |typical |
|00000b10| 75 73 65 20 6f 66 20 74 | 68 69 73 20 6d 61 72 6b |use of t|his mark|
|00000b20| 75 70 0a 20 20 61 70 70 | 65 61 72 73 20 61 74 20 |up.  app|ears at |
|00000b30| 74 68 65 20 74 6f 70 20 | 6f 66 20 74 68 65 20 73 |the top |of the s|
|00000b40| 65 63 74 69 6f 6e 20 75 | 73 65 64 20 74 6f 20 64 |ection u|sed to d|
|00000b50| 6f 63 75 6d 65 6e 74 20 | 61 20 6d 6f 64 75 6c 65 |ocument |a module|
|00000b60| 2e 20 20 41 0a 20 20 74 | 79 70 69 63 61 6c 20 65 |.  A.  t|ypical e|
|00000b70| 78 61 6d 70 6c 65 20 6d | 69 67 68 74 20 6c 6f 6f |xample m|ight loo|
|00000b80| 6b 20 6c 69 6b 65 20 74 | 68 69 73 3a 0a 0a 3c 50 |k like t|his:..<P|
|00000b90| 3e 0a 3c 64 69 76 20 63 | 6c 61 73 73 3d 22 76 65 |>.<div c|lass="ve|
|00000ba0| 72 62 61 74 69 6d 22 3e | 3c 70 72 65 3e 0a 5c 73 |rbatim">|<pre>.\s|
|00000bb0| 65 63 74 69 6f 6e 7b 5c | 6d 6f 64 75 6c 65 7b 73 |ection{\|module{s|
|00000bc0| 70 61 6d 7d 20 2d 2d 2d | 0a 20 20 20 20 20 20 20 |pam} ---|.       |
|00000bd0| 20 20 41 63 63 65 73 73 | 20 74 6f 20 74 68 65 20 |  Access| to the |
|00000be0| 53 50 41 4d 20 66 61 63 | 69 6c 69 74 79 7d 0a 0a |SPAM fac|ility}..|
|00000bf0| 5c 64 65 63 6c 61 72 65 | 6d 6f 64 75 6c 65 7b 65 |\declare|module{e|
|00000c00| 78 74 65 6e 73 69 6f 6e | 7d 7b 73 70 61 6d 7d 0a |xtension|}{spam}.|
|00000c10| 20 20 5c 70 6c 61 74 66 | 6f 72 6d 7b 55 6e 69 78 |  \platf|orm{Unix|
|00000c20| 7d 0a 5c 6d 6f 64 75 6c | 65 73 79 6e 6f 70 73 69 |}.\modul|esynopsi|
|00000c30| 73 7b 41 63 63 65 73 73 | 20 74 6f 20 74 68 65 20 |s{Access| to the |
|00000c40| 53 50 41 4d 20 66 61 63 | 69 6c 69 74 79 20 6f 66 |SPAM fac|ility of|
|00000c50| 20 5c 55 4e 49 58 2e 7d | 0a 5c 6d 6f 64 75 6c 65 | \UNIX.}|.\module|
|00000c60| 61 75 74 68 6f 72 7b 4a | 61 6e 65 20 44 6f 65 7d |author{J|ane Doe}|
|00000c70| 7b 6a 61 6e 65 2e 64 6f | 65 40 66 72 6f 62 6e 69 |{jane.do|e@frobni|
|00000c80| 74 7a 2e 6f 72 67 7d 0a | 3c 2f 70 72 65 3e 3c 2f |tz.org}.|</pre></|
|00000c90| 64 69 76 3e 0a 0a 3c 50 | 3e 0a 50 79 74 68 6f 6e |div>..<P|>.Python|
|00000ca0| 20 70 61 63 6b 61 67 65 | 73 3c 61 20 6e 61 6d 65 | package|s<a name|
|00000cb0| 3d 22 6c 32 68 2d 34 22 | 3e 26 6e 62 73 70 3b 3c |="l2h-4"|>&nbsp;<|
|00000cc0| 2f 61 3e 2d 2d 20 63 6f | 6c 6c 65 63 74 69 6f 6e |/a>-- co|llection|
|00000cd0| 73 20 6f 66 20 6d 6f 64 | 75 6c 65 73 20 74 68 61 |s of mod|ules tha|
|00000ce0| 74 20 63 61 6e 0a 20 20 | 62 65 20 64 65 73 63 72 |t can.  |be descr|
|00000cf0| 69 62 65 64 20 61 73 20 | 61 20 75 6e 69 74 20 2d |ibed as |a unit -|
|00000d00| 2d 20 61 72 65 20 64 6f | 63 75 6d 65 6e 74 65 64 |- are do|cumented|
|00000d10| 20 75 73 69 6e 67 20 74 | 68 65 20 73 61 6d 65 20 | using t|he same |
|00000d20| 6d 61 72 6b 75 70 20 61 | 73 0a 20 20 6d 6f 64 75 |markup a|s.  modu|
|00000d30| 6c 65 73 2e 20 20 54 68 | 65 20 6e 61 6d 65 20 66 |les.  Th|e name f|
|00000d40| 6f 72 20 61 20 6d 6f 64 | 75 6c 65 20 69 6e 20 61 |or a mod|ule in a|
|00000d50| 20 70 61 63 6b 61 67 65 | 20 73 68 6f 75 6c 64 20 | package| should |
|00000d60| 62 65 20 74 79 70 65 64 | 20 69 6e 0a 20 20 60 60 |be typed| in.  ``|
|00000d70| 66 75 6c 6c 79 20 71 75 | 61 6c 69 66 69 65 64 27 |fully qu|alified'|
|00000d80| 27 20 66 6f 72 6d 20 28 | 69 74 20 73 68 6f 75 6c |' form (|it shoul|
|00000d90| 64 20 69 6e 63 6c 75 64 | 65 20 74 68 65 20 70 61 |d includ|e the pa|
|00000da0| 63 6b 61 67 65 20 6e 61 | 6d 65 29 2e 0a 20 20 46 |ckage na|me)..  F|
|00000db0| 6f 72 20 65 78 61 6d 70 | 6c 65 2c 20 61 20 6d 6f |or examp|le, a mo|
|00000dc0| 64 75 6c 65 20 60 60 66 | 6f 6f 27 27 20 69 6e 20 |dule ``f|oo'' in |
|00000dd0| 70 61 63 6b 61 67 65 20 | 60 60 62 61 72 27 27 20 |package |``bar'' |
|00000de0| 73 68 6f 75 6c 64 20 62 | 65 20 6d 61 72 6b 65 64 |should b|e marked|
|00000df0| 20 61 73 0a 20 20 3c 63 | 6f 64 65 3e 26 23 39 32 | as.  <c|ode>&#92|
|00000e00| 3b 6d 6f 64 75 6c 65 7b | 62 61 72 2e 66 6f 6f 7d |;module{|bar.foo}|
|00000e10| 3c 2f 63 6f 64 65 3e 2c | 20 61 6e 64 20 74 68 65 |</code>,| and the|
|00000e20| 20 62 65 67 69 6e 6e 69 | 6e 67 20 6f 66 20 74 68 | beginni|ng of th|
|00000e30| 65 20 72 65 66 65 72 65 | 6e 63 65 0a 20 20 73 65 |e refere|nce.  se|
|00000e40| 63 74 69 6f 6e 20 77 6f | 75 6c 64 20 61 70 70 65 |ction wo|uld appe|
|00000e50| 61 72 20 61 73 3a 0a 0a | 3c 50 3e 0a 3c 64 69 76 |ar as:..|<P>.<div|
|00000e60| 20 63 6c 61 73 73 3d 22 | 76 65 72 62 61 74 69 6d | class="|verbatim|
|00000e70| 22 3e 3c 70 72 65 3e 0a | 5c 73 65 63 74 69 6f 6e |"><pre>.|\section|
|00000e80| 7b 5c 6d 6f 64 75 6c 65 | 7b 62 61 72 2e 66 6f 6f |{\module|{bar.foo|
|00000e90| 7d 20 2d 2d 2d 0a 20 20 | 20 20 20 20 20 20 20 4d |} ---.  |       M|
|00000ea0| 6f 64 75 6c 65 20 66 72 | 6f 6d 20 74 68 65 20 5c |odule fr|om the \|
|00000eb0| 6d 6f 64 75 6c 65 7b 62 | 61 72 7d 20 70 61 63 6b |module{b|ar} pack|
|00000ec0| 61 67 65 7d 0a 0a 5c 64 | 65 63 6c 61 72 65 6d 6f |age}..\d|eclaremo|
|00000ed0| 64 75 6c 65 7b 65 78 74 | 65 6e 73 69 6f 6e 7d 7b |dule{ext|ension}{|
|00000ee0| 62 61 72 2e 66 6f 6f 7d | 0a 5c 6d 6f 64 75 6c 65 |bar.foo}|.\module|
|00000ef0| 73 79 6e 6f 70 73 69 73 | 7b 4e 69 66 74 79 20 6d |synopsis|{Nifty m|
|00000f00| 6f 64 75 6c 65 20 66 72 | 6f 6d 20 74 68 65 20 5c |odule fr|om the \|
|00000f10| 6d 6f 64 75 6c 65 7b 62 | 61 72 7d 20 70 61 63 6b |module{b|ar} pack|
|00000f20| 61 67 65 2e 7d 0a 5c 6d | 6f 64 75 6c 65 61 75 74 |age.}.\m|oduleaut|
|00000f30| 68 6f 72 7b 4a 61 6e 65 | 20 44 6f 65 7d 7b 6a 61 |hor{Jane| Doe}{ja|
|00000f40| 6e 65 2e 64 6f 65 40 66 | 72 6f 62 6e 69 74 7a 2e |ne.doe@f|robnitz.|
|00000f50| 6f 72 67 7d 0a 3c 2f 70 | 72 65 3e 3c 2f 64 69 76 |org}.</p|re></div|
|00000f60| 3e 0a 0a 3c 50 3e 0a 4e | 6f 74 65 20 74 68 61 74 |>..<P>.N|ote that|
|00000f70| 20 74 68 65 20 6e 61 6d | 65 20 6f 66 20 61 20 70 | the nam|e of a p|
|00000f80| 61 63 6b 61 67 65 20 69 | 73 20 61 6c 73 6f 20 6d |ackage i|s also m|
|00000f90| 61 72 6b 65 64 20 75 73 | 69 6e 67 0a 20 20 3c 74 |arked us|ing.  <t|
|00000fa0| 74 20 63 6c 61 73 73 3d | 27 6d 61 63 72 6f 27 3e |t class=|'macro'>|
|00000fb0| 26 23 39 32 3b 6d 6f 64 | 75 6c 65 3c 2f 74 74 3e |&#92;mod|ule</tt>|
|00000fc0| 2e 0a 0a 3c 50 3e 0a 0a | 3c 64 6c 20 63 6c 61 73 |...<P>..|<dl clas|
|00000fd0| 73 3d 27 6d 61 63 72 6f | 64 65 73 63 27 3e 0a 3c |s='macro|desc'>.<|
|00000fe0| 64 74 3e 3c 62 3e 3c 74 | 74 20 63 6c 61 73 73 3d |dt><b><t|t class=|
|00000ff0| 27 6d 61 63 72 6f 27 3e | 26 23 39 32 3b 64 65 63 |'macro'>|&#92;dec|
|00001000| 6c 61 72 65 6d 6f 64 75 | 6c 65 3c 2f 74 74 3e 3c |laremodu|le</tt><|
|00001010| 2f 62 3e 0a 20 20 20 20 | 3c 74 74 3e 5b 3c 2f 74 |/b>.    |<tt>[</t|
|00001020| 74 3e 3c 76 61 72 3e 6b | 65 79 3c 2f 76 61 72 3e |t><var>k|ey</var>|
|00001030| 3c 74 74 3e 5d 3c 2f 74 | 74 3e 3c 74 74 3e 7b 3c |<tt>]</t|t><tt>{<|
|00001040| 2f 74 74 3e 3c 76 61 72 | 3e 74 79 70 65 3c 2f 76 |/tt><var|>type</v|
|00001050| 61 72 3e 3c 74 74 3e 7d | 3c 2f 74 74 3e 3c 74 74 |ar><tt>}|</tt><tt|
|00001060| 3e 7b 3c 2f 74 74 3e 3c | 76 61 72 3e 6e 61 6d 65 |>{</tt><|var>name|
|00001070| 3c 2f 76 61 72 3e 3c 74 | 74 3e 7d 3c 2f 74 74 3e |</var><t|t>}</tt>|
|00001080| 0a 3c 64 64 3e 0a 20 20 | 20 20 52 65 71 75 69 72 |.<dd>.  |  Requir|
|00001090| 65 73 20 74 77 6f 20 70 | 61 72 61 6d 65 74 65 72 |es two p|arameter|
|000010a0| 73 3a 20 6d 6f 64 75 6c | 65 20 74 79 70 65 20 28 |s: modul|e type (|
|000010b0| 22 3c 74 74 20 63 6c 61 | 73 73 3d 22 73 61 6d 70 |"<tt cla|ss="samp|
|000010c0| 22 3e 73 74 61 6e 64 61 | 72 64 3c 2f 74 74 3e 22 |">standa|rd</tt>"|
|000010d0| 2c 0a 20 20 20 20 22 3c | 74 74 20 63 6c 61 73 73 |,.    "<|tt class|
|000010e0| 3d 22 73 61 6d 70 22 3e | 62 75 69 6c 74 69 6e 3c |="samp">|builtin<|
|000010f0| 2f 74 74 3e 22 2c 20 22 | 3c 74 74 20 63 6c 61 73 |/tt>", "|<tt clas|
|00001100| 73 3d 22 73 61 6d 70 22 | 3e 65 78 74 65 6e 73 69 |s="samp"|>extensi|
|00001110| 6f 6e 3c 2f 74 74 3e 22 | 2c 20 6f 72 20 22 22 29 |on</tt>"|, or "")|
|00001120| 2c 20 61 6e 64 20 74 68 | 65 20 6d 6f 64 75 6c 65 |, and th|e module|
|00001130| 0a 20 20 20 20 6e 61 6d | 65 2e 20 20 41 6e 20 6f |.    nam|e.  An o|
|00001140| 70 74 69 6f 6e 61 6c 20 | 70 61 72 61 6d 65 74 65 |ptional |paramete|
|00001150| 72 20 73 68 6f 75 6c 64 | 20 62 65 20 67 69 76 65 |r should| be give|
|00001160| 6e 20 61 73 20 74 68 65 | 20 62 61 73 69 73 20 66 |n as the| basis f|
|00001170| 6f 72 20 74 68 65 0a 20 | 20 20 20 6d 6f 64 75 6c |or the. |   modul|
|00001180| 65 27 73 20 60 60 6b 65 | 79 27 27 20 75 73 65 64 |e's ``ke|y'' used|
|00001190| 20 66 6f 72 20 6c 69 6e | 6b 69 6e 67 20 74 6f 20 | for lin|king to |
|000011a0| 6f 72 20 72 65 66 65 72 | 65 6e 63 69 6e 67 20 74 |or refer|encing t|
|000011b0| 68 65 20 73 65 63 74 69 | 6f 6e 2e 0a 20 20 20 20 |he secti|on..    |
|000011c0| 54 68 65 20 60 60 6b 65 | 79 27 27 20 73 68 6f 75 |The ``ke|y'' shou|
|000011d0| 6c 64 20 6f 6e 6c 79 20 | 62 65 20 67 69 76 65 6e |ld only |be given|
|000011e0| 20 69 66 20 74 68 65 20 | 6d 6f 64 75 6c 65 27 73 | if the |module's|
|000011f0| 20 6e 61 6d 65 20 63 6f | 6e 74 61 69 6e 73 20 61 | name co|ntains a|
|00001200| 6e 79 0a 20 20 20 20 75 | 6e 64 65 72 73 63 6f 72 |ny.    u|nderscor|
|00001210| 65 73 2c 20 61 6e 64 20 | 73 68 6f 75 6c 64 20 62 |es, and |should b|
|00001220| 65 20 74 68 65 20 6e 61 | 6d 65 20 77 69 74 68 20 |e the na|me with |
|00001230| 74 68 65 20 75 6e 64 65 | 72 73 63 6f 72 65 73 20 |the unde|rscores |
|00001240| 73 74 72 69 70 70 65 64 | 2e 0a 20 20 20 20 4e 6f |stripped|..    No|
|00001250| 74 65 20 74 68 61 74 20 | 74 68 65 20 3c 76 61 72 |te that |the <var|
|00001260| 3e 74 79 70 65 3c 2f 76 | 61 72 3e 20 70 61 72 61 |>type</v|ar> para|
|00001270| 6d 65 74 65 72 20 6d 75 | 73 74 20 62 65 20 6f 6e |meter mu|st be on|
|00001280| 65 20 6f 66 20 74 68 65 | 20 76 61 6c 75 65 73 0a |e of the| values.|
|00001290| 20 20 20 20 6c 69 73 74 | 65 64 20 61 62 6f 76 65 |    list|ed above|
|000012a0| 20 6f 72 20 61 6e 20 65 | 72 72 6f 72 20 77 69 6c | or an e|rror wil|
|000012b0| 6c 20 62 65 20 70 72 69 | 6e 74 65 64 2e 20 20 46 |l be pri|nted.  F|
|000012c0| 6f 72 20 6d 6f 64 75 6c | 65 73 20 77 68 69 63 68 |or modul|es which|
|000012d0| 20 61 72 65 0a 20 20 20 | 20 63 6f 6e 74 61 69 6e | are.   | contain|
|000012e0| 65 64 20 69 6e 20 70 61 | 63 6b 61 67 65 73 2c 20 |ed in pa|ckages, |
|000012f0| 74 68 65 20 66 75 6c 6c | 79 2d 71 75 61 6c 69 66 |the full|y-qualif|
|00001300| 69 65 64 20 6e 61 6d 65 | 20 73 68 6f 75 6c 64 20 |ied name| should |
|00001310| 62 65 20 67 69 76 65 6e | 20 61 73 0a 20 20 20 20 |be given| as.    |
|00001320| 3c 76 61 72 3e 6e 61 6d | 65 3c 2f 76 61 72 3e 20 |<var>nam|e</var> |
|00001330| 70 61 72 61 6d 65 74 65 | 72 2e 20 20 54 68 69 73 |paramete|r.  This|
|00001340| 20 73 68 6f 75 6c 64 20 | 62 65 20 74 68 65 20 66 | should |be the f|
|00001350| 69 72 73 74 20 74 68 69 | 6e 67 20 61 66 74 65 72 |irst thi|ng after|
|00001360| 20 74 68 65 0a 20 20 20 | 20 3c 74 74 20 63 6c 61 | the.   | <tt cla|
|00001370| 73 73 3d 27 6d 61 63 72 | 6f 27 3e 26 23 39 32 3b |ss='macr|o'>&#92;|
|00001380| 73 65 63 74 69 6f 6e 3c | 2f 74 74 3e 20 75 73 65 |section<|/tt> use|
|00001390| 64 20 74 6f 20 69 6e 74 | 72 6f 64 75 63 65 20 74 |d to int|roduce t|
|000013a0| 68 65 20 6d 6f 64 75 6c | 65 2e 0a 20 20 3c 2f 64 |he modul|e..  </d|
|000013b0| 6c 3e 0a 0a 3c 50 3e 0a | 0a 3c 64 6c 20 63 6c 61 |l>..<P>.|.<dl cla|
|000013c0| 73 73 3d 27 6d 61 63 72 | 6f 64 65 73 63 27 3e 0a |ss='macr|odesc'>.|
|000013d0| 3c 64 74 3e 3c 62 3e 3c | 74 74 20 63 6c 61 73 73 |<dt><b><|tt class|
|000013e0| 3d 27 6d 61 63 72 6f 27 | 3e 26 23 39 32 3b 70 6c |='macro'|>&#92;pl|
|000013f0| 61 74 66 6f 72 6d 3c 2f | 74 74 3e 3c 2f 62 3e 0a |atform</|tt></b>.|
|00001400| 20 20 20 20 3c 74 74 3e | 7b 3c 2f 74 74 3e 3c 76 |    <tt>|{</tt><v|
|00001410| 61 72 3e 73 70 65 63 69 | 66 69 65 72 3c 2f 76 61 |ar>speci|fier</va|
|00001420| 72 3e 3c 74 74 3e 7d 3c | 2f 74 74 3e 0a 3c 64 64 |r><tt>}<|/tt>.<dd|
|00001430| 3e 0a 20 20 20 20 53 70 | 65 63 69 66 69 65 73 20 |>.    Sp|ecifies |
|00001440| 74 68 65 20 70 6f 72 74 | 61 62 69 6c 69 74 79 20 |the port|ability |
|00001450| 6f 66 20 74 68 65 20 6d | 6f 64 75 6c 65 2e 20 20 |of the m|odule.  |
|00001460| 3c 76 61 72 3e 73 70 65 | 63 69 66 69 65 72 3c 2f |<var>spe|cifier</|
|00001470| 76 61 72 3e 20 69 73 20 | 61 0a 20 20 20 20 63 6f |var> is |a.    co|
|00001480| 6d 6d 61 2d 73 65 70 61 | 72 61 74 65 64 20 6c 69 |mma-sepa|rated li|
|00001490| 73 74 20 6f 66 20 6b 65 | 79 73 20 74 68 61 74 20 |st of ke|ys that |
|000014a0| 73 70 65 63 69 66 79 20 | 77 68 61 74 20 70 6c 61 |specify |what pla|
|000014b0| 74 66 6f 72 6d 73 20 74 | 68 65 0a 20 20 20 20 6d |tforms t|he.    m|
|000014c0| 6f 64 75 6c 65 20 69 73 | 20 61 76 61 69 6c 61 62 |odule is| availab|
|000014d0| 6c 65 20 6f 6e 2e 20 20 | 54 68 65 20 6b 65 79 73 |le on.  |The keys|
|000014e0| 20 61 72 65 20 73 68 6f | 72 74 20 69 64 65 6e 74 | are sho|rt ident|
|000014f0| 69 66 69 65 72 73 3b 0a | 20 20 20 20 65 78 61 6d |ifiers;.|    exam|
|00001500| 70 6c 65 73 20 74 68 61 | 74 20 61 72 65 20 69 6e |ples tha|t are in|
|00001510| 20 75 73 65 20 69 6e 63 | 6c 75 64 65 20 22 3c 74 | use inc|lude "<t|
|00001520| 74 20 63 6c 61 73 73 3d | 22 73 61 6d 70 22 3e 49 |t class=|"samp">I|
|00001530| 52 49 58 3c 2f 74 74 3e | 22 2c 20 22 3c 74 74 20 |RIX</tt>|", "<tt |
|00001540| 63 6c 61 73 73 3d 22 73 | 61 6d 70 22 3e 4d 61 63 |class="s|amp">Mac|
|00001550| 3c 2f 74 74 3e 22 2c 0a | 20 20 20 20 22 3c 74 74 |</tt>",.|    "<tt|
|00001560| 20 63 6c 61 73 73 3d 22 | 73 61 6d 70 22 3e 57 69 | class="|samp">Wi|
|00001570| 6e 64 6f 77 73 3c 2f 74 | 74 3e 22 2c 20 61 6e 64 |ndows</t|t>", and|
|00001580| 20 22 3c 74 74 20 63 6c | 61 73 73 3d 22 73 61 6d | "<tt cl|ass="sam|
|00001590| 70 22 3e 55 6e 69 78 3c | 2f 74 74 3e 22 2e 20 20 |p">Unix<|/tt>".  |
|000015a0| 49 74 20 69 73 20 69 6d | 70 6f 72 74 61 6e 74 20 |It is im|portant |
|000015b0| 74 6f 20 75 73 65 20 61 | 20 6b 65 79 0a 20 20 20 |to use a| key.   |
|000015c0| 20 77 68 69 63 68 20 68 | 61 73 20 61 6c 72 65 61 | which h|as alrea|
|000015d0| 64 79 20 62 65 65 6e 20 | 75 73 65 64 20 77 68 65 |dy been |used whe|
|000015e0| 6e 20 61 70 70 6c 69 63 | 61 62 6c 65 2e 20 20 54 |n applic|able.  T|
|000015f0| 68 69 73 20 69 73 20 75 | 73 65 64 20 74 6f 0a 20 |his is u|sed to. |
|00001600| 20 20 20 70 72 6f 76 69 | 64 65 20 61 6e 6e 6f 74 |   provi|de annot|
|00001610| 61 74 69 6f 6e 73 20 69 | 6e 20 74 68 65 20 4d 6f |ations i|n the Mo|
|00001620| 64 75 6c 65 20 49 6e 64 | 65 78 20 61 6e 64 20 74 |dule Ind|ex and t|
|00001630| 68 65 20 48 54 4d 4c 20 | 61 6e 64 20 47 4e 55 20 |he HTML |and GNU |
|00001640| 69 6e 66 6f 0a 20 20 20 | 20 6f 75 74 70 75 74 2e |info.   | output.|
|00001650| 0a 20 20 3c 2f 64 6c 3e | 0a 0a 3c 50 3e 0a 0a 3c |.  </dl>|..<P>..<|
|00001660| 64 6c 20 63 6c 61 73 73 | 3d 27 6d 61 63 72 6f 64 |dl class|='macrod|
|00001670| 65 73 63 27 3e 0a 3c 64 | 74 3e 3c 62 3e 3c 74 74 |esc'>.<d|t><b><tt|
|00001680| 20 63 6c 61 73 73 3d 27 | 6d 61 63 72 6f 27 3e 26 | class='|macro'>&|
|00001690| 23 39 32 3b 6d 6f 64 75 | 6c 65 73 79 6e 6f 70 73 |#92;modu|lesynops|
|000016a0| 69 73 3c 2f 74 74 3e 3c | 2f 62 3e 0a 20 20 20 20 |is</tt><|/b>.    |
|000016b0| 3c 74 74 3e 7b 3c 2f 74 | 74 3e 3c 76 61 72 3e 74 |<tt>{</t|t><var>t|
|000016c0| 65 78 74 3c 2f 76 61 72 | 3e 3c 74 74 3e 7d 3c 2f |ext</var|><tt>}</|
|000016d0| 74 74 3e 0a 3c 64 64 3e | 0a 20 20 20 20 54 68 65 |tt>.<dd>|.    The|
|000016e0| 20 3c 76 61 72 3e 74 65 | 78 74 3c 2f 76 61 72 3e | <var>te|xt</var>|
|000016f0| 20 69 73 20 61 20 73 68 | 6f 72 74 2c 20 60 60 6f | is a sh|ort, ``o|
|00001700| 6e 65 20 6c 69 6e 65 27 | 27 20 64 65 73 63 72 69 |ne line'|' descri|
|00001710| 70 74 69 6f 6e 20 6f 66 | 20 74 68 65 0a 20 20 20 |ption of| the.   |
|00001720| 20 6d 6f 64 75 6c 65 20 | 74 68 61 74 20 63 61 6e | module |that can|
|00001730| 20 62 65 20 75 73 65 64 | 20 61 73 20 70 61 72 74 | be used| as part|
|00001740| 20 6f 66 20 74 68 65 20 | 63 68 61 70 74 65 72 20 | of the |chapter |
|00001750| 69 6e 74 72 6f 64 75 63 | 74 69 6f 6e 2e 0a 20 20 |introduc|tion..  |
|00001760| 20 20 54 68 69 73 20 69 | 73 20 6d 75 73 74 20 62 |  This i|s must b|
|00001770| 65 20 70 6c 61 63 65 64 | 20 61 66 74 65 72 20 3c |e placed| after <|
|00001780| 74 74 20 63 6c 61 73 73 | 3d 27 6d 61 63 72 6f 27 |tt class|='macro'|
|00001790| 3e 26 23 39 32 3b 64 65 | 63 6c 61 72 65 6d 6f 64 |>&#92;de|claremod|
|000017a0| 75 6c 65 3c 2f 74 74 3e | 2e 0a 20 20 20 20 54 68 |ule</tt>|..    Th|
|000017b0| 65 20 73 79 6e 6f 70 73 | 69 73 20 69 73 20 75 73 |e synops|is is us|
|000017c0| 65 64 20 69 6e 20 62 75 | 69 6c 64 69 6e 67 20 74 |ed in bu|ilding t|
|000017d0| 68 65 20 63 6f 6e 74 65 | 6e 74 73 20 6f 66 20 74 |he conte|nts of t|
|000017e0| 68 65 20 74 61 62 6c 65 | 0a 20 20 20 20 69 6e 73 |he table|.    ins|
|000017f0| 65 72 74 65 64 20 61 73 | 20 74 68 65 20 3c 74 74 |erted as| the <tt|
|00001800| 20 63 6c 61 73 73 3d 27 | 6d 61 63 72 6f 27 3e 26 | class='|macro'>&|
|00001810| 23 39 32 3b 6c 6f 63 61 | 6c 6d 6f 64 75 6c 65 74 |#92;loca|lmodulet|
|00001820| 61 62 6c 65 3c 2f 74 74 | 3e 2e 20 20 4e 6f 20 74 |able</tt|>.  No t|
|00001830| 65 78 74 20 69 73 0a 20 | 20 20 20 70 72 6f 64 75 |ext is. |   produ|
|00001840| 63 65 64 20 61 74 20 74 | 68 65 20 70 6f 69 6e 74 |ced at t|he point|
|00001850| 20 6f 66 20 74 68 65 20 | 6d 61 72 6b 75 70 2e 0a | of the |markup..|
|00001860| 20 20 3c 2f 64 6c 3e 0a | 0a 3c 50 3e 0a 0a 3c 64 |  </dl>.|.<P>..<d|
|00001870| 6c 20 63 6c 61 73 73 3d | 27 6d 61 63 72 6f 64 65 |l class=|'macrode|
|00001880| 73 63 27 3e 0a 3c 64 74 | 3e 3c 62 3e 3c 74 74 20 |sc'>.<dt|><b><tt |
|00001890| 63 6c 61 73 73 3d 27 6d | 61 63 72 6f 27 3e 26 23 |class='m|acro'>&#|
|000018a0| 39 32 3b 6d 6f 64 75 6c | 65 61 75 74 68 6f 72 3c |92;modul|eauthor<|
|000018b0| 2f 74 74 3e 3c 2f 62 3e | 0a 20 20 20 20 3c 74 74 |/tt></b>|.    <tt|
|000018c0| 3e 7b 3c 2f 74 74 3e 3c | 76 61 72 3e 6e 61 6d 65 |>{</tt><|var>name|
|000018d0| 3c 2f 76 61 72 3e 3c 74 | 74 3e 7d 3c 2f 74 74 3e |</var><t|t>}</tt>|
|000018e0| 3c 74 74 3e 7b 3c 2f 74 | 74 3e 3c 76 61 72 3e 65 |<tt>{</t|t><var>e|
|000018f0| 6d 61 69 6c 3c 2f 76 61 | 72 3e 3c 74 74 3e 7d 3c |mail</va|r><tt>}<|
|00001900| 2f 74 74 3e 0a 3c 64 64 | 3e 0a 20 20 20 20 54 68 |/tt>.<dd|>.    Th|
|00001910| 69 73 20 6d 61 63 72 6f | 20 69 73 20 75 73 65 64 |is macro| is used|
|00001920| 20 74 6f 20 65 6e 63 6f | 64 65 20 69 6e 66 6f 72 | to enco|de infor|
|00001930| 6d 61 74 69 6f 6e 20 61 | 62 6f 75 74 20 77 68 6f |mation a|bout who|
|00001940| 20 61 75 74 68 6f 72 65 | 64 20 61 0a 20 20 20 20 | authore|d a.    |
|00001950| 6d 6f 64 75 6c 65 2e 20 | 20 54 68 69 73 20 69 73 |module. | This is|
|00001960| 20 63 75 72 72 65 6e 74 | 6c 79 20 6e 6f 74 20 75 | current|ly not u|
|00001970| 73 65 64 20 74 6f 20 67 | 65 6e 65 72 61 74 65 20 |sed to g|enerate |
|00001980| 6f 75 74 70 75 74 2c 20 | 62 75 74 20 63 61 6e 20 |output, |but can |
|00001990| 62 65 0a 20 20 20 20 75 | 73 65 64 20 74 6f 20 68 |be.    u|sed to h|
|000019a0| 65 6c 70 20 64 65 74 65 | 72 6d 69 6e 65 20 74 68 |elp dete|rmine th|
|000019b0| 65 20 6f 72 69 67 69 6e | 20 6f 66 20 74 68 65 20 |e origin| of the |
|000019c0| 6d 6f 64 75 6c 65 2e 0a | 20 20 3c 2f 64 6c 3e 0a |module..|  </dl>.|
|000019d0| 0a 3c 50 3e 0a 0a 3c 44 | 49 56 20 43 4c 41 53 53 |.<P>..<D|IV CLASS|
|000019e0| 3d 22 6e 61 76 69 67 61 | 74 69 6f 6e 22 3e 0a 3c |="naviga|tion">.<|
|000019f0| 70 3e 3c 68 72 3e 0a 3c | 74 61 62 6c 65 20 61 6c |p><hr>.<|table al|
|00001a00| 69 67 6e 3d 22 63 65 6e | 74 65 72 22 20 77 69 64 |ign="cen|ter" wid|
|00001a10| 74 68 3d 22 31 30 30 25 | 22 20 63 65 6c 6c 70 61 |th="100%|" cellpa|
|00001a20| 64 64 69 6e 67 3d 22 30 | 22 20 63 65 6c 6c 73 70 |dding="0|" cellsp|
|00001a30| 61 63 69 6e 67 3d 22 32 | 22 3e 0a 3c 74 72 3e 0a |acing="2|">.<tr>.|
|00001a40| 3c 74 64 3e 3c 61 20 72 | 65 6c 3d 22 70 72 65 76 |<td><a r|el="prev|
|00001a50| 22 20 74 69 74 6c 65 3d | 22 36 2e 36 20 4d 69 73 |" title=|"6.6 Mis|
|00001a60| 63 65 6c 6c 61 6e 65 6f | 75 73 20 54 65 78 74 20 |cellaneo|us Text |
|00001a70| 4d 61 72 6b 75 70 22 20 | 0a 20 20 72 65 6c 3d 22 |Markup" |.  rel="|
|00001a80| 70 72 65 76 22 20 74 69 | 74 6c 65 3d 22 36 2e 36 |prev" ti|tle="6.6|
|00001a90| 20 4d 69 73 63 65 6c 6c | 61 6e 65 6f 75 73 20 54 | Miscell|aneous T|
|00001aa0| 65 78 74 20 4d 61 72 6b | 75 70 22 20 0a 20 20 68 |ext Mark|up" .  h|
|00001ab0| 72 65 66 3d 22 6d 69 73 | 63 2d 74 65 78 74 2d 6d |ref="mis|c-text-m|
|00001ac0| 61 72 6b 75 70 2e 68 74 | 6d 6c 22 3e 3c 69 6d 67 |arkup.ht|ml"><img|
|00001ad0| 20 73 72 63 3d 27 2e 2e | 2f 69 63 6f 6e 73 2f 70 | src='..|/icons/p|
|00001ae0| 72 65 76 69 6f 75 73 2e | 67 69 66 27 0a 20 20 62 |revious.|gif'.  b|
|00001af0| 6f 72 64 65 72 3d 27 30 | 27 20 68 65 69 67 68 74 |order='0|' height|
|00001b00| 3d 27 33 32 27 20 20 61 | 6c 74 3d 27 50 72 65 76 |='32'  a|lt='Prev|
|00001b10| 69 6f 75 73 20 50 61 67 | 65 27 20 77 69 64 74 68 |ious Pag|e' width|
|00001b20| 3d 27 33 32 27 3e 3c 2f | 41 3e 3c 2f 74 64 3e 0a |='32'></|A></td>.|
|00001b30| 3c 74 64 3e 3c 61 20 72 | 65 6c 3d 22 70 61 72 65 |<td><a r|el="pare|
|00001b40| 6e 74 22 20 74 69 74 6c | 65 3d 22 36 20 53 70 65 |nt" titl|e="6 Spe|
|00001b50| 63 69 61 6c 20 4d 61 72 | 6b 75 70 20 43 6f 6e 73 |cial Mar|kup Cons|
|00001b60| 74 72 75 63 74 73 22 20 | 0a 20 20 72 65 6c 3d 22 |tructs" |.  rel="|
|00001b70| 70 61 72 65 6e 74 22 20 | 74 69 74 6c 65 3d 22 36 |parent" |title="6|
|00001b80| 20 53 70 65 63 69 61 6c | 20 4d 61 72 6b 75 70 20 | Special| Markup |
|00001b90| 43 6f 6e 73 74 72 75 63 | 74 73 22 20 0a 20 20 68 |Construc|ts" .  h|
|00001ba0| 72 65 66 3d 22 73 70 65 | 63 69 61 6c 2d 63 6f 6e |ref="spe|cial-con|
|00001bb0| 73 74 72 75 63 74 73 2e | 68 74 6d 6c 22 3e 3c 69 |structs.|html"><i|
|00001bc0| 6d 67 20 73 72 63 3d 27 | 2e 2e 2f 69 63 6f 6e 73 |mg src='|../icons|
|00001bd0| 2f 75 70 2e 67 69 66 27 | 0a 20 20 62 6f 72 64 65 |/up.gif'|.  borde|
|00001be0| 72 3d 27 30 27 20 68 65 | 69 67 68 74 3d 27 33 32 |r='0' he|ight='32|
|00001bf0| 27 20 20 61 6c 74 3d 27 | 55 70 20 4f 6e 65 20 4c |'  alt='|Up One L|
|00001c00| 65 76 65 6c 27 20 77 69 | 64 74 68 3d 27 33 32 27 |evel' wi|dth='32'|
|00001c10| 3e 3c 2f 41 3e 3c 2f 74 | 64 3e 0a 3c 74 64 3e 3c |></A></t|d>.<td><|
|00001c20| 61 20 72 65 6c 3d 22 6e | 65 78 74 22 20 74 69 74 |a rel="n|ext" tit|
|00001c30| 6c 65 3d 22 36 2e 38 20 | 4c 69 62 72 61 72 79 2d |le="6.8 |Library-|
|00001c40| 6c 65 76 65 6c 20 4d 61 | 72 6b 75 70 22 20 0a 20 |level Ma|rkup" . |
|00001c50| 20 72 65 6c 3d 22 6e 65 | 78 74 22 20 74 69 74 6c | rel="ne|xt" titl|
|00001c60| 65 3d 22 36 2e 38 20 4c | 69 62 72 61 72 79 2d 6c |e="6.8 L|ibrary-l|
|00001c70| 65 76 65 6c 20 4d 61 72 | 6b 75 70 22 20 0a 20 20 |evel Mar|kup" .  |
|00001c80| 68 72 65 66 3d 22 6c 69 | 62 72 61 72 79 2d 6d 61 |href="li|brary-ma|
|00001c90| 72 6b 75 70 2e 68 74 6d | 6c 22 3e 3c 69 6d 67 20 |rkup.htm|l"><img |
|00001ca0| 73 72 63 3d 27 2e 2e 2f | 69 63 6f 6e 73 2f 6e 65 |src='../|icons/ne|
|00001cb0| 78 74 2e 67 69 66 27 0a | 20 20 62 6f 72 64 65 72 |xt.gif'.|  border|
|00001cc0| 3d 27 30 27 20 68 65 69 | 67 68 74 3d 27 33 32 27 |='0' hei|ght='32'|
|00001cd0| 20 20 61 6c 74 3d 27 4e | 65 78 74 20 50 61 67 65 |  alt='N|ext Page|
|00001ce0| 27 20 77 69 64 74 68 3d | 27 33 32 27 3e 3c 2f 41 |' width=|'32'></A|
|00001cf0| 3e 3c 2f 74 64 3e 0a 3c | 74 64 20 61 6c 69 67 6e |></td>.<|td align|
|00001d00| 3d 22 63 65 6e 74 65 72 | 22 20 77 69 64 74 68 3d |="center|" width=|
|00001d10| 22 31 30 30 25 22 3e 44 | 6f 63 75 6d 65 6e 74 69 |"100%">D|ocumenti|
|00001d20| 6e 67 20 50 79 74 68 6f | 6e 3c 2f 74 64 3e 0a 3c |ng Pytho|n</td>.<|
|00001d30| 74 64 3e 3c 61 20 72 65 | 6c 3d 22 63 6f 6e 74 65 |td><a re|l="conte|
|00001d40| 6e 74 73 22 20 74 69 74 | 6c 65 3d 22 54 61 62 6c |nts" tit|le="Tabl|
|00001d50| 65 20 6f 66 20 43 6f 6e | 74 65 6e 74 73 22 20 0a |e of Con|tents" .|
|00001d60| 20 20 72 65 6c 3d 22 63 | 6f 6e 74 65 6e 74 73 22 |  rel="c|ontents"|
|00001d70| 20 74 69 74 6c 65 3d 22 | 54 61 62 6c 65 20 6f 66 | title="|Table of|
|00001d80| 20 43 6f 6e 74 65 6e 74 | 73 22 20 0a 20 20 68 72 | Content|s" .  hr|
|00001d90| 65 66 3d 22 63 6f 6e 74 | 65 6e 74 73 2e 68 74 6d |ef="cont|ents.htm|
|00001da0| 6c 22 3e 3c 69 6d 67 20 | 73 72 63 3d 27 2e 2e 2f |l"><img |src='../|
|00001db0| 69 63 6f 6e 73 2f 63 6f | 6e 74 65 6e 74 73 2e 67 |icons/co|ntents.g|
|00001dc0| 69 66 27 0a 20 20 62 6f | 72 64 65 72 3d 27 30 27 |if'.  bo|rder='0'|
|00001dd0| 20 68 65 69 67 68 74 3d | 27 33 32 27 20 20 61 6c | height=|'32'  al|
|00001de0| 74 3d 27 43 6f 6e 74 65 | 6e 74 73 27 20 77 69 64 |t='Conte|nts' wid|
|00001df0| 74 68 3d 27 33 32 27 3e | 3c 2f 41 3e 3c 2f 74 64 |th='32'>|</A></td|
|00001e00| 3e 0a 3c 74 64 3e 3c 69 | 6d 67 20 73 72 63 3d 27 |>.<td><i|mg src='|
|00001e10| 2e 2e 2f 69 63 6f 6e 73 | 2f 62 6c 61 6e 6b 2e 67 |../icons|/blank.g|
|00001e20| 69 66 27 0a 20 20 62 6f | 72 64 65 72 3d 27 30 27 |if'.  bo|rder='0'|
|00001e30| 20 68 65 69 67 68 74 3d | 27 33 32 27 20 20 61 6c | height=|'32'  al|
|00001e40| 74 3d 27 27 20 77 69 64 | 74 68 3d 27 33 32 27 3e |t='' wid|th='32'>|
|00001e50| 3c 2f 74 64 3e 0a 3c 2f | 74 72 3e 3c 2f 74 61 62 |</td>.</|tr></tab|
|00001e60| 6c 65 3e 0a 3c 62 20 63 | 6c 61 73 73 3d 22 6e 61 |le>.<b c|lass="na|
|00001e70| 76 6c 61 62 65 6c 22 3e | 50 72 65 76 69 6f 75 73 |vlabel">|Previous|
|00001e80| 3a 3c 2f 62 3e 0a 3c 61 | 20 63 6c 61 73 73 3d 22 |:</b>.<a| class="|
|00001e90| 73 65 63 74 72 65 66 22 | 20 72 65 6c 3d 22 70 72 |sectref"| rel="pr|
|00001ea0| 65 76 22 20 68 72 65 66 | 3d 22 6d 69 73 63 2d 74 |ev" href|="misc-t|
|00001eb0| 65 78 74 2d 6d 61 72 6b | 75 70 2e 68 74 6d 6c 22 |ext-mark|up.html"|
|00001ec0| 3e 36 2e 36 20 4d 69 73 | 63 65 6c 6c 61 6e 65 6f |>6.6 Mis|cellaneo|
|00001ed0| 75 73 20 54 65 78 74 20 | 4d 61 72 6b 75 70 3c 2f |us Text |Markup</|
|00001ee0| 41 3e 0a 3c 62 20 63 6c | 61 73 73 3d 22 6e 61 76 |A>.<b cl|ass="nav|
|00001ef0| 6c 61 62 65 6c 22 3e 55 | 70 3a 3c 2f 62 3e 0a 3c |label">U|p:</b>.<|
|00001f00| 61 20 63 6c 61 73 73 3d | 22 73 65 63 74 72 65 66 |a class=|"sectref|
|00001f10| 22 20 72 65 6c 3d 22 70 | 61 72 65 6e 74 22 20 68 |" rel="p|arent" h|
|00001f20| 72 65 66 3d 22 73 70 65 | 63 69 61 6c 2d 63 6f 6e |ref="spe|cial-con|
|00001f30| 73 74 72 75 63 74 73 2e | 68 74 6d 6c 22 3e 36 20 |structs.|html">6 |
|00001f40| 53 70 65 63 69 61 6c 20 | 4d 61 72 6b 75 70 20 43 |Special |Markup C|
|00001f50| 6f 6e 73 74 72 75 63 74 | 73 3c 2f 41 3e 0a 3c 62 |onstruct|s</A>.<b|
|00001f60| 20 63 6c 61 73 73 3d 22 | 6e 61 76 6c 61 62 65 6c | class="|navlabel|
|00001f70| 22 3e 4e 65 78 74 3a 3c | 2f 62 3e 0a 3c 61 20 63 |">Next:<|/b>.<a c|
|00001f80| 6c 61 73 73 3d 22 73 65 | 63 74 72 65 66 22 20 72 |lass="se|ctref" r|
|00001f90| 65 6c 3d 22 6e 65 78 74 | 22 20 68 72 65 66 3d 22 |el="next|" href="|
|00001fa0| 6c 69 62 72 61 72 79 2d | 6d 61 72 6b 75 70 2e 68 |library-|markup.h|
|00001fb0| 74 6d 6c 22 3e 36 2e 38 | 20 4c 69 62 72 61 72 79 |tml">6.8| Library|
|00001fc0| 2d 6c 65 76 65 6c 20 4d | 61 72 6b 75 70 3c 2f 41 |-level M|arkup</A|
|00001fd0| 3e 0a 3c 68 72 3e 0a 3c | 73 70 61 6e 20 63 6c 61 |>.<hr>.<|span cla|
|00001fe0| 73 73 3d 22 72 65 6c 65 | 61 73 65 2d 69 6e 66 6f |ss="rele|ase-info|
|00001ff0| 22 3e 52 65 6c 65 61 73 | 65 20 32 2e 33 2e 32 2c |">Releas|e 2.3.2,|
|00002000| 20 64 6f 63 75 6d 65 6e | 74 61 74 69 6f 6e 20 75 | documen|tation u|
|00002010| 70 64 61 74 65 64 20 6f | 6e 20 4f 63 74 6f 62 65 |pdated o|n Octobe|
|00002020| 72 20 33 2c 20 32 30 30 | 33 2e 3c 2f 73 70 61 6e |r 3, 200|3.</span|
|00002030| 3e 0a 3c 2f 44 49 56 3e | 0a 3c 21 2d 2d 45 6e 64 |>.</DIV>|.<!--End|
|00002040| 20 6f 66 20 4e 61 76 69 | 67 61 74 69 6f 6e 20 50 | of Navi|gation P|
|00002050| 61 6e 65 6c 2d 2d 3e 0a | 3c 41 44 44 52 45 53 53 |anel-->.|<ADDRESS|
|00002060| 3e 0a 53 65 65 20 3c 69 | 3e 3c 61 20 68 72 65 66 |>.See <i|><a href|
|00002070| 3d 22 61 62 6f 75 74 2e | 68 74 6d 6c 22 3e 41 62 |="about.|html">Ab|
|00002080| 6f 75 74 20 74 68 69 73 | 20 64 6f 63 75 6d 65 6e |out this| documen|
|00002090| 74 2e 2e 2e 3c 2f 61 3e | 3c 2f 69 3e 20 66 6f 72 |t...</a>|</i> for|
|000020a0| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 20 6f 6e 20 | informa|tion on |
|000020b0| 73 75 67 67 65 73 74 69 | 6e 67 20 63 68 61 6e 67 |suggesti|ng chang|
|000020c0| 65 73 2e 0a 3c 2f 41 44 | 44 52 45 53 53 3e 0a 3c |es..</AD|DRESS>.<|
|000020d0| 2f 42 4f 44 59 3e 0a 3c | 2f 48 54 4d 4c 3e 0a    |/BODY>.<|/HTML>. |
+--------+-------------------------+-------------------------+--------+--------+