/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pytexdoc / ext / lib / lib2 / macos / tex

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 4d 61 63 4f 53 | 7d 7d 0a 5c 62 69 6d 6f |de{MacOS|}}.\bimo|
|00000030| 64 69 6e 64 65 78 7b 4d | 61 63 4f 53 7d 0a 0a 5c |dindex{M|acOS}..\|
|00000040| 72 65 6e 65 77 63 6f 6d | 6d 61 6e 64 7b 5c 69 6e |renewcom|mand{\in|
|00000050| 64 65 78 73 75 62 69 74 | 65 6d 7d 7b 28 69 6e 20 |dexsubit|em}{(in |
|00000060| 6d 6f 64 75 6c 65 20 4d | 61 63 4f 53 29 7d 0a 0a |module M|acOS)}..|
|00000070| 54 68 69 73 20 6d 6f 64 | 75 6c 65 20 70 72 6f 76 |This mod|ule prov|
|00000080| 69 64 65 73 20 61 63 63 | 65 73 73 20 74 6f 20 4d |ides acc|ess to M|
|00000090| 61 63 4f 53 20 73 70 65 | 63 69 66 69 63 20 66 75 |acOS spe|cific fu|
|000000a0| 6e 63 74 69 6f 6e 61 6c | 69 74 79 20 69 6e 20 74 |nctional|ity in t|
|000000b0| 68 65 0a 70 79 74 68 6f | 6e 20 69 6e 74 65 72 70 |he.pytho|n interp|
|000000c0| 72 65 74 65 72 2c 20 73 | 75 63 68 20 61 73 20 68 |reter, s|uch as h|
|000000d0| 6f 77 20 74 68 65 20 69 | 6e 74 65 72 70 72 65 74 |ow the i|nterpret|
|000000e0| 65 72 20 65 76 65 6e 74 | 6c 6f 6f 70 20 66 75 6e |er event|loop fun|
|000000f0| 63 74 69 6f 6e 73 0a 61 | 6e 64 20 74 68 65 20 6c |ctions.a|nd the l|
|00000100| 69 6b 65 2e 20 55 73 65 | 20 77 69 74 68 20 63 61 |ike. Use| with ca|
|00000110| 72 65 2e 0a 0a 4e 6f 74 | 65 20 74 68 65 20 63 61 |re...Not|e the ca|
|00000120| 70 69 74 61 6c 69 73 61 | 74 69 6f 6e 20 6f 66 20 |pitalisa|tion of |
|00000130| 74 68 65 20 6d 6f 64 75 | 6c 65 20 6e 61 6d 65 2c |the modu|le name,|
|00000140| 20 74 68 69 73 20 69 73 | 20 61 20 68 69 73 74 6f | this is| a histo|
|00000150| 72 69 63 61 6c 0a 61 72 | 74 65 66 61 63 74 2e 0a |rical.ar|tefact..|
|00000160| 0a 5c 62 65 67 69 6e 7b | 65 78 63 64 65 73 63 7d |.\begin{|excdesc}|
|00000170| 7b 45 72 72 6f 72 7d 0a | 54 68 69 73 20 65 78 63 |{Error}.|This exc|
|00000180| 65 70 74 69 6f 6e 20 69 | 73 20 72 61 69 73 65 64 |eption i|s raised|
|00000190| 20 6f 6e 20 4d 61 63 4f | 53 20 67 65 6e 65 72 61 | on MacO|S genera|
|000001a0| 74 65 64 20 65 72 72 6f | 72 73 2c 20 65 69 74 68 |ted erro|rs, eith|
|000001b0| 65 72 20 66 72 6f 6d 0a | 66 75 6e 63 74 69 6f 6e |er from.|function|
|000001c0| 73 20 69 6e 20 74 68 69 | 73 20 6d 6f 64 75 6c 65 |s in thi|s module|
|000001d0| 20 6f 72 20 66 72 6f 6d | 20 6f 74 68 65 72 20 6d | or from| other m|
|000001e0| 61 63 2d 73 70 65 63 69 | 66 69 63 20 6d 6f 64 75 |ac-speci|fic modu|
|000001f0| 6c 65 73 20 6c 69 6b 65 | 20 74 68 65 0a 74 6f 6f |les like| the.too|
|00000200| 6c 62 6f 78 20 69 6e 74 | 65 72 66 61 63 65 73 2e |lbox int|erfaces.|
|00000210| 20 54 68 65 20 61 72 67 | 75 6d 65 6e 74 73 20 61 | The arg|uments a|
|00000220| 72 65 20 74 68 65 20 69 | 6e 74 65 67 65 72 20 65 |re the i|nteger e|
|00000230| 72 72 6f 72 20 63 6f 64 | 65 20 28 74 68 65 0a 5c |rror cod|e (the.\|
|00000240| 76 61 72 7b 4f 53 45 72 | 72 7d 20 76 61 6c 75 65 |var{OSEr|r} value|
|00000250| 29 20 61 6e 64 20 61 20 | 74 65 78 74 75 61 6c 20 |) and a |textual |
|00000260| 64 65 73 63 72 69 70 74 | 69 6f 6e 20 6f 66 20 74 |descript|ion of t|
|00000270| 68 65 20 65 72 72 6f 72 | 20 63 6f 64 65 2e 0a 53 |he error| code..S|
|00000280| 79 6d 62 6f 6c 69 63 20 | 6e 61 6d 65 73 20 66 6f |ymbolic |names fo|
|00000290| 72 20 61 6c 6c 20 6b 6e | 6f 77 6e 20 65 72 72 6f |r all kn|own erro|
|000002a0| 72 20 63 6f 64 65 73 20 | 61 72 65 20 64 65 66 69 |r codes |are defi|
|000002b0| 6e 65 64 20 69 6e 20 74 | 68 65 20 73 74 61 6e 64 |ned in t|he stand|
|000002c0| 61 72 64 0a 6d 6f 64 75 | 6c 65 20 5c 76 61 72 7b |ard.modu|le \var{|
|000002d0| 6d 61 63 65 72 72 6f 72 | 73 7d 2e 0a 5c 65 6e 64 |macerror|s}..\end|
|000002e0| 7b 65 78 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |{excdesc|}..\begi|
|000002f0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 53 65 74 48 |n{funcde|sc}{SetH|
|00000300| 69 67 68 4c 65 76 65 6c | 45 76 65 6e 74 48 61 6e |ighLevel|EventHan|
|00000310| 64 6c 65 72 7d 7b 68 61 | 6e 64 6c 65 72 7d 0a 50 |dler}{ha|ndler}.P|
|00000320| 61 73 73 20 61 20 70 79 | 74 68 6f 6e 20 66 75 6e |ass a py|thon fun|
|00000330| 63 74 69 6f 6e 20 74 68 | 61 74 20 77 69 6c 6c 20 |ction th|at will |
|00000340| 62 65 20 63 61 6c 6c 65 | 64 20 75 70 6f 6e 20 72 |be calle|d upon r|
|00000350| 65 63 65 70 74 69 6f 6e | 20 6f 66 20 61 0a 68 69 |eception| of a.hi|
|00000360| 67 68 2d 6c 65 76 65 6c | 20 65 76 65 6e 74 2e 20 |gh-level| event. |
|00000370| 54 68 65 20 70 72 65 76 | 69 6f 75 73 20 68 61 6e |The prev|ious han|
|00000380| 64 6c 65 72 20 69 73 20 | 72 65 74 75 72 6e 65 64 |dler is |returned|
|00000390| 2e 20 54 68 65 20 68 61 | 6e 64 6c 65 72 0a 66 75 |. The ha|ndler.fu|
|000003a0| 6e 63 74 69 6f 6e 20 69 | 73 20 63 61 6c 6c 65 64 |nction i|s called|
|000003b0| 20 77 69 74 68 20 74 68 | 65 20 65 76 65 6e 74 20 | with th|e event |
|000003c0| 61 73 20 61 72 67 75 6d | 65 6e 74 2e 0a 0a 4e 6f |as argum|ent...No|
|000003d0| 74 65 20 74 68 61 74 20 | 79 6f 75 72 20 65 76 65 |te that |your eve|
|000003e0| 6e 74 20 68 61 6e 64 6c | 65 72 20 69 73 20 63 75 |nt handl|er is cu|
|000003f0| 72 72 65 6e 74 6c 79 20 | 6f 6e 6c 79 20 63 61 6c |rrently |only cal|
|00000400| 6c 65 64 20 64 65 70 65 | 6e 64 61 62 6c 79 20 69 |led depe|ndably i|
|00000410| 66 0a 79 6f 75 72 20 6d | 61 69 6e 20 65 76 65 6e |f.your m|ain even|
|00000420| 74 20 6c 6f 6f 70 20 69 | 73 20 69 6e 20 5c 76 61 |t loop i|s in \va|
|00000430| 72 7b 73 74 64 77 69 6e | 7d 2e 0a 5c 65 6e 64 7b |r{stdwin|}..\end{|
|00000440| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00000450| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 41 63 63 65 |n{funcde|sc}{Acce|
|00000460| 70 74 48 69 67 68 4c 65 | 76 65 6c 45 76 65 6e 74 |ptHighLe|velEvent|
|00000470| 7d 7b 7d 0a 52 65 61 64 | 20 61 20 68 69 67 68 2d |}{}.Read| a high-|
|00000480| 6c 65 76 65 6c 20 65 76 | 65 6e 74 2e 20 54 68 65 |level ev|ent. The|
|00000490| 20 72 65 74 75 72 6e 20 | 76 61 6c 75 65 20 69 73 | return |value is|
|000004a0| 20 61 20 74 75 70 6c 65 | 20 5c 63 6f 64 65 7b 28 | a tuple| \code{(|
|000004b0| 73 65 6e 64 65 72 2c 0a | 72 65 66 63 6f 6e 2c 20 |sender,.|refcon, |
|000004c0| 64 61 74 61 29 7d 2e 0a | 5c 65 6e 64 7b 66 75 6e |data)}..|\end{fun|
|000004d0| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|000004e0| 75 6e 63 64 65 73 63 7d | 7b 53 65 74 53 63 68 65 |uncdesc}|{SetSche|
|000004f0| 64 75 6c 65 54 69 6d 65 | 73 7d 7b 66 67 69 5c 2c |duleTime|s}{fgi\,|
|00000500| 20 66 67 79 20 5c 6f 70 | 74 69 6f 6e 61 6c 7b 5c | fgy \op|tional{\|
|00000510| 2c 20 62 67 69 5c 2c 20 | 62 67 79 7d 7d 0a 43 6f |, bgi\, |bgy}}.Co|
|00000520| 6e 74 72 6f 6c 73 20 68 | 6f 77 20 6f 66 74 65 6e |ntrols h|ow often|
|00000530| 20 74 68 65 20 69 6e 74 | 65 72 70 72 65 74 65 72 | the int|erpreter|
|00000540| 20 63 68 65 63 6b 73 20 | 74 68 65 20 65 76 65 6e | checks |the even|
|00000550| 74 20 71 75 65 75 65 20 | 61 6e 64 20 68 6f 77 0a |t queue |and how.|
|00000560| 6c 6f 6e 67 20 69 74 20 | 77 69 6c 6c 20 79 69 65 |long it |will yie|
|00000570| 6c 64 20 74 68 65 20 70 | 72 6f 63 65 73 73 6f 72 |ld the p|rocessor|
|00000580| 20 74 6f 20 6f 74 68 65 | 72 20 70 72 6f 63 65 73 | to othe|r proces|
|00000590| 73 65 73 2e 20 5c 76 61 | 72 7b 66 67 69 7d 0a 73 |ses. \va|r{fgi}.s|
|000005a0| 70 65 63 69 66 69 65 73 | 20 61 66 74 65 72 20 68 |pecifies| after h|
|000005b0| 6f 77 20 6d 61 6e 79 20 | 63 6c 69 63 6b 73 20 28 |ow many |clicks (|
|000005c0| 6f 6e 65 20 63 6c 69 63 | 6b 20 69 73 20 6f 6e 65 |one clic|k is one|
|000005d0| 20 36 30 74 68 20 6f 66 | 20 61 20 73 65 63 6f 6e | 60th of| a secon|
|000005e0| 64 29 0a 74 68 65 20 69 | 6e 74 65 72 70 72 65 74 |d).the i|nterpret|
|000005f0| 65 72 20 73 68 6f 75 6c | 64 20 63 68 65 63 6b 20 |er shoul|d check |
|00000600| 74 68 65 20 65 76 65 6e | 74 20 71 75 65 75 65 2c |the even|t queue,|
|00000610| 20 61 6e 64 20 5c 76 61 | 72 7b 66 67 79 7d 20 73 | and \va|r{fgy} s|
|00000620| 70 65 63 69 66 69 65 73 | 0a 66 6f 72 20 68 6f 77 |pecifies|.for how|
|00000630| 20 6d 61 6e 79 20 63 6c | 69 63 6b 73 20 74 68 65 | many cl|icks the|
|00000640| 20 43 50 55 20 73 68 6f | 75 6c 64 20 62 65 20 79 | CPU sho|uld be y|
|00000650| 69 65 6c 64 65 64 20 77 | 68 65 6e 20 69 6e 20 74 |ielded w|hen in t|
|00000660| 68 65 0a 66 6f 72 65 67 | 72 6f 75 6e 64 2e 20 54 |he.foreg|round. T|
|00000670| 68 65 20 6f 70 74 69 6f | 6e 61 6c 20 5c 76 61 72 |he optio|nal \var|
|00000680| 7b 62 67 69 7d 20 61 6e | 64 20 5c 76 61 72 7b 62 |{bgi} an|d \var{b|
|00000690| 67 79 7d 20 61 6c 6c 6f | 77 20 79 6f 75 20 74 6f |gy} allo|w you to|
|000006a0| 20 73 70 65 63 69 66 79 | 0a 64 69 66 66 65 72 65 | specify|.differe|
|000006b0| 6e 74 20 76 61 6c 75 65 | 73 20 74 6f 20 75 73 65 |nt value|s to use|
|000006c0| 20 77 68 65 6e 20 70 79 | 74 68 6f 6e 20 72 75 6e | when py|thon run|
|000006d0| 73 20 69 6e 20 74 68 65 | 20 62 61 63 6b 67 72 6f |s in the| backgro|
|000006e0| 75 6e 64 2c 20 6f 74 68 | 65 72 77 69 73 65 0a 74 |und, oth|erwise.t|
|000006f0| 68 65 20 62 61 63 6b 67 | 72 6f 75 6e 64 20 76 61 |he backg|round va|
|00000700| 6c 75 65 73 20 77 69 6c | 6c 20 62 65 20 73 65 74 |lues wil|l be set|
|00000710| 20 74 68 65 20 74 68 65 | 20 73 61 6d 65 20 61 73 | the the| same as|
|00000720| 20 74 68 65 20 66 6f 72 | 65 67 72 6f 75 6e 64 0a | the for|eground.|
|00000730| 76 61 6c 75 65 73 2e 20 | 54 68 65 20 66 75 6e 63 |values. |The func|
|00000740| 74 69 6f 6e 20 72 65 74 | 75 72 6e 73 20 6e 6f 74 |tion ret|urns not|
|00000750| 68 69 6e 67 2e 0a 0a 54 | 68 65 20 64 65 66 61 75 |hing...T|he defau|
|00000760| 6c 74 20 76 61 6c 75 65 | 73 2c 20 77 68 69 63 68 |lt value|s, which|
|00000770| 20 61 72 65 20 62 61 73 | 65 64 20 6f 6e 20 6d 69 | are bas|ed on mi|
|00000780| 6e 69 6d 61 6c 20 65 6d | 70 69 72 69 63 61 6c 20 |nimal em|pirical |
|00000790| 74 65 73 74 69 6e 67 2c | 20 61 72 65 20 31 32 2c |testing,| are 12,|
|000007a0| 20 31 2c 20 36 0a 61 6e | 64 20 32 20 72 65 73 70 | 1, 6.an|d 2 resp|
|000007b0| 65 63 74 69 76 65 6c 79 | 2e 0a 5c 65 6e 64 7b 66 |ectively|..\end{f|
|000007c0| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000007d0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 45 6e 61 62 6c |{funcdes|c}{Enabl|
|000007e0| 65 41 70 70 73 77 69 74 | 63 68 7d 7b 6f 6e 6f 66 |eAppswit|ch}{onof|
|000007f0| 66 7d 0a 45 6e 61 62 6c | 65 20 6f 72 20 64 69 73 |f}.Enabl|e or dis|
|00000800| 61 62 6c 65 20 74 68 65 | 20 70 79 74 68 6f 6e 20 |able the| python |
|00000810| 65 76 65 6e 74 20 6c 6f | 6f 70 2c 20 62 61 73 65 |event lo|op, base|
|00000820| 64 20 6f 6e 20 74 68 65 | 20 76 61 6c 75 65 20 6f |d on the| value o|
|00000830| 66 0a 5c 76 61 72 7b 6f | 6e 6f 66 66 7d 2e 20 54 |f.\var{o|noff}. T|
|00000840| 68 65 20 6f 6c 64 20 76 | 61 6c 75 65 20 69 73 20 |he old v|alue is |
|00000850| 72 65 74 75 72 6e 65 64 | 2e 20 49 66 20 74 68 65 |returned|. If the|
|00000860| 20 65 76 65 6e 74 20 6c | 6f 6f 70 20 69 73 20 64 | event l|oop is d|
|00000870| 69 73 61 62 6c 65 64 0a | 6e 6f 20 74 69 6d 65 20 |isabled.|no time |
|00000880| 69 73 20 67 72 61 6e 74 | 65 64 20 74 6f 20 6f 74 |is grant|ed to ot|
|00000890| 68 65 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 73 |her appl|ications|
|000008a0| 2c 20 63 68 65 63 6b 69 | 6e 67 20 66 6f 72 20 63 |, checki|ng for c|
|000008b0| 6f 6d 6d 61 6e 64 2d 70 | 65 72 69 6f 64 0a 69 73 |ommand-p|eriod.is|
|000008c0| 20 6e 6f 74 20 70 65 72 | 66 6f 72 6d 65 64 20 61 | not per|formed a|
|000008d0| 6e 64 20 69 74 20 69 73 | 20 69 6d 70 6f 73 73 69 |nd it is| impossi|
|000008e0| 62 6c 65 20 74 6f 20 73 | 77 69 74 63 68 20 61 70 |ble to s|witch ap|
|000008f0| 70 6c 69 63 61 74 69 6f | 6e 73 2e 20 54 68 69 73 |plicatio|ns. This|
|00000900| 0a 73 68 6f 75 6c 64 20 | 6f 6e 6c 79 20 62 65 20 |.should |only be |
|00000910| 75 73 65 64 20 62 79 20 | 70 72 6f 67 72 61 6d 73 |used by |programs|
|00000920| 20 70 72 6f 76 69 64 69 | 6e 67 20 74 68 65 69 72 | providi|ng their|
|00000930| 20 6f 77 6e 20 63 6f 6d | 70 6c 65 74 65 20 65 76 | own com|plete ev|
|00000940| 65 6e 74 0a 6c 6f 6f 70 | 2e 0a 0a 4e 6f 74 65 20 |ent.loop|...Note |
|00000950| 74 68 61 74 20 62 61 73 | 65 64 20 6f 6e 20 74 68 |that bas|ed on th|
|00000960| 65 20 63 6f 6d 70 69 6c | 65 72 20 75 73 65 64 20 |e compil|er used |
|00000970| 74 6f 20 62 75 69 6c 64 | 20 70 79 74 68 6f 6e 20 |to build| python |
|00000980| 69 74 20 69 73 20 73 74 | 69 6c 6c 0a 70 6f 73 73 |it is st|ill.poss|
|00000990| 69 62 6c 65 20 74 6f 20 | 6c 6f 6f 73 65 20 65 76 |ible to |loose ev|
|000009a0| 65 6e 74 73 20 65 76 65 | 6e 20 77 69 74 68 20 74 |ents eve|n with t|
|000009b0| 68 65 20 70 79 74 68 6f | 6e 20 65 76 65 6e 74 20 |he pytho|n event |
|000009c0| 6c 6f 6f 70 20 64 69 73 | 61 62 6c 65 64 2e 20 49 |loop dis|abled. I|
|000009d0| 66 0a 79 6f 75 20 68 61 | 76 65 20 61 20 5c 63 6f |f.you ha|ve a \co|
|000009e0| 64 65 7b 73 79 73 2e 73 | 74 64 6f 75 74 7d 20 77 |de{sys.s|tdout} w|
|000009f0| 69 6e 64 6f 77 20 69 74 | 73 20 68 61 6e 64 6c 65 |indow it|s handle|
|00000a00| 72 20 77 69 6c 6c 20 6f | 66 74 65 6e 20 61 6c 73 |r will o|ften als|
|00000a10| 6f 20 6c 6f 6f 6b 0a 69 | 6e 20 74 68 65 20 65 76 |o look.i|n the ev|
|00000a20| 65 6e 74 20 71 75 65 75 | 65 2e 20 4d 61 6b 69 6e |ent queu|e. Makin|
|00000a30| 67 20 73 75 72 65 20 6e | 6f 74 68 69 6e 67 20 69 |g sure n|othing i|
|00000a40| 73 20 65 76 65 72 20 70 | 72 69 6e 74 65 64 20 77 |s ever p|rinted w|
|00000a50| 6f 72 6b 73 20 61 72 6f | 75 6e 64 0a 74 68 69 73 |orks aro|und.this|
|00000a60| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000a70| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000a80| 63 7d 7b 48 61 6e 64 6c | 65 45 76 65 6e 74 7d 7b |c}{Handl|eEvent}{|
|00000a90| 65 76 7d 0a 50 61 73 73 | 20 74 68 65 20 65 76 65 |ev}.Pass| the eve|
|00000aa0| 6e 74 20 72 65 63 6f 72 | 64 20 5c 63 6f 64 65 7b |nt recor|d \code{|
|00000ab0| 65 76 7d 20 62 61 63 6b | 20 74 6f 20 74 68 65 20 |ev} back| to the |
|00000ac0| 70 79 74 68 6f 6e 20 65 | 76 65 6e 74 20 6c 6f 6f |python e|vent loo|
|00000ad0| 70 2c 20 6f 72 0a 70 6f | 73 73 69 62 6c 79 20 74 |p, or.po|ssibly t|
|00000ae0| 6f 20 74 68 65 20 68 61 | 6e 64 6c 65 72 20 66 6f |o the ha|ndler fo|
|00000af0| 72 20 74 68 65 20 5c 63 | 6f 64 65 7b 73 79 73 2e |r the \c|ode{sys.|
|00000b00| 73 74 64 6f 75 74 7d 20 | 77 69 6e 64 6f 77 20 28 |stdout} |window (|
|00000b10| 62 61 73 65 64 20 6f 6e | 20 74 68 65 0a 63 6f 6d |based on| the.com|
|00000b20| 70 69 6c 65 72 20 75 73 | 65 64 20 74 6f 20 62 75 |piler us|ed to bu|
|00000b30| 69 6c 64 20 70 79 74 68 | 6f 6e 29 2e 20 54 68 69 |ild pyth|on). Thi|
|00000b40| 73 20 61 6c 6c 6f 77 73 | 20 70 79 74 68 6f 6e 20 |s allows| python |
|00000b50| 70 72 6f 67 72 61 6d 73 | 20 74 68 61 74 20 64 6f |programs| that do|
|00000b60| 0a 74 68 65 69 72 20 6f | 77 6e 20 65 76 65 6e 74 |.their o|wn event|
|00000b70| 20 68 61 6e 64 6c 69 6e | 67 20 74 6f 20 73 74 69 | handlin|g to sti|
|00000b80| 6c 6c 20 68 61 76 65 20 | 73 6f 6d 65 20 63 6f 6d |ll have |some com|
|00000b90| 6d 61 6e 64 2d 70 65 72 | 69 6f 64 20 61 6e 64 0a |mand-per|iod and.|
|00000ba0| 77 69 6e 64 6f 77 2d 73 | 77 69 74 63 68 69 6e 67 |window-s|witching|
|00000bb0| 20 63 61 70 61 62 69 6c | 69 74 79 2e 0a 5c 65 6e | capabil|ity..\en|
|00000bc0| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0a 0a 5c 62 65 |d{funcde|sc}..\be|
|00000bd0| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 47 65 |gin{func|desc}{Ge|
|00000be0| 74 45 72 72 6f 72 53 74 | 72 69 6e 67 7d 7b 65 72 |tErrorSt|ring}{er|
|00000bf0| 72 6e 6f 7d 0a 52 65 74 | 75 72 6e 20 74 68 65 20 |rno}.Ret|urn the |
|00000c00| 74 65 78 74 75 61 6c 20 | 64 65 73 63 72 69 70 74 |textual |descript|
|00000c10| 69 6f 6e 20 6f 66 20 4d | 61 63 4f 53 20 65 72 72 |ion of M|acOS err|
|00000c20| 6f 72 20 63 6f 64 65 20 | 5c 76 61 72 7b 65 72 72 |or code |\var{err|
|00000c30| 6e 6f 7d 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |no}..\en|d{funcde|
|00000c40| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000c50| 64 65 73 63 7d 7b 73 70 | 6c 61 73 68 7d 7b 72 65 |desc}{sp|lash}{re|
|00000c60| 73 69 64 7d 0a 54 68 69 | 73 20 66 75 6e 63 74 69 |sid}.Thi|s functi|
|00000c70| 6f 6e 20 77 69 6c 6c 20 | 70 75 74 20 61 20 73 70 |on will |put a sp|
|00000c80| 6c 61 73 68 20 77 69 6e | 64 6f 77 0a 6f 6e 2d 73 |lash win|dow.on-s|
|00000c90| 63 72 65 65 6e 2c 20 77 | 69 74 68 20 74 68 65 20 |creen, w|ith the |
|00000ca0| 63 6f 6e 74 65 6e 74 73 | 20 6f 66 20 74 68 65 20 |contents| of the |
|00000cb0| 44 4c 4f 47 20 72 65 73 | 6f 75 72 63 65 20 73 70 |DLOG res|ource sp|
|00000cc0| 65 63 69 66 69 65 64 20 | 62 79 0a 5c 63 6f 64 65 |ecified |by.\code|
|00000cd0| 7b 72 65 73 69 64 7d 2e | 20 43 61 6c 6c 69 6e 67 |{resid}.| Calling|
|00000ce0| 20 77 69 74 68 20 61 20 | 7a 65 72 6f 20 61 72 67 | with a |zero arg|
|00000cf0| 75 6d 65 6e 74 20 77 69 | 6c 6c 20 72 65 6d 6f 76 |ument wi|ll remov|
|00000d00| 65 20 74 68 65 20 73 70 | 6c 61 73 68 0a 73 63 72 |e the sp|lash.scr|
|00000d10| 65 65 6e 2e 20 54 68 69 | 73 20 66 75 6e 63 74 69 |een. Thi|s functi|
|00000d20| 6f 6e 20 69 73 20 75 73 | 65 66 75 6c 20 69 66 20 |on is us|eful if |
|00000d30| 79 6f 75 20 77 61 6e 74 | 20 61 6e 20 61 70 70 6c |you want| an appl|
|00000d40| 65 74 20 74 6f 20 70 6f | 73 74 20 61 20 73 70 6c |et to po|st a spl|
|00000d50| 61 73 68 20 73 63 72 65 | 65 6e 0a 65 61 72 6c 79 |ash scre|en.early|
|00000d60| 20 69 6e 20 69 6e 69 74 | 69 61 6c 69 7a 61 74 69 | in init|ializati|
|00000d70| 6f 6e 20 77 69 74 68 6f | 75 74 20 66 69 72 73 74 |on witho|ut first|
|00000d80| 20 68 61 76 69 6e 67 20 | 74 6f 20 6c 6f 61 64 20 | having |to load |
|00000d90| 6e 75 6d 65 72 6f 75 73 | 0a 65 78 74 65 6e 73 69 |numerous|.extensi|
|00000da0| 6f 6e 20 6d 6f 64 75 6c | 65 73 2e 0a 5c 65 6e 64 |on modul|es..\end|
|00000db0| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00000dc0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 44 65 62 |in{funcd|esc}{Deb|
|00000dd0| 75 67 53 74 72 7d 7b 6d | 65 73 73 61 67 65 20 5c |ugStr}{m|essage \|
|00000de0| 6f 70 74 69 6f 6e 61 6c | 7b 5c 2c 20 6f 62 6a 65 |optional|{\, obje|
|00000df0| 63 74 7d 7d 0a 44 72 6f | 70 20 74 6f 20 74 68 65 |ct}}.Dro|p to the|
|00000e00| 20 6c 6f 77 2d 6c 65 76 | 65 6c 20 64 65 62 75 67 | low-lev|el debug|
|00000e10| 67 65 72 20 77 69 74 68 | 20 6d 65 73 73 61 67 65 |ger with| message|
|00000e20| 20 5c 76 61 72 7b 6d 65 | 73 73 61 67 65 7d 2e 20 | \var{me|ssage}. |
|00000e30| 54 68 65 0a 6f 70 74 69 | 6f 6e 61 6c 20 5c 76 61 |The.opti|onal \va|
|00000e40| 72 7b 6f 62 6a 65 63 74 | 7d 20 61 72 67 75 6d 65 |r{object|} argume|
|00000e50| 6e 74 20 69 73 20 6e 6f | 74 20 75 73 65 64 2c 20 |nt is no|t used, |
|00000e60| 62 75 74 20 63 61 6e 20 | 65 61 73 69 6c 79 20 62 |but can |easily b|
|00000e70| 65 0a 69 6e 73 70 65 63 | 74 65 64 20 66 72 6f 6d |e.inspec|ted from|
|00000e80| 20 74 68 65 20 64 65 62 | 75 67 67 65 72 2e 0a 0a | the deb|ugger...|
|00000e90| 4e 6f 74 65 20 74 68 61 | 74 20 79 6f 75 20 73 68 |Note tha|t you sh|
|00000ea0| 6f 75 6c 64 20 75 73 65 | 20 74 68 69 73 20 66 75 |ould use| this fu|
|00000eb0| 6e 63 74 69 6f 6e 20 77 | 69 74 68 20 65 78 74 72 |nction w|ith extr|
|00000ec0| 65 6d 65 20 63 61 72 65 | 3a 20 69 66 20 6e 6f 0a |eme care|: if no.|
|00000ed0| 6c 6f 77 2d 6c 65 76 65 | 6c 20 64 65 62 75 67 67 |low-leve|l debugg|
|00000ee0| 65 72 20 6c 69 6b 65 20 | 4d 61 63 73 42 75 67 20 |er like |MacsBug |
|00000ef0| 69 73 20 69 6e 73 74 61 | 6c 6c 65 64 20 74 68 69 |is insta|lled thi|
|00000f00| 73 20 63 61 6c 6c 20 77 | 69 6c 6c 20 63 72 61 73 |s call w|ill cras|
|00000f10| 68 20 79 6f 75 72 0a 73 | 79 73 74 65 6d 2e 20 49 |h your.s|ystem. I|
|00000f20| 74 20 69 73 20 69 6e 74 | 65 6e 64 65 64 20 6d 61 |t is int|ended ma|
|00000f30| 69 6e 6c 79 20 66 6f 72 | 20 64 65 76 65 6c 6f 70 |inly for| develop|
|00000f40| 65 72 73 20 6f 66 20 50 | 79 74 68 6f 6e 20 65 78 |ers of P|ython ex|
|00000f50| 74 65 6e 73 69 6f 6e 0a | 6d 6f 64 75 6c 65 73 2e |tension.|modules.|
|00000f60| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00000f70| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00000f80| 7d 7b 6f 70 65 6e 72 66 | 7d 7b 6e 61 6d 65 20 5c |}{openrf|}{name \|
|00000f90| 6f 70 74 69 6f 6e 61 6c | 7b 5c 2c 20 6d 6f 64 65 |optional|{\, mode|
|00000fa0| 7d 7d 0a 4f 70 65 6e 20 | 74 68 65 20 72 65 73 6f |}}.Open |the reso|
|00000fb0| 75 72 63 65 20 66 6f 72 | 6b 20 6f 66 20 61 20 66 |urce for|k of a f|
|00000fc0| 69 6c 65 2e 20 41 72 67 | 75 6d 65 6e 74 73 20 61 |ile. Arg|uments a|
|00000fd0| 72 65 20 74 68 65 20 73 | 61 6d 65 20 61 73 20 66 |re the s|ame as f|
|00000fe0| 6f 72 20 74 68 65 0a 62 | 75 69 6c 74 69 6e 20 66 |or the.b|uiltin f|
|00000ff0| 75 6e 63 74 69 6f 6e 20 | 5c 63 6f 64 65 7b 6f 70 |unction |\code{op|
|00001000| 65 6e 7d 2e 20 54 68 65 | 20 6f 62 6a 65 63 74 20 |en}. The| object |
|00001010| 72 65 74 75 72 6e 65 64 | 20 68 61 73 20 66 69 6c |returned| has fil|
|00001020| 65 2d 6c 69 6b 65 0a 73 | 65 6d 61 6e 74 69 63 73 |e-like.s|emantics|
|00001030| 2c 20 62 75 74 20 69 74 | 20 69 73 20 6e 6f 74 20 |, but it| is not |
|00001040| 61 20 70 79 74 68 6f 6e | 20 66 69 6c 65 20 6f 62 |a python| file ob|
|00001050| 6a 65 63 74 2c 20 73 6f | 20 74 68 65 72 65 20 6d |ject, so| there m|
|00001060| 61 79 20 62 65 20 73 75 | 62 74 6c 65 0a 64 69 66 |ay be su|btle.dif|
|00001070| 66 65 72 65 6e 63 65 73 | 2e 0a 5c 65 6e 64 7b 66 |ferences|..\end{f|
|00001080| 75 6e 63 64 65 73 63 7d | 0a                      |uncdesc}|.       |
+--------+-------------------------+-------------------------+--------+--------+