/ APDL Public Domain 1 / APDL_PD1A.iso / program / c / desklib / docs

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 41 72 63 68 69 76 65 00 | 80 04 00 00 24 06 00 00 |Archive.|....$...|
|00000010| 28 00 00 00 64 00 00 00 | 00 00 00 00 00 00 00 00 |(...d...|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000050| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000060| 82 21 4d 61 6b 65 4e 6f | 74 65 00 00 35 13 00 00 |.!MakeNo|te..5...|
|00000070| 45 ff ff ff b7 36 98 a8 | 03 00 dd 40 35 13 00 00 |E....6..|...@5...|
|00000080| 24 00 00 00 82 41 62 6f | 75 74 44 4c 00 00 00 00 |$....Abo|utDL....|
|00000090| a3 33 00 00 45 ff ff ff | 9d 13 e8 d3 03 00 6a 7e |.3..E...|......j~|
|000000a0| a3 33 00 00 7d 13 00 00 | 82 41 75 74 68 6f 72 4e |.3..}...|.AuthorN|
|000000b0| 6f 74 65 00 12 66 00 00 | 44 ff ff ff f8 e3 ff 88 |ote..f..|D.......|
|000000c0| 13 00 29 2e 12 66 00 00 | 44 47 00 00 82 42 6c 61 |..)..f..|DG...Bla|
|000000d0| 6e 6b 73 00 6d 6e 74 00 | ff ff ff ff 45 dc fd ff |nks.mnt.|....E...|
|000000e0| cc 71 60 d4 10 00 00 00 | ff ff ff ff 1c 02 00 80 |.q`.....|........|
|000000f0| 82 46 69 6c 65 48 65 61 | 64 65 72 00 39 03 00 00 |.FileHea|der.9...|
|00000100| 45 ff ff ff 3b ac 58 5d | 03 00 d7 81 39 03 00 00 |E...;.X]|....9...|
|00000110| af 4d 01 00 82 48 65 6c | 70 43 6f 6d 6d 6e 74 00 |.M...Hel|pCommnt.|
|00000120| ff ff ff ff 45 dc fd ff | 19 72 60 d4 00 00 00 00 |....E...|.r`.....|
|00000130| ff ff ff ff d4 01 00 80 | 82 43 6c 61 73 73 00 6d |........|.Class.m|
|00000140| 6d 6e 74 00 dc 00 00 00 | 45 ff ff ff 34 ee e8 44 |mnt.....|E...4..D|
|00000150| 03 00 37 2e dc 00 00 00 | 0c 51 01 00 82 46 75 6e |..7.....|.Q...Fun|
|00000160| 44 65 63 00 6d 6e 74 00 | 43 01 00 00 45 ff ff ff |Dec.mnt.|C...E...|
|00000170| 0a 69 4d 40 03 00 fd 27 | 43 01 00 00 0c 52 01 00 |.iM@...'|C....R..|
|00000180| 82 46 75 6e 44 65 66 00 | 6d 6e 74 00 f8 00 00 00 |.FunDef.|mnt.....|
|00000190| 45 ff ff ff ae 66 4d 40 | 03 00 3a a0 f8 00 00 00 |E....fM@|..:.....|
|000001a0| 73 53 01 00 82 4d 61 63 | 72 6f 00 6d 6d 6e 74 00 |sS...Mac|ro.mmnt.|
|000001b0| 54 01 00 00 45 ff ff ff | 0d 78 4d 40 03 00 62 6c |T...E...|.xM@..bl|
|000001c0| 54 01 00 00 8f 54 01 00 | 82 54 79 70 65 44 65 66 |T....T..|.TypeDef|
|000001d0| 00 6e 74 00 19 01 00 00 | 45 ff ff ff 35 7b e9 44 |.nt.....|E...5{.D|
|000001e0| 03 00 76 66 19 01 00 00 | 07 56 01 00 82 56 61 72 |..vf....|.V...Var|
|000001f0| 69 61 62 6c 65 00 74 00 | 0a 01 00 00 45 ff ff ff |iable.t.|....E...|
|00000200| 36 ac f3 44 03 00 1f 49 | 0a 01 00 00 44 57 01 00 |6..D...I|....DW..|
|00000210| 00 48 65 6c 70 43 6f 6d | 6d 6e 74 00 f5 17 00 00 |.HelpCom|mnt.....|
|00000220| 45 ff ff ff 7c 6e 59 5d | 03 00 50 52 f5 17 00 00 |E...|nY]|..PR....|
|00000230| 7a ad 00 00 82 4d 61 6b | 65 66 69 6c 65 00 00 00 |z....Mak|efile...|
|00000240| 0f 02 00 00 45 ff ff ff | 48 91 98 a8 03 00 88 4a |....E...|H......J|
|00000250| 0f 02 00 00 72 58 01 00 | 00 55 70 64 61 74 65 73 |....rX..|.Updates|
|00000260| 00 00 00 00 f8 87 00 00 | 45 ff ff ff a0 30 f0 d3 |........|E....0..|
|00000270| 03 00 24 1c f8 87 00 00 | 93 c5 00 00 82 48 65 6c |..$.....|.....Hel|
|00000280| 70 43 6f 6d 6d 6e 74 00 | f5 17 00 00 45 ff ff ff |pCommnt.|....E...|
|00000290| 7c 6e 59 5d 03 00 50 52 | f5 17 00 00 7a ad 00 00 ||nY]..PR|....z...|
|000002a0| 82 4d 6f 64 75 6c 65 4e | 6f 74 65 00 ff ff ff ff |.ModuleN|ote.....|
|000002b0| 45 dc fd ff e3 73 60 d4 | 10 00 00 00 ff ff ff ff |E....s`.|........|
|000002c0| 60 03 00 80 82 21 50 75 | 72 70 6f 73 65 00 00 00 |`....!Pu|rpose...|
|000002d0| 30 02 00 00 43 ff ff ff | 50 5b b4 cc 13 00 39 f2 |0...C...|P[....9.|
|000002e0| 30 02 00 00 a5 5a 01 00 | 82 45 76 65 6e 74 00 00 |0....Z..|.Event..|
|000002f0| 00 00 00 00 12 06 00 00 | 43 ff ff ff d0 ad b4 cc |........|C.......|
|00000300| 13 00 13 e7 12 06 00 00 | f9 5c 01 00 82 4d 65 6d |........|.\...Mem|
|00000310| 00 00 00 00 00 00 00 00 | cb 17 00 00 44 ff ff ff |........|....D...|
|00000320| 0b ab 0e 99 13 00 80 34 | cb 17 00 00 2f 63 01 00 |.......4|..../c..|
|00000330| 82 4d 73 67 73 00 00 00 | 00 00 00 00 3c 1d 00 00 |.Msgs...|....<...|
|00000340| 44 ff ff ff 9a b3 55 92 | 13 00 29 49 3c 1d 00 00 |D.....U.|..)I<...|
|00000350| 1e 7b 01 00 82 50 6f 70 | 55 70 73 00 00 00 00 00 |.{...Pop|Ups.....|
|00000360| 90 0d 00 00 44 ff ff ff | 30 cc b6 b4 13 00 30 f0 |....D...|0.....0.|
|00000370| 90 0d 00 00 7e 98 01 00 | 82 57 69 6e 64 6f 77 00 |....~...|.Window.|
|00000380| 00 00 00 00 65 07 00 00 | 44 ff ff ff ae 8c 73 81 |....e...|D.....s.|
|00000390| 13 00 b3 49 65 07 00 00 | 32 a6 01 00 00 00 00 00 |...Ie...|2.......|
|000003a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000003b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000003c0| 82 51 75 69 63 6b 52 65 | 66 73 00 00 ff ff ff ff |.QuickRe|fs......|
|000003d0| 45 dc fd ff b5 75 60 d4 | 10 00 00 00 ff ff ff ff |E....u`.|........|
|000003e0| 38 04 00 80 82 42 72 69 | 65 66 47 75 69 64 65 00 |8....Bri|efGuide.|
|000003f0| 6d 15 00 00 44 ff ff ff | e2 b3 7e 99 13 00 5f ed |m...D...|..~..._.|
|00000400| 6d 15 00 00 bb ad 01 00 | 82 45 76 65 6e 74 44 61 |m.......|.EventDa|
|00000410| 74 61 00 00 e7 14 00 00 | 44 ff ff ff 87 c4 55 92 |ta......|D.....U.|
|00000420| 13 00 69 8f e7 14 00 00 | 4c c3 01 00 82 49 63 6f |..i.....|L....Ico|
|00000430| 6e 44 61 74 61 00 00 00 | f0 17 00 00 44 ff ff ff |nData...|....D...|
|00000440| 95 72 e6 ef 13 00 e7 f7 | f0 17 00 00 57 d8 01 00 |.r......|....W...|
|00000450| 82 57 69 6e 64 6f 77 44 | 61 74 61 00 dc 16 00 00 |.WindowD|ata.....|
|00000460| 44 ff ff ff 47 a4 93 9a | 13 00 7a 6c dc 16 00 00 |D...G...|..zl....|
|00000470| 6b f0 01 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |k.......|........|
|00000480| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000490| 00 00 00 00 00 00 00 00 | 82 55 70 64 61 74 65 73 |........|.Updates|
|000004a0| 00 00 00 00 f8 87 00 00 | 45 ff ff ff a0 30 f0 d3 |........|E....0..|
|000004b0| 03 00 24 1c f8 87 00 00 | 93 c5 00 00 00 00 00 00 |..$.....|........|
|000004c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000004d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000004e0| 61 73 20 27 73 65 65 6e | 27 20 74 68 65 20 22 21 |as 'seen|' the "!|
|000004f0| 44 65 73 6b 4c 69 62 22 | 20 61 70 70 6c 69 63 61 |DeskLib"| applica|
|00000500| 74 69 6f 6e 0a 0a 54 68 | 69 73 20 73 68 6f 75 6c |tion..Th|is shoul|
|00000510| 64 20 62 65 20 75 73 65 | 64 20 69 6e 20 79 6f 75 |d be use|d in you|
|00000520| 72 20 70 72 6f 67 72 61 | 6d 73 20 61 73 20 69 6e |r progra|ms as in|
|00000530| 3a 0a 20 20 23 69 6e 63 | 6c 75 64 65 20 22 44 65 |:.  #inc|lude "De|
|00000540| 73 6b 4c 69 62 3a 49 63 | 6f 6e 2e 68 22 0a 0a 57 |skLib:Ic|on.h"..W|
|00000550| 68 65 6e 20 6c 69 6e 6b | 69 6e 67 2c 20 79 6f 75 |hen link|ing, you|
|00000560| 20 63 61 6e 20 75 73 65 | 20 22 44 65 73 6b 4c 69 | can use| "DeskLi|
|00000570| 62 3a 6f 2e 44 65 73 6b | 4c 69 62 22 0a 48 6f 77 |b:o.Desk|Lib".How|
|00000580| 65 76 65 72 2c 20 21 44 | 65 73 6b 4c 69 62 20 61 |ever, !D|eskLib a|
|00000590| 6c 73 6f 20 61 64 64 73 | 20 69 74 73 65 6c 66 20 |lso adds| itself |
|000005a0| 6f 6e 74 6f 20 74 68 65 | 20 65 6e 64 20 6f 66 20 |onto the| end of |
|000005b0| 43 24 50 61 74 68 2c 20 | 73 6f 20 43 3a 6f 2e 44 |C$Path, |so C:o.D|
|000005c0| 65 73 6b 4c 69 62 0a 77 | 69 6c 6c 20 73 75 66 66 |eskLib.w|ill suff|
|000005d0| 69 63 65 2e 0a 0a 2d 2d | 2d 0a 0a 49 6e 20 65 76 |ice...--|-..In ev|
|000005e0| 65 72 79 20 73 75 62 64 | 69 72 65 63 74 6f 72 79 |ery subd|irectory|
|000005f0| 20 6f 66 20 64 65 73 6b | 6c 69 62 20 74 68 61 74 | of desk|lib that|
|00000600| 20 63 61 6e 20 62 65 20 | 22 6d 61 64 65 22 2c 20 | can be |"made", |
|00000610| 74 68 65 72 65 20 69 73 | 20 61 20 6d 61 6b 65 66 |there is| a makef|
|00000620| 69 6c 65 0a 46 69 6c 65 | 44 61 74 61 82 21 4d 61 |ile.File|Data.!Ma|
|00000630| 6b 65 4e 6f 74 65 00 00 | 35 13 00 00 45 ff ff ff |keNote..|5...E...|
|00000640| b7 36 98 a8 03 00 dd 40 | 4e 6f 74 65 73 20 6f 6e |.6.....@|Notes on|
|00000650| 20 63 6f 6d 70 69 6c 69 | 6e 67 20 44 65 73 6b 4c | compili|ng DeskL|
|00000660| 69 62 0a 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |ib.=====|========|
|00000670| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 0a 0a 53 |========|=====..S|
|00000680| 6f 6d 65 20 6f 66 20 74 | 68 65 20 73 75 62 2d 6c |ome of t|he sub-l|
|00000690| 69 62 72 61 72 69 65 73 | 20 6e 65 65 64 20 74 6f |ibraries| need to|
|000006a0| 20 69 6e 63 6c 75 64 65 | 20 6d 61 69 6e 20 44 65 | include| main De|
|000006b0| 73 6b 4c 69 62 20 2e 68 | 20 66 69 6c 65 73 2e 20 |skLib .h| files. |
|000006c0| 54 68 65 79 20 65 78 70 | 65 63 74 0a 74 68 65 20 |They exp|ect.the |
|000006d0| 53 79 73 74 65 6d 20 56 | 61 72 69 61 62 6c 65 20 |System V|ariable |
|000006e0| 44 65 73 6b 4c 69 62 24 | 50 61 74 68 20 74 6f 20 |DeskLib$|Path to |
|000006f0| 62 65 20 73 65 74 20 75 | 70 20 77 69 74 68 20 74 |be set u|p with t|
|00000700| 68 65 20 66 75 6c 6c 20 | 70 61 74 68 6e 61 6d 65 |he full |pathname|
|00000710| 20 6f 66 20 74 68 65 0a | 6d 61 69 6e 20 64 65 73 | of the.|main des|
|00000720| 6b 6c 69 62 20 64 69 72 | 65 63 74 6f 72 79 2c 20 |klib dir|ectory, |
|00000730| 61 73 20 69 6e 3a 0a 0a | 20 20 53 65 74 20 44 65 |as in:..|  Set De|
|00000740| 73 6b 4c 69 62 24 50 61 | 74 68 20 41 44 46 53 3a |skLib$Pa|th ADFS:|
|00000750| 3a 34 2e 24 2e 43 5f 57 | 6f 72 6b 2e 44 65 73 6b |:4.$.C_W|ork.Desk|
|00000760| 4c 69 62 2e 0a 0a 28 54 | 68 65 20 66 75 6c 6c 73 |Lib...(T|he fulls|
|00000770| 74 6f 70 20 61 74 20 74 | 68 65 20 65 6e 64 20 69 |top at t|he end i|
|00000780| 73 20 76 69 74 61 6c 29 | 0a 54 68 69 73 20 69 73 |s vital)|.This is|
|00000790| 20 63 6f 72 72 65 63 74 | 6c 79 20 73 65 74 20 75 | correct|ly set u|
|000007a0| 70 20 69 66 20 74 68 65 | 20 66 69 6c 65 72 20 68 |p if the| filer h|
|000007b0| 61 73 20 27 73 65 65 6e | 27 20 74 68 65 20 22 21 |as 'seen|' the "!|
|000007c0| 44 65 73 6b 4c 69 62 22 | 20 61 70 70 6c 69 63 61 |DeskLib"| applica|
|000007d0| 74 69 6f 6e 0a 0a 54 68 | 69 73 20 73 68 6f 75 6c |tion..Th|is shoul|
|000007e0| 64 20 62 65 20 75 73 65 | 64 20 69 6e 20 79 6f 75 |d be use|d in you|
|000007f0| 72 20 70 72 6f 67 72 61 | 6d 73 20 61 73 20 69 6e |r progra|ms as in|
|00000800| 3a 0a 20 20 23 69 6e 63 | 6c 75 64 65 20 22 44 65 |:.  #inc|lude "De|
|00000810| 73 6b 4c 69 62 3a 49 63 | 6f 6e 2e 68 22 0a 0a 57 |skLib:Ic|on.h"..W|
|00000820| 68 65 6e 20 6c 69 6e 6b | 69 6e 67 2c 20 79 6f 75 |hen link|ing, you|
|00000830| 20 63 61 6e 20 75 73 65 | 20 22 44 65 73 6b 4c 69 | can use| "DeskLi|
|00000840| 62 3a 6f 2e 44 65 73 6b | 4c 69 62 22 0a 48 6f 77 |b:o.Desk|Lib".How|
|00000850| 65 76 65 72 2c 20 21 44 | 65 73 6b 4c 69 62 20 61 |ever, !D|eskLib a|
|00000860| 6c 73 6f 20 61 64 64 73 | 20 69 74 73 65 6c 66 20 |lso adds| itself |
|00000870| 6f 6e 74 6f 20 74 68 65 | 20 65 6e 64 20 6f 66 20 |onto the| end of |
|00000880| 43 24 50 61 74 68 2c 20 | 73 6f 20 43 3a 6f 2e 44 |C$Path, |so C:o.D|
|00000890| 65 73 6b 4c 69 62 0a 77 | 69 6c 6c 20 73 75 66 66 |eskLib.w|ill suff|
|000008a0| 69 63 65 2e 0a 0a 2d 2d | 2d 0a 0a 49 6e 20 65 76 |ice...--|-..In ev|
|000008b0| 65 72 79 20 73 75 62 64 | 69 72 65 63 74 6f 72 79 |ery subd|irectory|
|000008c0| 20 6f 66 20 64 65 73 6b | 6c 69 62 20 74 68 61 74 | of desk|lib that|
|000008d0| 20 63 61 6e 20 62 65 20 | 22 6d 61 64 65 22 2c 20 | can be |"made", |
|000008e0| 74 68 65 72 65 20 69 73 | 20 61 20 6d 61 6b 65 66 |there is| a makef|
|000008f0| 69 6c 65 0a 0a 54 68 69 | 73 20 63 61 6e 20 62 65 |ile..Thi|s can be|
|00000900| 20 6d 6f 64 69 66 69 65 | 64 20 73 6c 69 67 68 74 | modifie|d slight|
|00000910| 6c 79 20 74 6f 20 6d 61 | 6b 65 20 6a 75 73 74 20 |ly to ma|ke just |
|00000920| 74 68 61 74 20 73 65 63 | 74 69 6f 6e 20 6f 66 20 |that sec|tion of |
|00000930| 74 68 65 20 6c 69 62 72 | 61 72 79 20 61 73 20 61 |the libr|ary as a|
|00000940| 0a 73 65 70 65 72 61 74 | 65 20 6c 69 62 72 61 72 |.seperat|e librar|
|00000950| 79 20 66 69 6c 65 2c 20 | 69 66 20 79 6f 75 20 64 |y file, |if you d|
|00000960| 6f 6e 27 74 20 6e 65 65 | 64 20 61 6c 6c 20 6f 66 |on't nee|d all of|
|00000970| 20 74 68 65 20 64 65 73 | 6b 6c 69 62 20 66 75 6e | the des|klib fun|
|00000980| 63 74 69 6f 6e 73 2e 20 | 54 68 69 73 0a 69 73 20 |ctions. |This.is |
|00000990| 64 6f 6e 65 20 75 73 69 | 6e 67 20 27 6c 69 62 66 |done usi|ng 'libf|
|000009a0| 69 6c 65 27 2e 20 57 69 | 6d 70 53 57 49 73 20 61 |ile'. Wi|mpSWIs a|
|000009b0| 6c 72 65 61 64 79 20 75 | 73 65 73 20 74 68 69 73 |lready u|ses this|
|000009c0| 20 74 6f 20 70 72 6f 64 | 75 63 65 20 61 20 73 65 | to prod|uce a se|
|000009d0| 63 6f 6e 64 61 72 79 0a | 6c 69 62 72 61 72 79 20 |condary.|library |
|000009e0| 66 69 6c 65 20 28 73 6f | 20 74 6f 20 75 73 65 20 |file (so| to use |
|000009f0| 57 49 4d 50 20 73 77 69 | 73 20 79 6f 75 20 65 69 |WIMP swi|s you ei|
|00000a00| 74 68 65 72 20 69 6e 63 | 6c 75 64 65 20 44 65 73 |ther inc|lude Des|
|00000a10| 6b 4c 69 62 20 4f 52 20 | 57 69 6d 70 4c 69 62 29 |kLib OR |WimpLib)|
|00000a20| 0a 0a 54 6f 20 6d 61 6b | 65 20 61 6e 79 20 70 6f |..To mak|e any po|
|00000a30| 72 74 69 6f 6e 20 6f 66 | 20 44 65 73 6b 4c 69 62 |rtion of| DeskLib|
|00000a40| 2c 20 75 73 65 20 61 6d | 75 20 6f 6e 20 74 68 65 |, use am|u on the|
|00000a50| 20 4d 61 6b 65 46 69 6c | 65 20 61 73 20 6e 6f 72 | MakeFil|e as nor|
|00000a60| 6d 61 6c 2e 0a 4e 6f 74 | 65 20 74 68 61 74 20 74 |mal..Not|e that t|
|00000a70| 68 65 73 65 20 6d 61 6b | 65 66 69 6c 65 73 20 70 |hese mak|efiles p|
|00000a80| 72 6f 62 61 62 6c 79 20 | 64 6f 6e 27 74 20 77 6f |robably |don't wo|
|00000a90| 72 6b 20 77 69 74 68 20 | 21 4d 61 6b 65 2c 20 62 |rk with |!Make, b|
|00000aa0| 75 74 20 64 6f 65 73 20 | 61 6e 79 62 6f 64 79 0a |ut does |anybody.|
|00000ab0| 72 65 61 6c 6c 79 20 6c | 69 6b 65 20 21 4d 61 6b |really l|ike !Mak|
|00000ac0| 65 20 65 6e 6f 75 67 68 | 20 74 6f 20 75 73 65 20 |e enough| to use |
|00000ad0| 69 74 20 61 6e 79 77 61 | 79 3f 20 55 73 65 20 21 |it anywa|y? Use !|
|00000ae0| 45 64 69 74 2e 2e 2e 20 | 69 74 27 73 20 65 61 73 |Edit... |it's eas|
|00000af0| 69 65 72 20 61 6e 64 0a | 71 75 69 63 6b 65 72 20 |ier and.|quicker |
|00000b00| 28 6f 68 2c 20 61 6e 64 | 20 61 6d 75 20 74 61 6b |(oh, and| amu tak|
|00000b10| 65 73 20 6d 75 63 68 21 | 21 20 6c 65 73 73 20 6d |es much!|! less m|
|00000b20| 65 6d 6f 72 79 20 74 68 | 61 6e 20 21 4d 61 6b 65 |emory th|an !Make|
|00000b30| 29 2e 0a 0a 2d 2d 2d 0a | 0a 49 66 20 79 6f 75 20 |)...---.|.If you |
|00000b40| 64 6f 20 6e 6f 74 20 68 | 61 76 65 20 74 68 65 20 |do not h|ave the |
|00000b50| 41 63 6f 72 6e 20 61 73 | 73 65 6d 62 6c 65 72 2c |Acorn as|sembler,|
|00000b60| 20 74 68 65 6e 20 62 65 | 20 76 65 72 79 20 63 61 | then be| very ca|
|00000b70| 72 65 66 75 6c 20 6e 6f | 74 20 74 6f 20 64 65 6c |reful no|t to del|
|00000b80| 65 74 65 0a 61 6e 79 20 | 6f 66 20 74 68 65 20 70 |ete.any |of the p|
|00000b90| 72 65 63 6f 6d 70 69 6c | 65 64 20 2e 6f 20 66 69 |recompil|ed .o fi|
|00000ba0| 6c 65 73 2c 20 61 73 20 | 79 6f 75 20 77 69 6c 6c |les, as |you will|
|00000bb0| 20 6e 6f 74 20 62 65 20 | 61 62 6c 65 20 74 6f 20 | not be |able to |
|00000bc0| 72 65 2d 6d 61 6b 65 20 | 74 68 65 6d 0a 77 69 74 |re-make |them.wit|
|00000bd0| 68 6f 75 74 20 74 68 65 | 20 61 73 73 65 6d 62 6c |hout the| assembl|
|00000be0| 65 72 2e 20 49 66 20 73 | 6f 6d 65 6f 6e 65 20 63 |er. If s|omeone c|
|00000bf0| 61 6e 20 62 65 20 62 6f | 74 68 65 72 65 64 2c 20 |an be bo|thered, |
|00000c00| 61 20 54 4c 41 2d 63 6f | 6d 70 61 74 69 62 6c 65 |a TLA-co|mpatible|
|00000c10| 20 76 65 72 73 69 6f 6e | 0a 6f 66 20 61 73 73 65 | version|.of asse|
|00000c20| 6d 62 6c 65 72 20 6c 69 | 62 72 61 72 69 65 73 20 |mbler li|braries |
|00000c30| 6d 61 79 20 62 65 20 6d | 61 64 65 20 61 76 61 69 |may be m|ade avai|
|00000c40| 6c 61 62 6c 65 20 69 6e | 20 74 68 65 20 66 75 74 |lable in| the fut|
|00000c50| 75 72 65 2e 0a 0a 41 6c | 6c 20 43 20 70 6f 72 74 |ure...Al|l C port|
|00000c60| 69 6f 6e 73 20 6f 66 20 | 74 68 65 20 6c 69 62 72 |ions of |the libr|
|00000c70| 61 72 79 20 6d 61 79 20 | 62 65 20 73 75 70 70 6c |ary may |be suppl|
|00000c80| 69 65 64 20 61 73 20 73 | 6f 75 72 63 65 20 6f 6e |ied as s|ource on|
|00000c90| 6c 79 2e 0a 54 68 65 20 | 66 69 6e 61 6c 20 44 65 |ly..The |final De|
|00000ca0| 73 6b 4c 69 62 20 6c 69 | 62 72 61 72 79 20 69 73 |skLib li|brary is|
|00000cb0| 20 61 6c 73 6f 20 70 72 | 6f 76 69 64 65 64 20 73 | also pr|ovided s|
|00000cc0| 6f 20 79 6f 75 20 63 61 | 6e 20 73 74 61 72 74 20 |o you ca|n start |
|00000cd0| 75 73 69 6e 67 20 69 74 | 20 77 69 74 68 6f 75 74 |using it| without|
|00000ce0| 0a 68 61 76 69 6e 67 20 | 74 6f 20 73 70 65 6e 64 |.having |to spend|
|00000cf0| 20 32 30 20 6d 69 6e 75 | 74 65 73 20 28 6f 72 20 | 20 minu|tes (or |
|00000d00| 33 37 20 73 65 63 6f 6e | 64 73 20 66 6f 72 20 52 |37 secon|ds for R|
|00000d10| 69 73 63 50 43 20 6f 77 | 6e 65 72 73 20 3b 2d 29 |iscPC ow|ners ;-)|
|00000d20| 20 63 6f 6d 70 69 6c 69 | 6e 67 0a 66 69 72 73 74 | compili|ng.first|
|00000d30| 21 0a 0a 4e 6f 74 65 20 | 74 68 61 74 20 44 65 73 |!..Note |that Des|
|00000d40| 6b 4c 69 62 20 72 65 6c | 69 65 73 20 6f 6e 20 74 |kLib rel|ies on t|
|00000d50| 68 65 20 64 69 72 65 63 | 74 6f 72 79 20 73 74 72 |he direc|tory str|
|00000d60| 75 63 74 75 72 65 20 61 | 73 20 73 75 70 70 6c 69 |ucture a|s suppli|
|00000d70| 65 64 3a 20 49 66 20 79 | 6f 75 0a 6d 6f 76 65 20 |ed: If y|ou.move |
|00000d80| 28 66 6f 72 20 65 78 61 | 6d 70 6c 65 29 20 65 69 |(for exa|mple) ei|
|00000d90| 74 68 65 72 20 74 68 65 | 20 21 54 65 73 74 41 70 |ther the| !TestAp|
|00000da0| 70 20 6f 72 20 57 69 6d | 70 53 57 49 73 20 64 69 |p or Wim|pSWIs di|
|00000db0| 72 65 63 74 6f 72 69 65 | 73 2c 20 74 68 65 6e 20 |rectorie|s, then |
|00000dc0| 74 68 65 79 0a 28 61 6e | 64 20 6f 74 68 65 72 20 |they.(an|d other |
|00000dd0| 74 68 69 6e 67 73 29 20 | 6d 61 79 20 66 61 69 6c |things) |may fail|
|00000de0| 20 74 6f 20 63 6f 6d 70 | 69 6c 65 2c 20 61 73 20 | to comp|ile, as |
|00000df0| 74 68 65 20 73 6f 75 72 | 63 65 2f 6c 69 62 72 61 |the sour|ce/libra|
|00000e00| 72 69 65 73 20 72 65 66 | 65 72 65 6e 63 65 64 0a |ries ref|erenced.|
|00000e10| 62 79 20 74 68 65 73 65 | 20 74 68 69 6e 67 73 20 |by these| things |
|00000e20| 77 69 6c 6c 20 6e 6f 74 | 20 62 65 20 61 76 61 69 |will not| be avai|
|00000e30| 6c 61 62 6c 65 20 74 6f | 20 74 68 65 20 72 65 73 |lable to| the res|
|00000e40| 74 20 6f 66 20 74 68 65 | 20 6c 69 62 72 61 72 79 |t of the| library|
|00000e50| 2e 0a 48 6f 77 65 76 65 | 72 2c 20 74 68 65 73 65 |..Howeve|r, these|
|00000e60| 20 64 65 70 65 6e 64 65 | 6e 63 69 65 73 20 61 72 | depende|ncies ar|
|00000e70| 65 20 6f 6e 6c 79 20 63 | 61 75 73 65 64 20 62 79 |e only c|aused by|
|00000e80| 20 74 68 65 20 6c 61 79 | 6f 75 74 20 6f 66 20 74 | the lay|out of t|
|00000e90| 68 65 20 6d 61 6b 65 66 | 69 6c 65 73 2c 0a 73 6f |he makef|iles,.so|
|00000ea0| 20 69 66 20 79 6f 75 20 | 77 69 73 68 20 74 6f 20 | if you |wish to |
|00000eb0| 6d 6f 76 65 20 73 74 75 | 66 66 20 61 72 6f 75 6e |move stu|ff aroun|
|00000ec0| 64 2c 20 61 6c 74 65 72 | 20 74 68 65 20 4d 61 6b |d, alter| the Mak|
|00000ed0| 65 46 69 6c 65 73 20 74 | 6f 20 73 75 69 74 2e 0a |eFiles t|o suit..|
|00000ee0| 0a 2d 2d 2d 0a 0a 54 68 | 65 20 64 69 72 65 63 74 |.---..Th|e direct|
|00000ef0| 6f 72 79 20 73 74 72 75 | 63 74 75 72 65 20 6f 66 |ory stru|cture of|
|00000f00| 20 44 65 73 6b 4c 69 62 | 20 69 73 20 61 73 20 66 | DeskLib| is as f|
|00000f10| 6f 6c 6c 6f 77 73 3a 0a | 0a 44 65 73 6b 4c 69 62 |ollows:.|.DeskLib|
|00000f20| 0a 20 7c 0a 20 7c 5f 5f | 5f 5f 5f 5f 5f 5f 20 21 |. |. |__|______ !|
|00000f30| 44 65 73 6b 4c 69 62 20 | 20 20 44 65 73 6b 4c 69 |DeskLib |  DeskLi|
|00000f40| 62 20 63 6f 6d 70 69 6c | 65 2d 74 69 6d 65 20 72 |b compil|e-time r|
|00000f50| 65 73 6f 75 72 63 65 73 | 0a 20 7c 20 20 20 20 20 |esources|. |     |
|00000f60| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 54 |        |       T|
|00000f70| 68 69 73 20 63 6f 6e 74 | 61 69 6e 73 20 74 68 65 |his cont|ains the|
|00000f80| 20 68 65 61 64 65 72 20 | 28 2e 68 29 20 66 69 6c | header |(.h) fil|
|00000f90| 65 73 2c 20 61 73 20 77 | 65 6c 6c 20 61 73 20 74 |es, as w|ell as t|
|00000fa0| 68 65 0a 20 7c 20 20 20 | 20 20 20 20 20 20 20 20 |he. |   |        |
|00000fb0| 20 20 20 20 20 20 20 20 | 20 63 6f 6d 70 6c 65 74 |        | complet|
|00000fc0| 65 20 44 65 73 6b 4c 69 | 62 20 6c 69 62 72 61 72 |e DeskLi|b librar|
|00000fd0| 79 20 66 69 6c 65 2e 20 | 54 68 69 73 20 69 73 20 |y file. |This is |
|00000fe0| 61 6c 6c 20 74 68 61 74 | 20 79 6f 75 20 4e 45 45 |all that| you NEE|
|00000ff0| 44 0a 20 7c 20 20 20 20 | 20 20 20 20 20 20 20 20 |D. |    |        |
|00001000| 20 20 20 20 20 20 20 20 | 74 6f 20 68 61 76 65 20 |        |to have |
|00001010| 69 6e 20 61 6e 20 65 61 | 73 79 20 74 6f 20 72 65 |in an ea|sy to re|
|00001020| 61 63 68 20 70 6c 61 63 | 65 20 66 6f 72 20 63 6f |ach plac|e for co|
|00001030| 6d 70 69 6c 69 6e 67 20 | 75 73 69 6e 67 0a 20 7c |mpiling |using. ||
|00001040| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001050| 20 20 20 20 44 65 73 6b | 4c 69 62 2e 20 28 53 65 |    Desk|Lib. (Se|
|00001060| 65 20 69 74 73 20 21 48 | 65 6c 70 20 66 6f 72 20 |e its !H|elp for |
|00001070| 6d 6f 72 65 20 64 65 74 | 61 69 6c 73 29 0a 20 7c |more det|ails). ||
|00001080| 0a 20 7c 5f 5f 5f 5f 5f | 5f 5f 5f 20 44 6f 63 73 |. |_____|___ Docs|
|00001090| 20 20 20 20 20 20 20 44 | 6f 63 75 6d 65 6e 74 61 |       D|ocumenta|
|000010a0| 74 69 6f 6e 20 66 69 6c | 65 73 0a 20 7c 20 20 20 |tion fil|es. |   |
|000010b0| 20 20 20 20 20 20 20 7c | 0a 20 7c 20 20 20 20 20 |       ||. |     |
|000010c0| 20 20 20 20 20 7c 5f 5f | 5f 5f 5f 5f 5f 5f 20 4d |     |__|______ M|
|000010d0| 6f 64 75 6c 65 4e 6f 74 | 65 20 20 45 78 74 72 61 |oduleNot|e  Extra|
|000010e0| 20 6e 6f 74 65 73 20 28 | 77 68 65 72 65 20 6e 65 | notes (|where ne|
|000010f0| 63 65 73 73 61 72 79 29 | 20 6f 6e 20 76 61 72 69 |cessary)| on vari|
|00001100| 6f 75 73 0a 20 7c 20 20 | 20 20 20 20 20 20 20 20 |ous. |  |        |
|00001110| 7c 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 ||       |        |
|00001120| 20 20 20 20 20 20 44 65 | 73 6b 4c 69 62 20 63 6f |      De|skLib co|
|00001130| 64 65 20 6d 6f 64 75 6c | 65 73 0a 20 7c 20 20 20 |de modul|es. |   |
|00001140| 20 20 20 20 20 20 20 7c | 0a 20 7c 20 20 20 20 20 |       ||. |     |
|00001150| 20 20 20 20 20 7c 5f 5f | 5f 5f 5f 5f 5f 5f 20 51 |     |__|______ Q|
|00001160| 75 69 63 6b 52 65 66 73 | 20 20 20 51 75 69 63 6b |uickRefs|   Quick|
|00001170| 20 72 65 66 65 72 65 6e | 63 65 20 66 69 6c 65 73 | referen|ce files|
|00001180| 2f 63 68 61 72 74 73 20 | 74 6f 20 6d 61 6b 65 20 |/charts |to make |
|00001190| 0a 20 7c 20 20 20 20 20 | 20 20 20 20 20 7c 20 20 |. |     |     |  |
|000011a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000011b0| 20 20 20 75 73 69 6e 67 | 20 44 65 73 6b 4c 69 62 |   using| DeskLib|
|000011c0| 20 63 6f 64 65 20 65 61 | 73 69 65 72 2e 0a 20 7c | code ea|sier.. ||
|000011d0| 20 20 20 20 20 20 20 20 | 20 20 7c 0a 20 7c 20 20 |        |  |. |  |
|000011e0| 20 20 20 20 20 20 20 20 | 7c 5f 5f 5f 5f 5f 5f 5f |        ||_______|
|000011f0| 5f 20 42 6c 61 6e 6b 73 | 20 20 20 20 20 20 42 6c |_ Blanks|      Bl|
|00001200| 61 6e 6b 20 6d 61 6b 65 | 66 69 6c 65 73 2c 20 68 |ank make|files, h|
|00001210| 65 61 64 65 72 73 2c 20 | 65 74 63 2e 0a 20 7c 0a |eaders, |etc.. |.|
|00001220| 20 7c 5f 5f 5f 5f 5f 5f | 5f 5f 20 45 78 61 6d 70 | |______|__ Examp|
|00001230| 6c 65 73 0a 20 7c 20 20 | 20 20 20 20 20 20 20 20 |les. |  |        |
|00001240| 7c 0a 20 7c 20 20 20 20 | 20 20 20 20 20 20 7c 5f ||. |    |      |_|
|00001250| 5f 5f 5f 5f 5f 5f 5f 20 | 21 54 65 73 74 41 70 70 |_______ |!TestApp|
|00001260| 20 20 20 54 65 73 74 2f | 45 78 61 6d 70 6c 65 20 |   Test/|Example |
|00001270| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 66 6f 72 20 |applicat|ion for |
|00001280| 44 65 73 6b 4c 69 62 2e | 0a 20 7c 20 20 20 20 20 |DeskLib.|. |     |
|00001290| 20 20 20 20 20 7c 20 20 | 20 20 20 20 20 20 20 20 |     |  |        |
|000012a0| 20 20 20 20 20 20 20 20 | 20 20 46 75 6c 6c 20 73 |        |  Full s|
|000012b0| 6f 75 72 63 65 73 20 61 | 72 65 20 69 6e 63 6c 75 |ources a|re inclu|
|000012c0| 64 65 64 20 77 69 74 68 | 69 6e 2e 0a 20 7c 20 20 |ded with|in.. |  |
|000012d0| 20 20 20 20 20 20 20 20 | 7c 0a 20 7c 20 20 20 20 |        ||. |    |
|000012e0| 20 20 20 20 20 20 7c 5f | 5f 5f 5f 5f 5f 5f 5f 20 |      |_|_______ |
|000012f0| 3f 20 20 20 20 20 20 20 | 20 20 20 4f 74 68 65 72 |?       |   Other|
|00001300| 20 65 78 61 6d 70 6c 65 | 73 20 6f 66 20 44 65 73 | example|s of Des|
|00001310| 6b 4c 69 62 20 75 73 61 | 67 65 0a 20 7c 20 20 20 |kLib usa|ge. |   |
|00001320| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001330| 20 20 20 20 20 20 20 20 | 20 20 20 20 54 68 65 73 |        |    Thes|
|00001340| 65 20 75 73 75 61 6c 6c | 79 20 69 6e 63 6c 75 64 |e usuall|y includ|
|00001350| 65 20 73 6f 75 72 63 65 | 73 0a 20 7c 0a 20 7c 5f |e source|s. |. |_|
|00001360| 5f 5f 5f 5f 5f 5f 5f 20 | 4f 74 68 65 72 53 72 63 |_______ |OtherSrc|
|00001370| 20 20 20 52 65 70 6f 73 | 69 74 6f 72 79 20 66 6f |   Repos|itory fo|
|00001380| 72 20 61 6e 79 20 67 65 | 6e 65 72 61 6c 20 73 6f |r any ge|neral so|
|00001390| 75 72 63 65 20 66 69 6c | 65 73 20 74 68 61 74 20 |urce fil|es that |
|000013a0| 61 72 65 20 6e 6f 74 0a | 20 7c 20 20 20 20 20 20 |are not.| |      |
|000013b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 69 6e |        |      in|
|000013c0| 63 6c 75 64 65 64 20 69 | 6e 20 74 68 65 20 44 65 |cluded i|n the De|
|000013d0| 73 6b 4c 69 62 20 6c 69 | 62 72 61 72 79 20 66 69 |skLib li|brary fi|
|000013e0| 6c 65 2e 20 54 68 65 73 | 65 20 61 72 65 20 66 6f |le. Thes|e are fo|
|000013f0| 72 0a 20 7c 20 20 20 20 | 20 20 20 20 20 20 20 20 |r. |    |        |
|00001400| 20 20 20 20 20 20 20 20 | 79 6f 75 20 74 6f 20 63 |        |you to c|
|00001410| 75 74 20 61 6e 64 20 70 | 61 73 74 65 20 69 6e 74 |ut and p|aste int|
|00001420| 6f 20 79 6f 75 72 20 6f | 77 6e 20 63 6f 64 65 20 |o your o|wn code |
|00001430| 69 6e 20 6d 6f 73 74 20 | 63 61 73 65 73 0a 20 7c |in most |cases. ||
|00001440| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001450| 20 20 20 20 28 6f 72 20 | 69 6e 20 74 68 65 20 63 |    (or |in the c|
|00001460| 61 73 65 20 6f 66 20 45 | 72 72 6f 72 2e 63 20 66 |ase of E|rror.c f|
|00001470| 6f 72 20 79 6f 75 20 74 | 6f 20 63 6f 6d 70 69 6c |or you t|o compil|
|00001480| 65 20 69 6e 0a 20 7c 20 | 20 20 20 20 20 20 20 20 |e in. | |        |
|00001490| 20 20 20 20 20 20 20 20 | 20 20 20 79 6f 75 72 73 |        |   yours|
|000014a0| 65 6c 66 20 61 73 20 79 | 6f 75 20 77 69 6c 6c 20 |elf as y|ou will |
|000014b0| 6d 6f 73 74 20 6c 69 6b | 65 6c 79 20 77 61 6e 74 |most lik|ely want|
|000014c0| 20 6d 6f 72 65 20 63 6f | 6e 74 72 6f 6c 20 6f 66 | more co|ntrol of|
|000014d0| 0a 20 7c 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |. |     |        |
|000014e0| 20 20 20 20 20 20 20 68 | 6f 77 20 65 72 72 6f 72 |       h|ow error|
|000014f0| 73 20 61 72 65 20 72 65 | 70 6f 72 74 65 64 29 0a |s are re|ported).|
|00001500| 20 7c 0a 20 7c 5f 5f 5f | 5f 5f 5f 5f 5f 20 4c 69 | |. |___|_____ Li|
|00001510| 62 72 61 72 69 65 73 0a | 20 20 20 20 20 20 20 20 |braries.|        |
|00001520| 20 20 20 20 7c 5f 5f 5f | 5f 5f 5f 5f 5f 20 21 4d |    |___|_____ !M|
|00001530| 61 6b 65 44 4c 69 62 20 | 20 20 41 6e 20 6f 62 65 |akeDLib |  An obe|
|00001540| 79 20 66 69 6c 65 20 74 | 68 61 74 20 4d 41 4b 45 |y file t|hat MAKE|
|00001550| 73 20 65 61 63 68 20 70 | 61 72 74 20 6f 66 20 0a |s each p|art of .|
|00001560| 20 20 20 20 20 20 20 20 | 20 20 20 20 7c 20 20 20 |        |    |   |
|00001570| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001580| 20 20 44 65 73 6b 4c 69 | 62 2c 20 61 6e 64 20 74 |  DeskLi|b, and t|
|00001590| 68 65 6e 20 63 6f 6d 70 | 69 6c 65 73 20 74 68 65 |hen comp|iles the|
|000015a0| 20 44 65 73 6b 4c 69 62 | 0a 20 20 20 20 20 20 20 | DeskLib|.       |
|000015b0| 20 20 20 20 20 7c 20 20 | 20 20 20 20 20 20 20 20 |     |  |        |
|000015c0| 20 20 20 20 20 20 20 20 | 20 20 20 4c 69 62 72 61 |        |   Libra|
|000015d0| 72 79 0a 20 20 20 20 20 | 20 20 20 20 20 20 20 7c |ry.     |       ||
|000015e0| 0a 20 20 20 20 20 20 20 | 20 20 20 20 20 7c 5f 5f |.       |     |__|
|000015f0| 5f 5f 5f 5f 5f 5f 20 21 | 4f 62 6a 65 63 74 73 20 |______ !|Objects |
|00001600| 20 20 20 54 68 69 73 20 | 69 73 20 61 20 27 76 69 |   This |is a 'vi|
|00001610| 61 27 20 66 69 6c 65 20 | 6f 66 20 61 6c 6c 20 74 |a' file |of all t|
|00001620| 68 65 20 6c 69 62 72 61 | 72 79 0a 20 20 20 20 20 |he libra|ry.     |
|00001630| 20 20 20 20 20 20 20 7c | 20 20 20 20 20 20 20 20 |       ||        |
|00001640| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 6f 62 6a |        |     obj|
|00001650| 65 63 74 73 20 66 6f 72 | 20 4c 69 62 46 69 6c 65 |ects for| LibFile|
|00001660| 20 74 6f 20 69 6e 63 6c | 75 64 65 20 69 6e 74 6f | to incl|ude into|
|00001670| 20 44 65 73 6b 4c 69 62 | 0a 20 20 20 20 20 20 20 | DeskLib|.       |
|00001680| 20 20 20 20 20 7c 20 20 | 20 20 20 20 20 20 20 20 |     |  |        |
|00001690| 20 20 20 20 20 20 20 20 | 20 20 20 28 73 6f 20 64 |        |   (so d|
|000016a0| 6f 6e 27 74 20 64 65 6c | 65 74 65 20 69 74 21 29 |on't del|ete it!)|
|000016b0| 0a 20 20 20 20 20 20 20 | 20 20 20 20 20 7c 0a 20 |.       |     |. |
|000016c0| 20 20 20 20 20 20 20 20 | 20 20 20 7c 5f 5f 5f 5f |        |   |____|
|000016d0| 5f 5f 5f 5f 20 43 6c 65 | 61 6e 20 20 20 20 20 20 |____ Cle|an      |
|000016e0| 20 41 6e 20 6f 62 65 79 | 20 66 69 6c 65 20 74 68 | An obey| file th|
|000016f0| 61 74 20 77 69 70 65 73 | 20 61 6c 6c 20 6f 66 20 |at wipes| all of |
|00001700| 74 68 65 20 2e 6f 0a 20 | 20 20 20 20 20 20 20 20 |the .o. |        |
|00001710| 20 20 20 7c 20 20 20 20 | 20 20 20 20 20 20 20 20 |   |    |        |
|00001720| 20 20 20 20 20 20 20 20 | 20 66 69 6c 65 73 20 28 |        | files (|
|00001730| 65 78 63 65 70 74 20 74 | 68 6f 73 65 20 74 68 61 |except t|hose tha|
|00001740| 74 20 77 65 72 65 20 61 | 73 73 65 6d 62 6c 65 64 |t were a|ssembled|
|00001750| 2c 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 7c 20 |,.      |      | |
|00001760| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001770| 20 20 20 20 61 73 20 73 | 6f 6d 65 20 75 73 65 72 |    as s|ome user|
|00001780| 73 20 6d 61 79 20 6e 6f | 74 20 68 61 76 65 20 74 |s may no|t have t|
|00001790| 68 65 20 61 73 73 65 6d | 62 6c 65 72 0a 20 20 20 |he assem|bler.   |
|000017a0| 20 20 20 20 20 20 20 20 | 20 7c 20 20 20 20 20 20 |        | |      |
|000017b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 61 |        |       a|
|000017c0| 73 20 77 65 6c 6c 20 61 | 73 20 74 68 65 20 43 20 |s well a|s the C |
|000017d0| 63 6f 6d 70 69 6c 65 72 | 2e 0a 20 20 20 20 20 20 |compiler|..      |
|000017e0| 20 20 20 20 20 20 7c 0a | 20 20 20 20 20 20 20 20 |      |.|        |
|000017f0| 20 20 20 20 7c 5f 5f 5f | 5f 5f 5f 5f 5f 20 3f 20 |    |___|_____ ? |
|00001800| 20 20 20 20 20 20 20 20 | 20 20 45 61 63 68 20 73 |        |  Each s|
|00001810| 75 62 64 69 72 65 63 74 | 6f 72 79 20 69 6e 20 68 |ubdirect|ory in h|
|00001820| 65 72 65 20 63 6f 6e 74 | 61 69 6e 73 20 74 68 65 |ere cont|ains the|
|00001830| 0a 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |.       |        |
|00001840| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001850| 20 20 20 73 6f 75 72 63 | 65 20 61 6e 64 20 6d 61 |   sourc|e and ma|
|00001860| 6b 65 66 69 6c 65 20 66 | 6f 72 20 61 20 73 75 62 |kefile f|or a sub|
|00001870| 73 65 74 20 6f 66 20 74 | 68 65 0a 20 20 20 20 20 |set of t|he.     |
|00001880| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001890| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 44 65 73 |        |     Des|
|000018a0| 6b 4c 69 62 20 6c 69 62 | 72 61 72 79 2e 0a 0a 54 |kLib lib|rary...T|
|000018b0| 6f 20 63 6f 6d 70 6c 65 | 74 65 6c 79 20 6d 61 6b |o comple|tely mak|
|000018c0| 65 20 44 65 73 6b 4c 69 | 62 2c 20 73 69 6d 70 6c |e DeskLi|b, simpl|
|000018d0| 79 20 6f 70 65 6e 20 74 | 68 65 20 27 4c 69 62 72 |y open t|he 'Libr|
|000018e0| 61 72 69 65 73 27 20 64 | 69 72 65 63 74 6f 72 79 |aries' d|irectory|
|000018f0| 20 61 6e 64 0a 64 6f 75 | 62 6c 65 20 63 6c 69 63 | and.dou|ble clic|
|00001900| 6b 20 6f 6e 20 74 68 65 | 20 6f 62 65 79 20 66 69 |k on the| obey fi|
|00001910| 6c 65 20 21 4d 61 6b 65 | 44 4c 69 62 2e 0a 0a 54 |le !Make|DLib...T|
|00001920| 6f 20 6d 61 6b 65 20 74 | 68 65 20 54 65 73 74 20 |o make t|he Test |
|00001930| 41 70 70 6c 69 63 61 74 | 69 6f 6e 2c 20 63 68 61 |Applicat|ion, cha|
|00001940| 6e 67 65 20 64 69 72 65 | 63 74 6f 72 79 20 69 6e |nge dire|ctory in|
|00001950| 74 6f 20 74 68 65 20 61 | 70 70 6c 69 63 61 74 69 |to the a|pplicati|
|00001960| 6f 6e 20 64 69 72 65 63 | 74 6f 72 79 0a 61 6e 64 |on direc|tory.and|
|00001970| 20 74 79 70 65 20 27 61 | 6d 75 27 2e 0a 46 69 6c | type 'a|mu'..Fil|
|00001980| 65 44 61 74 61 82 41 62 | 6f 75 74 44 4c 00 00 00 |eData.Ab|outDL...|
|00001990| 00 a3 33 00 00 45 ff ff | ff 9d 13 e8 d3 03 00 6a |..3..E..|.......j|
|000019a0| 7e 0a 20 20 20 20 23 23 | 23 23 20 20 20 20 20 20 |~.    ##|##      |
|000019b0| 20 20 20 20 20 20 20 23 | 20 20 20 20 23 20 20 20 |       #|    #   |
|000019c0| 20 20 23 20 23 0a 20 20 | 20 20 23 20 20 20 23 20 |  # #.  |  #   # |
|000019d0| 20 20 20 20 20 20 20 20 | 20 20 20 23 20 20 20 20 |        |   #    |
|000019e0| 23 20 20 20 20 20 20 20 | 23 20 20 20 20 20 20 20 |#       |#       |
|000019f0| 20 20 54 68 65 20 46 72 | 65 65 57 61 72 65 20 43 |  The Fr|eeWare C|
|00001a00| 20 6c 69 62 72 61 72 79 | 20 66 6f 72 20 0a 20 20 | library| for .  |
|00001a10| 20 20 23 20 20 20 23 20 | 20 23 23 20 20 20 23 23 |  #   # | ##   ##|
|00001a20| 23 20 20 23 20 20 23 20 | 23 20 20 20 20 20 23 20 |#  #  # |#     # |
|00001a30| 23 23 23 20 20 20 20 20 | 20 20 20 20 20 20 20 52 |###     |       R|
|00001a40| 49 53 43 20 4f 53 20 6d | 61 63 68 69 6e 65 73 0a |ISC OS m|achines.|
|00001a50| 20 20 20 20 23 20 20 20 | 23 20 23 20 20 23 20 23 |    #   |# #  # #|
|00001a60| 20 20 20 20 20 23 20 23 | 20 20 23 20 20 20 20 20 |     # #|  #     |
|00001a70| 23 20 23 20 20 23 20 20 | 5f 5f 5f 5f 5f 5f 5f 5f |# #  #  |________|
|00001a80| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001a90| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 0a 20 20 20 20 |________|___.    |
|00001aa0| 23 20 20 20 23 20 23 23 | 23 23 20 20 23 23 23 20 |#   # ##|##  ### |
|00001ab0| 20 23 23 20 20 20 23 20 | 20 20 20 20 23 20 23 20 | ##   # |    # # |
|00001ac0| 20 23 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | #      |        |
|00001ad0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001ae0| 20 20 20 20 20 20 20 20 | 0a 20 20 20 20 23 20 20 |        |.    #  |
|00001af0| 20 23 20 23 20 20 20 20 | 20 20 20 20 23 20 23 20 | # #    |    # # |
|00001b00| 23 20 20 23 20 20 20 20 | 20 23 20 23 20 20 23 20 |#  #    | # #  # |
|00001b10| 20 20 50 6c 65 61 73 65 | 20 72 65 66 65 72 20 74 |  Please| refer t|
|00001b20| 6f 20 74 68 65 20 61 63 | 63 6f 6d 70 61 6e 79 69 |o the ac|companyi|
|00001b30| 6e 67 0a 20 20 20 20 23 | 23 23 23 20 20 20 23 23 |ng.    #|###   ##|
|00001b40| 23 20 23 23 23 23 20 20 | 23 20 20 23 20 23 23 23 |# ####  |#  # ###|
|00001b50| 23 23 20 23 20 23 23 23 | 20 20 20 64 6f 63 75 6d |## # ###|   docum|
|00001b60| 65 6e 74 61 74 69 6f 6e | 20 66 6f 72 20 63 6f 6e |entation| for con|
|00001b70| 64 69 74 69 6f 6e 73 20 | 6f 66 20 75 73 65 0a 20 |ditions |of use. |
|00001b80| 20 20 20 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |   _____|________|
|00001b90| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001ba0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001bb0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001bc0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0a 0a 20 20 20 20 |________|__..    |
|00001bd0| 4e 6f 74 65 20 74 68 61 | 74 20 61 6c 74 68 6f 75 |Note tha|t althou|
|00001be0| 67 68 20 74 68 69 73 20 | 73 6f 66 74 77 61 72 65 |gh this |software|
|00001bf0| 20 69 73 20 73 75 70 70 | 6c 69 65 64 20 66 72 65 | is supp|lied fre|
|00001c00| 65 20 6f 66 20 63 68 61 | 72 67 65 2c 20 63 6f 70 |e of cha|rge, cop|
|00001c10| 79 72 69 67 68 74 0a 20 | 20 20 20 61 70 70 6c 69 |yright. |   appli|
|00001c20| 65 73 20 74 6f 20 69 74 | 2e 20 41 6c 6c 20 72 69 |es to it|. All ri|
|00001c30| 67 68 74 73 20 61 72 65 | 20 72 65 73 65 72 76 65 |ghts are| reserve|
|00001c40| 64 2c 20 65 78 63 65 70 | 74 20 66 6f 72 20 74 68 |d, excep|t for th|
|00001c50| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 3a 0a 0a 20 20 |e follow|ing:..  |
|00001c60| 20 20 54 68 69 73 20 73 | 6f 66 74 77 61 72 65 20 |  This s|oftware |
|00001c70| 6d 61 79 20 62 65 20 63 | 6f 70 69 65 64 20 61 6e |may be c|opied an|
|00001c80| 64 20 64 69 73 74 72 69 | 62 75 74 65 64 20 77 69 |d distri|buted wi|
|00001c90| 74 68 6f 75 74 20 72 65 | 73 74 72 69 63 74 69 6f |thout re|strictio|
|00001ca0| 6e 20 73 6f 20 6c 6f 6e | 67 0a 20 20 20 20 61 73 |n so lon|g.    as|
|00001cb0| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 63 | the fol|lowing c|
|00001cc0| 6f 6e 64 69 74 69 6f 6e | 73 20 61 72 65 20 6d 65 |ondition|s are me|
|00001cd0| 74 3a 0a 20 20 20 20 20 | 20 61 29 20 54 68 65 20 |t:.     | a) The |
|00001ce0| 63 6f 70 79 72 69 67 68 | 74 20 6d 65 73 73 61 67 |copyrigh|t messag|
|00001cf0| 65 73 20 61 6e 64 20 74 | 68 65 73 65 20 63 6f 6e |es and t|hese con|
|00001d00| 64 69 74 69 6f 6e 73 20 | 61 72 65 20 64 69 73 74 |ditions |are dist|
|00001d10| 72 69 62 75 74 65 64 20 | 69 6e 74 61 63 74 0a 20 |ributed |intact. |
|00001d20| 20 20 20 20 20 20 20 20 | 69 6e 20 61 6c 6c 20 73 |        |in all s|
|00001d30| 75 63 68 20 63 6f 70 69 | 65 73 0a 20 20 20 20 20 |uch copi|es.     |
|00001d40| 20 62 29 20 4f 6e 6c 79 | 20 6f 72 69 67 69 6e 61 | b) Only| origina|
|00001d50| 6c 2c 20 75 6e 61 6c 74 | 65 72 65 64 20 63 6f 70 |l, unalt|ered cop|
|00001d60| 69 65 73 20 6f 66 20 74 | 68 69 73 20 73 6f 66 74 |ies of t|his soft|
|00001d70| 77 61 72 65 20 61 72 65 | 20 74 6f 20 62 65 0a 20 |ware are| to be. |
|00001d80| 20 20 20 20 20 20 20 20 | 64 69 73 74 72 69 62 75 |        |distribu|
|00001d90| 74 65 64 20 28 73 6f 20 | 74 68 61 74 20 74 68 69 |ted (so |that thi|
|00001da0| 73 20 6c 69 62 72 61 72 | 79 20 72 65 6d 61 69 6e |s librar|y remain|
|00001db0| 73 20 63 6f 6e 73 69 73 | 74 65 6e 74 20 6f 76 65 |s consis|tent ove|
|00001dc0| 72 20 74 69 6d 65 29 0a | 20 20 20 20 20 20 20 20 |r time).|        |
|00001dd0| 20 2d 50 4c 45 41 53 45 | 20 44 4f 4e 27 54 20 61 | -PLEASE| DON'T a|
|00001de0| 6c 74 65 72 20 74 68 65 | 20 6c 69 62 72 61 72 79 |lter the| library|
|00001df0| 20 61 6e 64 20 70 61 73 | 73 20 69 74 20 6f 6e 3a | and pas|s it on:|
|00001e00| 20 41 6c 74 65 72 20 69 | 74 20 61 6e 64 0a 20 20 | Alter i|t and.  |
|00001e10| 20 20 20 20 20 20 20 73 | 65 6e 64 20 61 6c 74 65 |       s|end alte|
|00001e20| 72 61 74 69 6f 6e 73 20 | 62 61 63 6b 20 74 6f 20 |rations |back to |
|00001e30| 74 68 65 20 6d 6f 64 65 | 72 61 74 6f 72 20 28 73 |the mode|rator (s|
|00001e40| 65 65 20 62 65 6c 6f 77 | 29 20 73 6f 20 74 68 61 |ee below|) so tha|
|00001e50| 74 0a 20 20 20 20 20 20 | 20 20 20 79 6f 75 72 20 |t.      |   your |
|00001e60| 63 6f 64 65 20 62 65 63 | 6f 6d 65 73 20 61 6e 20 |code bec|omes an |
|00001e70| 6f 66 66 69 63 69 61 6c | 20 75 70 64 61 74 65 20 |official| update |
|00001e80| 72 61 74 68 65 72 20 74 | 68 61 6e 20 61 20 68 61 |rather t|han a ha|
|00001e90| 63 6b 2e 0a 20 20 20 20 | 20 20 63 29 20 4e 6f 20 |ck..    |  c) No |
|00001ea0| 70 72 6f 66 69 74 20 69 | 73 20 6d 61 64 65 20 74 |profit i|s made t|
|00001eb0| 68 72 6f 75 67 68 20 73 | 75 63 68 20 64 69 73 74 |hrough s|uch dist|
|00001ec0| 72 69 62 75 74 69 6f 6e | 0a 0a 20 20 20 20 54 68 |ribution|..    Th|
|00001ed0| 69 73 20 73 6f 66 74 77 | 61 72 65 20 6d 61 79 20 |is softw|are may |
|00001ee0| 62 65 20 75 73 65 64 20 | 69 6e 20 74 68 65 20 70 |be used |in the p|
|00001ef0| 72 6f 64 75 63 74 69 6f | 6e 20 6f 66 20 61 6e 79 |roductio|n of any|
|00001f00| 20 70 69 65 63 65 20 6f | 66 20 73 6f 66 74 77 61 | piece o|f softwa|
|00001f10| 72 65 20 73 6f 0a 20 20 | 20 20 6c 6f 6e 67 20 61 |re so.  |  long a|
|00001f20| 73 20 74 68 65 20 61 75 | 74 68 6f 72 73 20 61 63 |s the au|thors ac|
|00001f30| 6b 6e 6f 77 6c 65 64 67 | 65 20 69 6e 20 74 68 65 |knowledg|e in the|
|00001f40| 20 66 69 6e 61 6c 20 70 | 72 6f 64 75 63 74 20 64 | final p|roduct d|
|00001f50| 69 73 74 72 69 62 75 74 | 69 6f 6e 20 74 68 61 74 |istribut|ion that|
|00001f60| 0a 20 20 20 20 44 65 73 | 6b 4c 69 62 20 28 6f 72 |.    Des|kLib (or|
|00001f70| 20 70 61 72 74 73 20 74 | 68 65 72 65 6f 66 29 20 | parts t|hereof) |
|00001f80| 77 61 73 20 75 73 65 64 | 2e 0a 0a 20 0a 20 20 20 |was used|... .   |
|00001f90| 20 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a | *******|********|
|00001fa0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001fb0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001fc0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001fd0| 2a 2a 2a 2a 2a 2a 2a 2a | 0a 20 20 20 20 2a 20 54 |********|.    * T|
|00001fe0| 68 69 73 20 70 72 6f 67 | 72 61 6d 20 69 73 20 64 |his prog|ram is d|
|00001ff0| 69 73 74 72 69 62 75 74 | 65 64 20 69 6e 20 74 68 |istribut|ed in th|
|00002000| 65 20 68 6f 70 65 20 74 | 68 61 74 20 69 74 20 77 |e hope t|hat it w|
|00002010| 69 6c 6c 20 62 65 20 75 | 73 65 66 75 6c 2c 20 20 |ill be u|seful,  |
|00002020| 20 20 20 2a 0a 20 20 20 | 20 2a 20 62 75 74 20 57 |   *.   | * but W|
|00002030| 49 54 48 4f 55 54 20 41 | 4e 59 20 57 41 52 52 41 |ITHOUT A|NY WARRA|
|00002040| 4e 54 59 3b 20 77 69 74 | 68 6f 75 74 20 65 76 65 |NTY; wit|hout eve|
|00002050| 6e 20 74 68 65 20 69 6d | 70 6c 69 65 64 20 77 61 |n the im|plied wa|
|00002060| 72 72 61 6e 74 79 20 6f | 66 20 20 20 20 20 20 2a |rranty o|f      *|
|00002070| 0a 20 20 20 20 2a 20 4d | 45 52 43 48 41 4e 54 41 |.    * M|ERCHANTA|
|00002080| 42 49 4c 49 54 59 20 6f | 72 20 46 49 54 4e 45 53 |BILITY o|r FITNES|
|00002090| 53 20 46 4f 52 20 41 20 | 50 41 52 54 49 43 55 4c |S FOR A |PARTICUL|
|000020a0| 41 52 20 50 55 52 50 4f | 53 45 2e 20 20 20 20 20 |AR PURPO|SE.     |
|000020b0| 20 20 20 20 20 20 20 20 | 20 20 20 2a 0a 20 20 20 |        |   *.   |
|000020c0| 20 2a 20 42 75 67 20 72 | 65 70 6f 72 74 73 2c 20 | * Bug r|eports, |
|000020d0| 66 69 78 65 73 2c 20 6f | 72 20 61 6e 79 20 65 78 |fixes, o|r any ex|
|000020e0| 74 72 61 20 63 6f 64 65 | 20 6d 61 79 20 62 65 20 |tra code| may be |
|000020f0| 73 65 6e 74 20 74 6f 20 | 74 68 65 20 6d 6f 64 65 |sent to |the mode|
|00002100| 72 61 74 6f 72 2c 20 2a | 0a 20 20 20 20 2a 20 77 |rator, *|.    * w|
|00002110| 68 6f 20 6d 61 79 20 6f | 72 20 6d 61 79 20 6e 6f |ho may o|r may no|
|00002120| 74 20 61 63 74 20 6f 6e | 20 74 68 65 6d 20 61 73 |t act on| them as|
|00002130| 20 68 65 20 64 65 65 6d | 73 20 66 69 74 2e 20 20 | he deem|s fit.  |
|00002140| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00002150| 20 20 20 2a 0a 20 20 20 | 20 2a 2a 2a 2a 2a 2a 2a |   *.   | *******|
|00002160| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002170| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002180| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002190| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000021a0| 0a 20 20 20 20 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |.    ___|________|
|000021b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000021c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000021d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000021e0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 0a 0a 20 20 |________|____..  |
|000021f0| 20 20 4e 4f 54 45 20 41 | 4c 53 4f 20 74 68 61 74 |  NOTE A|LSO that|
|00002200| 20 44 65 73 6b 4c 69 62 | 20 69 73 20 74 6f 74 61 | DeskLib| is tota|
|00002210| 6c 6c 79 20 75 6e 61 66 | 66 69 6c 69 61 74 65 64 |lly unaf|filiated|
|00002220| 20 74 6f 20 61 6e 79 6f | 6e 65 20 6f 72 20 61 6e | to anyo|ne or an|
|00002230| 79 74 68 69 6e 67 2e 0a | 20 20 20 20 4a 75 73 74 |ything..|    Just|
|00002240| 20 62 65 63 61 75 73 65 | 20 49 20 6e 6f 77 20 77 | because| I now w|
|00002250| 6f 72 6b 20 66 6f 72 20 | 43 6f 6d 70 75 74 65 72 |ork for |Computer|
|00002260| 20 43 6f 6e 63 65 70 74 | 73 20 64 6f 65 73 20 6e | Concept|s does n|
|00002270| 6f 74 20 6d 65 61 6e 20 | 74 68 61 74 20 74 68 69 |ot mean |that thi|
|00002280| 73 0a 20 20 20 20 70 72 | 6f 64 75 63 74 20 69 73 |s.    pr|oduct is|
|00002290| 20 69 6e 20 61 6e 79 20 | 77 61 79 20 72 65 6c 61 | in any |way rela|
|000022a0| 74 65 64 20 74 6f 20 43 | 6f 6d 70 75 74 65 72 20 |ted to C|omputer |
|000022b0| 43 6f 6e 63 65 70 74 73 | 20 4c 74 64 2e 0a 20 20 |Concepts| Ltd..  |
|000022c0| 20 20 41 6c 6c 20 63 6f | 6d 6d 65 6e 74 73 20 61 |  All co|mments a|
|000022d0| 62 6f 75 74 20 70 65 6f | 70 6c 65 20 61 6e 64 20 |bout peo|ple and |
|000022e0| 63 6f 6d 70 61 6e 69 65 | 73 20 69 6e 20 74 68 69 |companie|s in thi|
|000022f0| 73 20 70 72 6f 64 75 63 | 74 20 61 72 65 20 65 69 |s produc|t are ei|
|00002300| 74 68 65 72 0a 20 20 20 | 20 70 65 72 73 6f 6e 61 |ther.   | persona|
|00002310| 6c 20 6f 70 69 6e 69 6f | 6e 20 6f 72 20 77 65 72 |l opinio|n or wer|
|00002320| 65 20 66 61 63 74 75 61 | 6c 20 61 74 20 74 68 65 |e factua|l at the|
|00002330| 20 74 69 6d 65 20 6f 66 | 20 77 72 69 74 69 6e 67 | time of| writing|
|00002340| 2e 20 4d 6f 73 74 20 73 | 75 63 68 0a 20 20 20 20 |. Most s|uch.    |
|00002350| 63 6f 6d 6d 65 6e 74 73 | 20 61 72 65 20 69 6e 63 |comments| are inc|
|00002360| 6c 75 64 65 64 20 6f 6e | 6c 79 20 73 6f 20 74 68 |luded on|ly so th|
|00002370| 61 74 20 74 68 65 20 75 | 73 65 72 20 6b 6e 6f 77 |at the u|ser know|
|00002380| 73 20 74 68 65 20 52 45 | 41 53 4f 4e 20 66 6f 72 |s the RE|ASON for|
|00002390| 0a 20 20 20 20 74 68 69 | 6e 67 73 20 68 61 76 69 |.    thi|ngs havi|
|000023a0| 6e 67 20 62 65 65 6e 20 | 64 6f 6e 65 20 61 73 20 |ng been |done as |
|000023b0| 74 68 65 79 20 77 65 72 | 65 2e 0a 20 20 20 20 5f |they wer|e..    _|
|000023c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000023d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000023e0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000023f0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002400| 5f 5f 5f 5f 5f 5f 0a 0a | 20 41 62 6f 75 74 20 44 |______..| About D|
|00002410| 65 73 6b 4c 69 62 0a 20 | 3d 3d 3d 3d 3d 3d 3d 3d |eskLib. |========|
|00002420| 3d 3d 3d 3d 3d 0a 0a 20 | 41 66 74 65 72 20 73 6f |=====.. |After so|
|00002430| 6d 65 20 62 61 64 20 65 | 78 70 65 72 69 65 6e 63 |me bad e|xperienc|
|00002440| 65 73 20 77 69 74 68 20 | 41 63 6f 72 6e 27 73 20 |es with |Acorn's |
|00002450| 52 49 53 43 20 4f 53 20 | 4c 69 62 2c 20 49 20 64 |RISC OS |Lib, I d|
|00002460| 65 63 69 64 65 64 20 74 | 68 61 74 20 61 20 6e 65 |ecided t|hat a ne|
|00002470| 77 2c 0a 20 77 65 6c 6c | 20 77 72 69 74 74 65 6e |w,. well| written|
|00002480| 2c 20 70 72 6f 66 65 73 | 73 69 6f 6e 61 6c 6c 79 |, profes|sionally|
|00002490| 2d 66 69 6e 69 73 68 65 | 64 20 6c 69 62 72 61 72 |-finishe|d librar|
|000024a0| 79 20 77 6f 75 6c 64 20 | 62 65 20 76 65 72 79 20 |y would |be very |
|000024b0| 75 73 65 66 75 6c 2e 20 | 41 63 6f 72 6e 0a 20 61 |useful. |Acorn. a|
|000024c0| 70 70 65 61 72 65 64 20 | 74 6f 20 62 65 20 75 6e |ppeared |to be un|
|000024d0| 69 6e 74 65 72 65 73 74 | 65 64 20 69 6e 20 66 69 |interest|ed in fi|
|000024e0| 78 69 6e 67 20 52 49 53 | 43 20 4f 53 20 4c 69 62 |xing RIS|C OS Lib|
|000024f0| 20 66 6f 72 20 6d 65 2c | 20 73 6f 20 49 20 6d 61 | for me,| so I ma|
|00002500| 6e 61 67 65 64 20 74 6f | 0a 20 72 75 73 74 6c 65 |naged to|. rustle|
|00002510| 20 75 70 20 61 20 62 61 | 6e 64 20 6f 66 20 6d 65 | up a ba|nd of me|
|00002520| 72 72 79 20 70 72 6f 67 | 72 61 6d 6d 65 72 73 20 |rry prog|rammers |
|00002530| 74 6f 20 68 65 6c 70 20 | 6d 65 20 77 72 69 74 65 |to help |me write|
|00002540| 20 61 20 63 6f 6d 70 6c | 65 74 65 6c 79 20 6e 65 | a compl|etely ne|
|00002550| 77 0a 20 6c 69 62 72 61 | 72 79 2c 20 66 72 6f 6d |w. libra|ry, from|
|00002560| 20 73 63 72 61 74 63 68 | 2c 20 61 6e 64 20 64 65 | scratch|, and de|
|00002570| 73 69 67 6e 20 74 68 69 | 6e 67 73 20 62 65 66 6f |sign thi|ngs befo|
|00002580| 72 65 20 74 68 65 79 20 | 77 65 72 65 20 77 72 69 |re they |were wri|
|00002590| 74 74 65 6e 2e 0a 0a 20 | 54 68 65 20 72 65 73 75 |tten... |The resu|
|000025a0| 6c 74 20 69 73 20 28 6f | 72 20 77 69 6c 6c 20 62 |lt is (o|r will b|
|000025b0| 65 20 3f 21 29 20 44 65 | 73 6b 4c 69 62 2e 0a 0a |e ?!) De|skLib...|
|000025c0| 20 44 65 73 6b 4c 69 62 | 20 69 73 20 61 20 73 65 | DeskLib| is a se|
|000025d0| 74 20 6f 66 20 41 4e 53 | 49 20 43 20 61 6e 64 20 |t of ANS|I C and |
|000025e0| 41 52 4d 20 61 73 73 65 | 6d 62 6c 65 72 20 73 6f |ARM asse|mbler so|
|000025f0| 75 72 63 65 73 20 69 6e | 74 65 6e 64 65 64 20 74 |urces in|tended t|
|00002600| 6f 20 61 64 64 20 74 6f | 20 6f 72 0a 20 72 65 70 |o add to| or. rep|
|00002610| 6c 61 63 65 20 50 41 52 | 54 53 20 6f 66 20 74 68 |lace PAR|TS of th|
|00002620| 65 20 6c 69 62 72 61 72 | 69 65 73 20 73 75 70 70 |e librar|ies supp|
|00002630| 6c 69 65 64 20 77 69 74 | 68 20 41 63 6f 72 6e 20 |lied wit|h Acorn |
|00002640| 44 65 73 6b 74 6f 70 20 | 43 2e 20 4d 61 6e 79 20 |Desktop |C. Many |
|00002650| 70 61 72 74 73 20 6f 66 | 0a 20 44 65 73 6b 4c 69 |parts of|. DeskLi|
|00002660| 62 20 72 65 70 6c 61 63 | 65 20 70 61 72 74 73 20 |b replac|e parts |
|00002670| 6f 66 20 74 68 65 20 41 | 63 6f 72 6e 20 4c 69 62 |of the A|corn Lib|
|00002680| 72 61 72 69 65 73 2c 20 | 62 75 74 20 6d 61 6e 79 |raries, |but many|
|00002690| 20 70 6f 72 74 69 6f 6e | 73 20 6f 66 20 74 68 65 | portion|s of the|
|000026a0| 0a 20 6c 69 62 72 61 72 | 79 20 63 6f 64 65 20 63 |. librar|y code c|
|000026b0| 61 6e 20 62 65 20 75 73 | 65 64 20 69 6e 20 63 6f |an be us|ed in co|
|000026c0| 6e 6a 75 6e 63 74 69 6f | 6e 20 77 69 74 68 20 41 |njunctio|n with A|
|000026d0| 63 6f 72 6e 27 73 20 6c | 69 62 72 61 72 69 65 73 |corn's l|ibraries|
|000026e0| 2c 20 6f 72 20 61 73 20 | 61 20 62 61 73 65 0a 20 |, or as |a base. |
|000026f0| 66 72 6f 6d 20 77 68 69 | 63 68 20 79 6f 75 20 77 |from whi|ch you w|
|00002700| 69 6c 6c 20 62 65 20 61 | 62 6c 65 20 74 6f 20 6d |ill be a|ble to m|
|00002710| 6f 72 65 20 65 61 73 69 | 6c 79 20 77 72 69 74 65 |ore easi|ly write|
|00002720| 20 63 6f 64 65 20 66 6f | 72 20 75 73 65 20 77 69 | code fo|r use wi|
|00002730| 74 68 20 41 63 6f 72 6e | 27 73 0a 20 4c 69 62 72 |th Acorn|'s. Libr|
|00002740| 61 72 69 65 73 2c 20 73 | 6f 20 64 6f 6e 27 74 20 |aries, s|o don't |
|00002750| 67 6f 20 61 77 61 79 20 | 6a 75 73 74 20 79 65 74 |go away |just yet|
|00002760| 21 0a 20 54 68 69 73 20 | 6c 69 62 72 61 72 79 20 |!. This |library |
|00002770| 69 73 20 69 6e 74 65 6e | 64 65 64 20 62 6f 74 68 |is inten|ded both|
|00002780| 20 61 73 20 61 6e 20 61 | 6c 74 65 72 6e 61 74 69 | as an a|lternati|
|00002790| 76 65 20 74 6f 20 41 63 | 6f 72 6e 27 73 20 52 49 |ve to Ac|orn's RI|
|000027a0| 53 43 20 4f 53 20 4c 69 | 62 20 61 73 0a 20 77 65 |SC OS Li|b as. we|
|000027b0| 6c 6c 20 61 73 20 61 20 | 75 73 65 66 75 6c 20 73 |ll as a |useful s|
|000027c0| 6f 75 72 63 65 20 6f 66 | 20 66 72 61 67 6d 65 6e |ource of| fragmen|
|000027d0| 74 73 20 6f 66 20 63 6f | 64 65 20 74 6f 20 69 6e |ts of co|de to in|
|000027e0| 63 6c 75 64 65 20 69 6e | 74 6f 20 79 6f 75 72 20 |clude in|to your |
|000027f0| 6f 77 6e 0a 20 73 6f 75 | 72 63 65 73 2e 0a 0a 20 |own. sou|rces... |
|00002800| 41 6c 6c 20 65 66 66 6f | 72 74 73 20 68 61 76 65 |All effo|rts have|
|00002810| 20 62 65 65 6e 20 73 70 | 65 6e 74 20 74 6f 20 6d | been sp|ent to m|
|00002820| 61 6b 65 20 74 68 65 20 | 6c 69 62 72 61 72 79 20 |ake the |library |
|00002830| 63 6f 64 65 20 61 73 20 | 67 65 6e 65 72 69 63 2c |code as |generic,|
|00002840| 20 72 6f 62 75 73 74 2c | 0a 20 61 6e 64 20 75 73 | robust,|. and us|
|00002850| 65 66 75 6c 20 61 73 20 | 70 6f 73 73 69 62 6c 65 |eful as |possible|
|00002860| 2c 20 61 73 20 77 65 6c | 6c 20 61 73 20 61 74 74 |, as wel|l as att|
|00002870| 65 6d 70 74 69 6e 67 20 | 74 6f 20 70 72 6f 76 69 |empting |to provi|
|00002880| 64 65 20 61 20 63 6f 6d | 70 72 65 68 65 6e 73 69 |de a com|prehensi|
|00002890| 76 65 0a 20 72 61 6e 67 | 65 20 6f 66 20 66 75 6e |ve. rang|e of fun|
|000028a0| 63 74 69 6f 6e 20 63 61 | 6c 6c 73 2c 20 66 72 6f |ction ca|lls, fro|
|000028b0| 6d 20 62 61 73 69 63 20 | 53 57 49 2d 6c 65 76 65 |m basic |SWI-leve|
|000028c0| 6c 20 73 75 70 70 6f 72 | 74 20 74 6f 20 68 69 67 |l suppor|t to hig|
|000028d0| 68 2d 6c 65 76 65 6c 0a | 20 66 75 6e 63 74 69 6f |h-level.| functio|
|000028e0| 6e 73 20 73 75 63 68 20 | 61 73 20 61 75 74 6f 6d |ns such |as autom|
|000028f0| 61 74 69 63 20 64 69 61 | 6c 6f 67 75 65 2d 62 6f |atic dia|logue-bo|
|00002900| 78 20 63 72 65 61 74 69 | 6f 6e 2c 20 68 61 6e 64 |x creati|on, hand|
|00002910| 6c 69 6e 67 20 61 6e 64 | 0a 20 72 65 73 75 6c 74 |ling and|. result|
|00002920| 2d 72 65 74 75 72 6e 20 | 69 6e 20 61 20 73 69 6e |-return |in a sin|
|00002930| 67 6c 65 20 66 75 6e 63 | 74 69 6f 6e 2e 0a 0a 20 |gle func|tion... |
|00002940| 57 68 65 72 65 20 70 6f | 73 73 69 62 6c 65 2c 20 |Where po|ssible, |
|00002950| 72 6f 75 74 69 6e 65 73 | 20 68 61 76 65 20 62 65 |routines| have be|
|00002960| 65 6e 20 6f 70 74 69 6d | 69 73 65 64 20 28 74 6f |en optim|ised (to|
|00002970| 20 73 6f 6d 65 20 65 78 | 74 65 6e 74 29 20 66 6f | some ex|tent) fo|
|00002980| 72 0a 20 65 66 66 69 63 | 69 65 6e 63 79 2c 20 62 |r. effic|iency, b|
|00002990| 75 74 20 74 68 65 20 70 | 72 69 6d 61 72 79 20 67 |ut the p|rimary g|
|000029a0| 6f 61 6c 73 20 61 72 65 | 20 68 69 67 68 2d 6c 65 |oals are| high-le|
|000029b0| 76 65 6c 20 69 6e 74 65 | 72 66 61 63 65 73 20 74 |vel inte|rfaces t|
|000029c0| 68 61 74 20 6d 61 6b 65 | 20 57 49 4d 50 0a 20 70 |hat make| WIMP. p|
|000029d0| 72 6f 67 72 61 6d 6d 69 | 6e 67 20 71 75 69 63 6b |rogrammi|ng quick|
|000029e0| 20 61 6e 64 20 65 61 73 | 79 2e 20 28 49 66 20 74 | and eas|y. (If t|
|000029f0| 68 65 20 75 73 65 72 20 | 77 61 6e 74 73 20 74 6f |he user |wants to|
|00002a00| 20 73 70 65 63 69 66 69 | 63 61 6c 6c 79 20 64 6f | specifi|cally do|
|00002a10| 20 73 6f 6d 65 74 68 69 | 6e 67 0a 20 73 70 65 63 | somethi|ng. spec|
|00002a20| 69 61 6c 2c 20 61 6e 64 | 20 77 61 6e 74 73 20 69 |ial, and| wants i|
|00002a30| 74 20 66 61 73 74 2c 20 | 74 68 65 20 73 6f 75 72 |t fast, |the sour|
|00002a40| 63 65 20 63 6f 64 65 20 | 66 6f 72 20 44 65 73 6b |ce code |for Desk|
|00002a50| 4c 69 62 20 69 73 20 61 | 76 61 69 6c 61 62 6c 65 |Lib is a|vailable|
|00002a60| 2c 20 73 6f 20 61 6e 79 | 0a 20 66 75 6e 63 74 69 |, so any|. functi|
|00002a70| 6f 6e 73 20 63 61 6e 20 | 62 65 20 61 64 61 70 74 |ons can |be adapt|
|00002a80| 65 64 20 66 6f 72 20 74 | 68 65 20 75 73 65 72 27 |ed for t|he user'|
|00002a90| 73 20 6e 65 65 64 73 20 | 61 73 20 6e 65 63 65 73 |s needs |as neces|
|00002aa0| 73 61 72 79 2e 2e 2e 29 | 0a 0a 20 41 6c 6c 20 70 |sary...)|.. All p|
|00002ab0| 6f 73 73 69 62 6c 65 20 | 61 63 74 69 6f 6e 20 69 |ossible |action i|
|00002ac0| 73 20 74 61 6b 65 6e 20 | 74 6f 20 6b 65 65 70 20 |s taken |to keep |
|00002ad0| 63 6f 64 65 20 73 69 7a | 65 20 64 6f 77 6e 20 77 |code siz|e down w|
|00002ae0| 69 74 68 6f 75 74 20 61 | 64 76 65 72 73 65 6c 79 |ithout a|dversely|
|00002af0| 0a 20 61 66 66 65 63 74 | 69 6e 67 20 74 68 65 20 |. affect|ing the |
|00002b00| 66 75 6e 63 74 69 6f 6e | 61 6c 69 74 79 20 6f 66 |function|ality of|
|00002b10| 20 74 68 65 20 6c 69 62 | 72 61 72 79 3a 20 49 6e | the lib|rary: In|
|00002b20| 64 69 76 69 64 75 61 6c | 20 66 75 6e 63 74 69 6f |dividual| functio|
|00002b30| 6e 73 20 61 72 65 20 61 | 64 64 65 64 0a 20 74 6f |ns are a|dded. to|
|00002b40| 20 74 68 65 20 6c 69 62 | 72 61 72 79 20 73 65 70 | the lib|rary sep|
|00002b50| 61 72 61 74 65 6c 79 2c | 20 73 6f 20 74 68 61 74 |arately,| so that|
|00002b60| 20 69 6e 63 6c 75 64 69 | 6e 67 20 6f 6e 65 20 66 | includi|ng one f|
|00002b70| 75 6e 63 74 69 6f 6e 20 | 69 6e 20 79 6f 75 72 20 |unction |in your |
|00002b80| 63 6f 64 65 0a 20 64 6f | 65 73 20 4e 4f 54 20 69 |code. do|es NOT i|
|00002b90| 6e 63 6c 75 64 65 20 74 | 68 65 20 28 75 6e 77 61 |nclude t|he (unwa|
|00002ba0| 6e 74 65 64 20 61 6e 64 | 20 75 6e 6e 65 65 64 65 |nted and| unneede|
|00002bb0| 64 29 20 63 6f 64 65 20 | 66 6f 72 20 73 65 76 65 |d) code |for seve|
|00002bc0| 72 61 6c 20 6f 74 68 65 | 72 73 2e 0a 0a 20 57 68 |ral othe|rs... Wh|
|00002bd0| 65 72 65 20 70 6f 73 73 | 69 62 6c 65 2c 20 63 6f |ere poss|ible, co|
|00002be0| 64 65 20 69 73 20 77 72 | 69 74 74 65 6e 20 61 73 |de is wr|itten as|
|00002bf0| 20 61 20 73 74 61 6e 64 | 61 6c 6f 6e 65 20 75 6e | a stand|alone un|
|00002c00| 69 74 20 74 6f 20 61 76 | 6f 69 64 20 70 75 6c 6c |it to av|oid pull|
|00002c10| 69 6e 67 20 69 6e 0a 20 | 74 6f 6f 20 6d 75 63 68 |ing in. |too much|
|00002c20| 20 6f 74 68 65 72 20 44 | 65 73 6b 4c 69 62 20 63 | other D|eskLib c|
|00002c30| 6f 64 65 20 77 68 65 6e | 20 79 6f 75 20 69 6e 63 |ode when| you inc|
|00002c40| 6c 75 64 65 20 61 20 66 | 75 6e 63 74 69 6f 6e 2e |lude a f|unction.|
|00002c50| 0a 0a 20 41 74 74 65 6d | 70 74 73 20 68 61 76 65 |.. Attem|pts have|
|00002c60| 20 61 6c 73 6f 20 62 65 | 65 6e 20 6d 61 64 65 20 | also be|en made |
|00002c70| 74 6f 20 72 61 74 69 6f | 6e 61 6c 69 73 65 20 74 |to ratio|nalise t|
|00002c80| 68 65 20 6e 61 6d 69 6e | 67 20 63 6f 6e 76 65 6e |he namin|g conven|
|00002c90| 74 69 6f 6e 73 20 75 73 | 65 64 2c 0a 20 77 68 69 |tions us|ed,. whi|
|00002ca0| 6c 65 20 6b 65 65 70 69 | 6e 67 20 61 73 20 6d 75 |le keepi|ng as mu|
|00002cb0| 63 68 20 63 6f 6d 70 61 | 74 69 62 69 6c 69 74 79 |ch compa|tibility|
|00002cc0| 20 77 69 74 68 20 74 68 | 65 20 41 63 6f 72 6e 20 | with th|e Acorn |
|00002cd0| 6c 69 62 72 61 72 69 65 | 73 20 61 73 20 70 6f 73 |librarie|s as pos|
|00002ce0| 73 69 62 6c 65 2e 0a 20 | 54 68 75 73 2c 20 64 61 |sible.. |Thus, da|
|00002cf0| 74 61 20 73 74 72 75 63 | 74 75 72 65 73 20 61 72 |ta struc|tures ar|
|00002d00| 65 20 61 73 20 73 69 6d | 69 6c 61 72 20 74 6f 20 |e as sim|ilar to |
|00002d10| 61 63 6f 72 6e 20 63 6f | 6e 76 65 6e 74 69 6f 6e |acorn co|nvention|
|00002d20| 73 20 61 73 20 70 6f 73 | 73 69 62 6c 65 2c 20 62 |s as pos|sible, b|
|00002d30| 75 74 0a 20 77 69 74 68 | 20 6f 63 63 61 73 69 6f |ut. with| occasio|
|00002d40| 6e 61 6c 20 6e 61 6d 65 | 73 20 61 6c 74 65 72 65 |nal name|s altere|
|00002d50| 64 20 74 6f 20 69 6d 70 | 72 6f 76 65 20 72 65 61 |d to imp|rove rea|
|00002d60| 64 61 62 69 6c 69 74 79 | 20 61 6e 64 2f 6f 72 20 |dability| and/or |
|00002d70| 63 6f 6e 73 69 73 74 65 | 6e 63 79 2e 0a 20 57 65 |consiste|ncy.. We|
|00002d80| 20 68 61 76 65 20 72 65 | 76 65 72 74 65 64 20 62 | have re|verted b|
|00002d90| 61 63 6b 20 74 6f 20 62 | 61 73 69 6e 67 20 6f 75 |ack to b|asing ou|
|00002da0| 72 20 6e 61 6d 69 6e 67 | 20 6f 6e 20 41 63 6f 72 |r naming| on Acor|
|00002db0| 6e 27 73 20 76 65 72 79 | 20 77 65 6c 6c 20 64 65 |n's very| well de|
|00002dc0| 73 69 67 6e 65 64 0a 20 | 53 57 49 20 69 6e 74 65 |signed. |SWI inte|
|00002dd0| 72 66 61 63 65 73 20 61 | 6e 64 20 74 68 65 69 72 |rfaces a|nd their|
|00002de0| 20 75 73 65 2c 20 72 61 | 74 68 65 72 20 74 68 61 | use, ra|ther tha|
|00002df0| 6e 20 73 74 69 63 6b 69 | 6e 67 20 77 69 74 68 20 |n sticki|ng with |
|00002e00| 41 63 6f 72 6e 27 73 20 | 52 49 53 43 20 4f 53 20 |Acorn's |RISC OS |
|00002e10| 4c 69 62 0a 20 61 62 73 | 74 72 61 63 74 69 6f 6e |Lib. abs|traction|
|00002e20| 73 20 74 6f 20 6b 65 65 | 70 20 74 68 69 73 20 65 |s to kee|p this e|
|00002e30| 6e 76 69 72 6f 6e 6d 65 | 6e 74 20 63 6c 6f 73 65 |nvironme|nt close|
|00002e40| 72 20 74 6f 20 69 74 27 | 73 20 41 73 73 65 6d 62 |r to it'|s Assemb|
|00002e50| 6c 65 72 20 61 6e 64 20 | 42 41 53 49 43 0a 20 63 |ler and |BASIC. c|
|00002e60| 6f 75 73 69 6e 73 2c 20 | 77 68 69 63 68 20 77 69 |ousins, |which wi|
|00002e70| 6c 6c 20 6d 61 6b 65 20 | 69 74 20 65 61 73 69 65 |ll make |it easie|
|00002e80| 72 20 74 6f 20 70 6f 72 | 74 20 70 72 6f 67 72 61 |r to por|t progra|
|00002e90| 6d 6d 65 72 73 20 62 65 | 74 77 65 65 6e 20 65 6e |mmers be|tween en|
|00002ea0| 76 69 72 6f 6e 6d 65 6e | 74 73 2e 0a 0a 20 41 73 |vironmen|ts... As|
|00002eb0| 20 61 20 72 65 73 75 6c | 74 2c 20 44 65 73 6b 4c | a resul|t, DeskL|
|00002ec0| 69 62 20 68 61 73 20 62 | 65 65 6e 20 64 65 76 65 |ib has b|een deve|
|00002ed0| 6c 6f 70 65 64 20 62 79 | 20 69 6e 64 69 76 69 64 |loped by| individ|
|00002ee0| 75 61 6c 20 70 72 6f 67 | 72 61 6d 6d 65 72 73 20 |ual prog|rammers |
|00002ef0| 77 6f 72 6b 69 6e 67 0a | 20 74 6f 20 73 6f 6d 65 |working.| to some|
|00002f00| 20 62 61 73 69 63 20 67 | 75 69 64 65 6c 69 6e 65 | basic g|uideline|
|00002f10| 73 2c 20 77 69 74 68 20 | 6d 65 2c 20 74 68 65 20 |s, with |me, the |
|00002f20| 6d 6f 64 65 72 61 74 6f | 72 2c 20 74 61 6b 69 6e |moderato|r, takin|
|00002f30| 67 20 69 6e 20 74 68 65 | 20 63 6f 64 65 2c 0a 20 |g in the| code,. |
|00002f40| 74 69 64 79 69 6e 67 20 | 75 70 20 61 6e 79 20 22 |tidying |up any "|
|00002f50| 6c 6f 6f 73 65 20 65 6e | 64 73 22 20 49 20 66 69 |loose en|ds" I fi|
|00002f60| 6e 64 2c 20 61 6e 64 20 | 74 68 65 6e 20 69 6e 63 |nd, and |then inc|
|00002f70| 6c 75 64 69 6e 67 20 74 | 68 65 20 66 69 6e 61 6c |luding t|he final|
|00002f80| 20 63 6f 64 65 20 69 6e | 0a 20 74 68 65 20 4c 69 | code in|. the Li|
|00002f90| 62 72 61 72 79 2e 20 54 | 68 69 73 20 68 61 73 20 |brary. T|his has |
|00002fa0| 68 65 6c 70 65 64 20 74 | 6f 20 6b 65 65 70 20 65 |helped t|o keep e|
|00002fb0| 76 65 72 79 74 68 69 6e | 67 20 61 73 20 63 6f 6e |verythin|g as con|
|00002fc0| 73 69 73 74 65 6e 74 20 | 61 73 20 70 6f 73 73 69 |sistent |as possi|
|00002fd0| 62 6c 65 0a 20 74 68 72 | 6f 75 67 68 6f 75 74 20 |ble. thr|oughout |
|00002fe0| 74 68 65 20 6c 69 62 72 | 61 72 79 2e 20 28 54 68 |the libr|ary. (Th|
|00002ff0| 6f 75 67 68 20 49 20 63 | 61 6e 27 74 20 67 75 61 |ough I c|an't gua|
|00003000| 72 61 6e 74 65 65 20 74 | 68 61 74 20 74 68 65 20 |rantee t|hat the |
|00003010| 6c 69 62 72 61 72 79 20 | 69 73 0a 20 70 65 72 66 |library |is. perf|
|00003020| 65 63 74 2c 20 49 20 62 | 65 6c 69 65 76 65 20 69 |ect, I b|elieve i|
|00003030| 74 20 69 73 20 66 61 72 | 20 73 75 70 65 72 69 6f |t is far| superio|
|00003040| 72 20 74 6f 20 52 49 53 | 43 20 4f 53 20 4c 69 62 |r to RIS|C OS Lib|
|00003050| 20 69 6e 20 74 68 65 20 | 61 72 65 61 73 20 69 74 | in the |areas it|
|00003060| 0a 20 63 75 72 72 65 6e | 74 6c 79 20 63 6f 76 65 |. curren|tly cove|
|00003070| 72 73 29 0a 0a 20 54 68 | 65 20 63 6f 64 65 20 68 |rs).. Th|e code h|
|00003080| 61 73 20 62 65 65 6e 20 | 77 72 69 74 74 65 6e 20 |as been |written |
|00003090| 74 6f 20 70 72 6f 76 69 | 64 65 20 61 20 68 69 67 |to provi|de a hig|
|000030a0| 68 2d 6c 65 76 65 6c 20 | 69 6e 74 65 72 66 61 63 |h-level |interfac|
|000030b0| 65 20 74 68 61 74 20 73 | 75 70 70 6f 72 74 73 2c |e that s|upports,|
|000030c0| 0a 20 65 6e 63 6f 75 72 | 61 67 65 73 2c 20 61 6e |. encour|ages, an|
|000030d0| 64 20 61 6c 6c 20 42 55 | 54 20 66 6f 72 63 65 73 |d all BU|T forces|
|000030e0| 20 70 72 6f 67 72 61 6d | 6d 65 72 73 20 74 6f 20 | program|mers to |
|000030f0| 75 73 65 20 61 20 6d 6f | 72 65 20 63 6f 6e 73 69 |use a mo|re consi|
|00003100| 73 74 65 6e 74 0a 20 69 | 6e 74 65 72 66 61 63 65 |stent. i|nterface|
|00003110| 20 64 65 73 69 67 6e 2c | 20 77 68 69 63 68 20 77 | design,| which w|
|00003120| 69 6c 6c 20 62 65 20 62 | 72 6f 75 67 68 74 20 69 |ill be b|rought i|
|00003130| 6e 74 6f 20 6c 69 6e 65 | 20 77 69 74 68 20 74 68 |nto line| with th|
|00003140| 65 20 41 63 6f 72 6e 20 | 53 74 79 6c 65 0a 20 47 |e Acorn |Style. G|
|00003150| 75 69 64 65 20 61 73 20 | 73 6f 6f 6e 20 61 73 20 |uide as |soon as |
|00003160| 41 63 6f 72 6e 20 6d 61 | 6b 65 20 75 70 20 74 68 |Acorn ma|ke up th|
|00003170| 65 69 72 20 6d 69 6e 64 | 73 2e 2e 2e 0a 20 54 68 |eir mind|s.... Th|
|00003180| 65 20 70 72 6f 67 72 61 | 6d 6d 65 72 20 75 73 69 |e progra|mmer usi|
|00003190| 6e 67 20 44 65 73 6b 4c | 69 62 20 69 73 20 65 6e |ng DeskL|ib is en|
|000031a0| 63 6f 75 72 61 67 65 64 | 20 74 6f 20 75 73 65 20 |couraged| to use |
|000031b0| 6f 75 72 20 6d 6f 72 65 | 20 67 65 6e 65 72 69 63 |our more| generic|
|000031c0| 20 74 65 6d 70 6c 61 74 | 65 0a 20 61 6e 64 20 6d | templat|e. and m|
|000031d0| 65 6e 75 20 72 6f 75 74 | 69 6e 65 73 2c 20 73 6f |enu rout|ines, so|
|000031e0| 20 74 68 61 74 20 74 68 | 65 20 45 4e 44 20 55 53 | that th|e END US|
|000031f0| 45 52 20 6f 66 20 74 68 | 65 20 70 72 6f 64 75 63 |ER of th|e produc|
|00003200| 74 20 68 61 73 20 6d 6f | 72 65 20 63 6f 6e 74 72 |t has mo|re contr|
|00003210| 6f 6c 20 0a 20 6f 66 20 | 74 68 65 20 6c 6f 6f 6b |ol . of |the look|
|00003220| 2c 20 66 65 65 6c 2c 20 | 6c 61 79 6f 75 74 2c 20 |, feel, |layout, |
|00003230| 61 6e 64 20 68 6f 74 6b | 65 79 73 20 75 73 65 64 |and hotk|eys used|
|00003240| 20 69 6e 20 74 68 65 20 | 70 72 6f 67 72 61 6d 2e | in the |program.|
|00003250| 0a 0a 20 48 6f 77 65 76 | 65 72 2c 20 61 6e 6f 74 |.. Howev|er, anot|
|00003260| 68 65 72 20 69 6d 70 6f | 72 74 61 6e 74 20 63 6f |her impo|rtant co|
|00003270| 6e 63 65 70 74 20 69 73 | 20 74 68 61 74 20 59 4f |ncept is| that YO|
|00003280| 55 20 61 72 65 20 69 6e | 20 63 68 61 72 67 65 2c |U are in| charge,|
|00003290| 20 61 6e 64 20 44 65 73 | 6b 4c 69 62 0a 20 69 73 | and Des|kLib. is|
|000032a0| 20 6a 75 73 74 20 61 20 | 74 6f 6f 6c 20 66 6f 72 | just a |tool for|
|000032b0| 20 79 6f 75 20 74 6f 20 | 75 73 65 2c 20 73 6f 20 | you to |use, so |
|000032c0| 69 74 20 73 68 6f 75 6c | 64 20 6e 6f 74 20 66 6f |it shoul|d not fo|
|000032d0| 72 63 65 20 79 6f 75 20 | 61 67 61 69 6e 73 74 20 |rce you |against |
|000032e0| 79 6f 75 72 20 77 69 6c | 6c 0a 20 69 66 20 70 6f |your wil|l. if po|
|000032f0| 73 73 69 62 6c 65 2e 20 | 54 68 75 73 2c 20 77 65 |ssible. |Thus, we|
|00003300| 20 70 72 6f 76 69 64 65 | 20 75 6e 72 65 73 74 72 | provide| unrestr|
|00003310| 69 63 74 65 64 20 6c 6f | 77 2d 6c 65 76 65 6c 20 |icted lo|w-level |
|00003320| 61 63 63 65 73 73 20 61 | 73 20 77 65 6c 6c 2e 20 |access a|s well. |
|00003330| 41 6e 64 20 62 79 0a 20 | 70 72 6f 76 69 64 69 6e |And by. |providin|
|00003340| 67 20 74 68 65 20 73 6f | 75 72 63 65 73 2c 20 77 |g the so|urces, w|
|00003350| 65 20 6d 61 6b 65 20 69 | 74 20 70 6f 73 73 69 62 |e make i|t possib|
|00003360| 6c 65 20 66 6f 72 20 79 | 6f 75 20 74 6f 20 64 6f |le for y|ou to do|
|00003370| 20 6c 6f 77 2d 6c 65 76 | 65 6c 20 22 74 77 65 61 | low-lev|el "twea|
|00003380| 6b 73 22 0a 20 6f 6e 20 | 6f 75 72 20 68 69 67 68 |ks". on |our high|
|00003390| 2d 6c 65 76 65 6c 20 64 | 61 74 61 20 73 74 72 75 |-level d|ata stru|
|000033a0| 63 74 75 72 65 73 20 77 | 69 74 68 6f 75 74 20 74 |ctures w|ithout t|
|000033b0| 68 65 20 66 65 61 72 20 | 74 68 61 74 20 79 6f 75 |he fear |that you|
|000033c0| 20 6d 69 67 68 74 20 62 | 65 0a 20 74 72 65 61 64 | might b|e. tread|
|000033d0| 69 6e 67 20 6f 6e 20 74 | 68 65 20 74 6f 65 73 20 |ing on t|he toes |
|000033e0| 6f 66 20 73 6f 6d 65 20 | 6f 74 68 65 72 20 63 6f |of some |other co|
|000033f0| 64 65 2e 2e 2e 0a 0a 20 | 57 65 20 61 6c 73 6f 20 |de..... |We also |
|00003400| 66 65 65 6c 20 69 74 20 | 69 73 20 69 6d 70 6f 72 |feel it |is impor|
|00003410| 74 61 6e 74 20 74 6f 20 | 64 69 73 74 72 69 62 75 |tant to |distribu|
|00003420| 74 65 20 74 68 65 20 6c | 69 62 72 61 72 79 20 73 |te the l|ibrary s|
|00003430| 6f 75 72 63 65 73 20 66 | 72 65 65 6c 79 2c 20 73 |ources f|reely, s|
|00003440| 6f 0a 20 74 68 61 74 20 | 79 6f 75 20 6d 61 79 20 |o. that |you may |
|00003450| 69 6d 70 72 6f 76 65 20 | 6f 72 20 61 6c 74 65 72 |improve |or alter|
|00003460| 20 74 68 65 20 6c 69 62 | 72 61 72 79 20 74 6f 20 | the lib|rary to |
|00003470| 73 75 69 74 20 79 6f 75 | 72 20 6f 77 6e 20 6e 65 |suit you|r own ne|
|00003480| 65 64 73 2c 20 61 6e 64 | 0a 20 68 6f 70 65 66 75 |eds, and|. hopefu|
|00003490| 6c 6c 79 20 73 65 6e 64 | 20 62 61 63 6b 20 61 6e |lly send| back an|
|000034a0| 79 20 69 6d 70 72 6f 76 | 65 6d 65 6e 74 73 20 6f |y improv|ements o|
|000034b0| 72 20 62 75 67 20 66 69 | 78 65 73 20 74 6f 20 6d |r bug fi|xes to m|
|000034c0| 65 20 73 6f 20 74 68 61 | 74 20 74 68 65 79 20 6d |e so tha|t they m|
|000034d0| 61 79 20 62 65 0a 20 6f | 66 66 69 63 69 61 6c 6c |ay be. o|fficiall|
|000034e0| 79 20 69 6e 63 6f 72 70 | 6f 72 61 74 65 64 20 69 |y incorp|orated i|
|000034f0| 6e 74 6f 20 74 68 65 20 | 44 65 73 6b 4c 69 62 20 |nto the |DeskLib |
|00003500| 64 69 73 74 72 69 62 75 | 74 69 6f 6e 2e 20 41 6c |distribu|tion. Al|
|00003510| 73 6f 2c 20 79 6f 75 20 | 63 61 6e 20 53 45 45 0a |so, you |can SEE.|
|00003520| 20 77 68 61 74 20 66 75 | 6e 63 74 69 6f 6e 73 20 | what fu|nctions |
|00003530| 64 6f 2c 20 61 6e 64 20 | 74 68 75 73 20 4b 4e 4f |do, and |thus KNO|
|00003540| 57 20 77 68 61 74 20 74 | 68 65 79 20 64 6f 2c 20 |W what t|hey do, |
|00003550| 61 6e 64 20 74 68 65 72 | 65 66 6f 72 65 20 62 65 |and ther|efore be|
|00003560| 20 61 62 6c 65 20 74 6f | 0a 20 63 6f 70 65 20 77 | able to|. cope w|
|00003570| 69 74 68 20 77 68 61 74 | 20 74 68 65 79 20 64 6f |ith what| they do|
|00003580| 2c 20 72 61 74 68 65 72 | 20 74 68 61 6e 20 74 72 |, rather| than tr|
|00003590| 69 70 70 69 6e 67 20 6f | 76 65 72 20 6c 6f 77 2d |ipping o|ver low-|
|000035a0| 6c 65 76 65 6c 20 69 6d | 70 6c 65 6d 65 6e 74 61 |level im|plementa|
|000035b0| 74 69 6f 6e 0a 20 64 65 | 74 61 69 6c 73 2f 62 75 |tion. de|tails/bu|
|000035c0| 67 73 20 74 68 61 74 20 | 74 68 65 20 61 75 74 68 |gs that |the auth|
|000035d0| 6f 72 20 64 69 64 6e 27 | 74 20 62 6f 74 68 65 72 |or didn'|t bother|
|000035e0| 20 74 6f 20 6d 61 6b 65 | 20 79 6f 75 20 61 77 61 | to make| you awa|
|000035f0| 72 65 20 6f 66 2e 0a 0a | 20 57 65 20 68 61 76 65 |re of...| We have|
|00003600| 20 61 62 73 6f 6c 75 74 | 65 6c 79 20 4e 4f 20 6f | absolut|ely NO o|
|00003610| 62 6a 65 63 74 69 6f 6e | 20 74 6f 20 69 6e 63 6c |bjection| to incl|
|00003620| 75 64 69 6e 67 20 53 45 | 56 45 52 41 4c 20 44 49 |uding SE|VERAL DI|
|00003630| 46 46 45 52 45 4e 54 20 | 63 6f 64 65 20 6d 6f 64 |FFERENT |code mod|
|00003640| 75 6c 65 73 0a 20 74 68 | 61 74 20 64 6f 20 65 73 |ules. th|at do es|
|00003650| 73 65 6e 74 69 61 6c 6c | 79 20 74 68 65 20 73 61 |sentiall|y the sa|
|00003660| 6d 65 20 74 68 69 6e 67 | 2c 20 73 6f 20 74 68 61 |me thing|, so tha|
|00003670| 74 20 79 6f 75 20 6d 61 | 79 20 43 48 4f 4f 53 45 |t you ma|y CHOOSE|
|00003680| 20 74 68 65 20 6f 6e 65 | 20 74 68 61 74 0a 20 73 | the one| that. s|
|00003690| 75 69 74 73 20 79 6f 75 | 20 62 65 73 74 2e 0a 0a |uits you| best...|
|000036a0| 0a 0a 54 68 65 20 66 75 | 74 75 72 65 0a 20 41 73 |..The fu|ture. As|
|000036b0| 20 77 65 6c 6c 20 61 73 | 20 67 72 6f 77 69 6e 67 | well as| growing|
|000036c0| 20 74 6f 20 69 6e 63 6c | 75 64 65 20 6d 6f 72 65 | to incl|ude more|
|000036d0| 20 61 6e 64 20 6d 6f 72 | 65 20 63 6f 64 65 20 72 | and mor|e code r|
|000036e0| 65 73 6f 75 72 63 65 73 | 2c 20 74 68 72 65 65 20 |esources|, three |
|000036f0| 69 6d 70 6f 72 74 61 6e | 74 0a 20 67 6f 61 6c 73 |importan|t. goals|
|00003700| 20 66 6f 72 20 74 68 65 | 20 66 75 74 75 72 65 20 | for the| future |
|00003710| 6f 66 20 74 68 69 73 20 | 4c 69 62 72 61 72 79 20 |of this |Library |
|00003720| 61 72 65 3a 0a 20 20 2a | 20 43 6f 6e 76 65 72 73 |are:.  *| Convers|
|00003730| 69 6f 6e 20 74 6f 20 61 | 73 73 65 6d 62 6c 65 72 |ion to a|ssembler|
|00003740| 2e 20 53 6d 61 6c 6c 20 | 61 6e 64 20 73 69 6d 70 |. Small |and simp|
|00003750| 6c 65 20 66 75 6e 63 74 | 69 6f 6e 73 20 28 49 63 |le funct|ions (Ic|
|00003760| 6f 6e 5f 53 65 6c 65 63 | 74 2c 20 65 74 63 29 0a |on_Selec|t, etc).|
|00003770| 20 20 20 20 61 72 65 20 | 65 78 74 72 65 6d 65 6c |    are |extremel|
|00003780| 79 20 65 61 73 79 20 74 | 6f 20 63 6f 6e 76 65 72 |y easy t|o conver|
|00003790| 74 20 74 6f 20 61 73 73 | 65 6d 62 6c 65 72 2e 20 |t to ass|embler. |
|000037a0| 54 68 69 73 20 61 6c 73 | 6f 20 68 61 73 20 74 68 |This als|o has th|
|000037b0| 65 20 61 64 76 61 6e 74 | 61 67 65 0a 20 20 20 20 |e advant|age.    |
|000037c0| 6f 66 20 72 65 64 75 63 | 69 6e 67 20 74 68 65 69 |of reduc|ing thei|
|000037d0| 72 20 73 69 7a 65 20 61 | 74 20 74 68 65 20 73 61 |r size a|t the sa|
|000037e0| 6d 65 20 74 69 6d 65 20 | 61 73 20 69 6e 63 72 65 |me time |as incre|
|000037f0| 61 73 69 6e 67 20 65 66 | 66 69 63 69 65 6e 63 79 |asing ef|ficiency|
|00003800| 2e 20 54 68 65 20 67 6f | 61 6c 0a 20 20 20 20 69 |. The go|al.    i|
|00003810| 73 20 74 6f 20 63 6f 6e | 76 65 72 74 20 61 73 20 |s to con|vert as |
|00003820| 6d 75 63 68 20 6f 66 20 | 74 68 65 20 6c 69 62 72 |much of |the libr|
|00003830| 61 72 79 20 61 73 20 70 | 6f 73 73 69 62 6c 65 20 |ary as p|ossible |
|00003840| 74 6f 20 61 20 6d 6f 72 | 65 20 65 66 66 69 63 69 |to a mor|e effici|
|00003850| 65 6e 74 0a 20 20 20 20 | 69 6d 70 6c 65 6d 65 6e |ent.    |implemen|
|00003860| 74 61 74 69 6f 6e 20 6f | 76 65 72 20 74 69 6d 65 |tation o|ver time|
|00003870| 2e 20 54 68 69 73 20 77 | 69 6c 6c 20 6e 6f 74 20 |. This w|ill not |
|00003880| 61 66 66 65 63 74 20 74 | 68 65 20 69 6e 74 65 72 |affect t|he inter|
|00003890| 66 61 63 65 2c 20 73 6f | 20 65 78 69 73 74 69 6e |face, so| existin|
|000038a0| 67 0a 20 20 20 20 61 70 | 70 6c 69 63 61 74 69 6f |g.    ap|plicatio|
|000038b0| 6e 73 20 63 61 6e 20 62 | 65 6e 65 66 69 74 20 66 |ns can b|enefit f|
|000038c0| 72 6f 6d 20 74 68 65 20 | 63 6f 6e 76 65 72 73 69 |rom the |conversi|
|000038d0| 6f 6e 20 62 79 20 73 69 | 6d 70 6c 79 20 72 65 6c |on by si|mply rel|
|000038e0| 69 6e 6b 69 6e 67 20 77 | 69 74 68 0a 20 20 20 20 |inking w|ith.    |
|000038f0| 74 68 65 20 6e 65 77 20 | 66 75 6e 63 74 69 6f 6e |the new |function|
|00003900| 73 2e 0a 0a 20 20 2a 20 | 53 75 70 70 6f 72 74 20 |s...  * |Support |
|00003910| 66 6f 72 20 47 6c 61 7a | 69 65 72 27 73 20 27 47 |for Glaz|ier's 'G|
|00003920| 6c 61 73 73 27 20 74 65 | 6d 70 6c 61 74 65 20 66 |lass' te|mplate f|
|00003930| 6f 72 6d 61 74 2c 20 69 | 6e 63 6c 75 64 69 6e 67 |ormat, i|ncluding|
|00003940| 20 6d 65 6e 75 2c 20 77 | 69 6e 64 6f 77 2c 20 69 | menu, w|indow, i|
|00003950| 63 6f 6e 0a 20 20 20 20 | 61 6e 64 20 68 6f 74 6b |con.    |and hotk|
|00003960| 65 79 20 74 65 6d 70 6c | 61 74 65 73 2c 20 61 6e |ey templ|ates, an|
|00003970| 64 20 73 70 65 63 69 61 | 6c 20 63 72 65 61 74 75 |d specia|l creatu|
|00003980| 72 65 73 20 73 75 63 68 | 20 61 73 20 27 6d 65 74 |res such| as 'met|
|00003990| 61 2d 69 63 6f 6e 73 27 | 20 28 74 68 69 6e 67 73 |a-icons'| (things|
|000039a0| 0a 20 20 20 20 6c 69 6b | 65 20 73 6c 69 64 65 72 |.    lik|e slider|
|000039b0| 20 69 63 6f 6e 73 20 77 | 68 69 63 68 20 61 72 65 | icons w|hich are|
|000039c0| 20 6d 61 64 65 20 75 70 | 20 6f 66 20 6d 6f 72 65 | made up| of more|
|000039d0| 20 74 68 61 6e 20 6f 6e | 65 20 57 69 6d 70 20 69 | than on|e Wimp i|
|000039e0| 63 6f 6e 2c 20 62 75 74 | 20 63 61 6e 0a 20 20 20 |con, but| can.   |
|000039f0| 20 62 65 20 74 72 65 61 | 74 65 64 20 62 79 20 74 | be trea|ted by t|
|00003a00| 68 65 20 6d 61 69 6e 20 | 70 72 6f 67 72 61 6d 20 |he main |program |
|00003a10| 61 73 20 61 20 73 69 6e | 67 6c 65 20 65 6e 74 69 |as a sin|gle enti|
|00003a20| 74 79 29 0a 0a 20 20 2a | 20 50 72 6f 64 75 63 74 |ty)..  *| Product|
|00003a30| 69 6f 6e 20 6f 66 20 61 | 20 73 68 61 72 65 64 20 |ion of a| shared |
|00003a40| 44 65 73 6b 4c 69 62 20 | 63 6f 64 65 20 6c 69 62 |DeskLib |code lib|
|00003a50| 72 61 72 79 20 72 65 6c | 6f 63 61 74 61 62 6c 65 |rary rel|ocatable|
|00003a60| 20 6d 6f 64 75 6c 65 2c | 20 61 6c 6f 6e 67 0a 20 | module,| along. |
|00003a70| 20 20 20 73 69 6d 69 6c | 61 72 20 6c 69 6e 65 73 |   simil|ar lines|
|00003a80| 20 74 6f 20 74 68 65 20 | 65 78 69 73 74 69 6e 67 | to the |existing|
|00003a90| 20 41 4e 53 49 20 53 68 | 61 72 65 64 43 4c 69 62 | ANSI Sh|aredCLib|
|00003aa0| 72 61 72 79 2e 20 54 68 | 69 73 20 77 69 6c 6c 20 |rary. Th|is will |
|00003ab0| 62 61 73 69 63 61 6c 6c | 79 20 6d 6f 76 65 0a 20 |basicall|y move. |
|00003ac0| 20 20 20 74 68 65 20 6d | 6f 73 74 20 69 6d 70 6f |   the m|ost impo|
|00003ad0| 72 74 61 6e 74 20 73 6d | 61 6c 6c 20 66 75 6e 63 |rtant sm|all func|
|00003ae0| 74 69 6f 6e 73 20 69 6e | 74 6f 20 61 20 53 4d 41 |tions in|to a SMA|
|00003af0| 4c 4c 20 72 65 6c 6f 63 | 61 74 61 62 6c 65 20 6d |LL reloc|atable m|
|00003b00| 6f 64 75 6c 65 20 73 6f | 20 74 68 61 74 0a 20 20 |odule so| that.  |
|00003b10| 20 20 74 68 65 20 63 6f | 64 65 20 72 65 73 6f 75 |  the co|de resou|
|00003b20| 72 63 65 73 20 6d 61 79 | 20 62 65 20 73 68 61 72 |rces may| be shar|
|00003b30| 65 64 20 62 79 20 61 6c | 6c 20 64 65 73 6b 74 6f |ed by al|l deskto|
|00003b40| 70 20 74 61 73 6b 73 2c | 20 69 6e 63 6c 75 64 69 |p tasks,| includi|
|00003b50| 6e 67 20 6f 6e 65 73 0a | 20 20 20 20 77 72 69 74 |ng ones.|    writ|
|00003b60| 74 65 6e 20 69 6e 20 43 | 2c 20 61 73 73 65 6d 62 |ten in C|, assemb|
|00003b70| 6c 65 72 2c 20 61 6e 64 | 20 28 68 6f 70 65 66 75 |ler, and| (hopefu|
|00003b80| 6c 6c 79 29 20 42 41 53 | 49 43 2e 0a 0a 0a 0a 41 |lly) BAS|IC.....A|
|00003b90| 75 74 68 6f 72 73 0a 20 | 49 66 20 63 6f 64 65 20 |uthors. |If code |
|00003ba0| 79 6f 75 20 68 61 76 65 | 20 77 72 69 74 74 65 6e |you have| written|
|00003bb0| 20 69 73 20 69 6e 63 6f | 72 70 6f 72 61 74 65 64 | is inco|rporated|
|00003bc0| 20 69 6e 74 6f 20 74 68 | 69 73 20 6c 69 62 72 61 | into th|is libra|
|00003bd0| 72 79 2c 20 79 6f 75 20 | 73 74 69 6c 6c 0a 20 72 |ry, you |still. r|
|00003be0| 65 74 61 69 6e 20 79 6f | 75 72 20 63 6f 70 79 72 |etain yo|ur copyr|
|00003bf0| 69 67 68 74 20 66 6f 72 | 20 69 74 2e 20 48 6f 77 |ight for| it. How|
|00003c00| 65 76 65 72 2c 20 69 66 | 20 79 6f 75 20 77 69 73 |ever, if| you wis|
|00003c10| 68 20 74 6f 20 72 65 74 | 72 61 63 74 0a 20 63 6f |h to ret|ract. co|
|00003c20| 70 79 2d 70 65 72 6d 69 | 73 73 69 6f 6e 20 66 6f |py-permi|ssion fo|
|00003c30| 72 20 61 20 70 61 72 74 | 20 6f 66 20 44 65 73 6b |r a part| of Desk|
|00003c40| 4c 69 62 20 79 6f 75 20 | 68 61 76 65 20 77 72 69 |Lib you |have wri|
|00003c50| 74 74 65 6e 2c 20 74 68 | 65 6e 20 69 74 20 77 69 |tten, th|en it wi|
|00003c60| 6c 6c 20 62 65 0a 20 72 | 65 6d 6f 76 65 64 20 66 |ll be. r|emoved f|
|00003c70| 72 6f 6d 20 2a 66 75 74 | 75 72 65 2a 20 72 65 6c |rom *fut|ure* rel|
|00003c80| 65 61 73 65 73 20 6f 66 | 20 74 68 65 20 64 69 73 |eases of| the dis|
|00003c90| 74 72 69 62 75 69 6f 6e | 2c 20 61 6e 64 20 74 68 |tribuion|, and th|
|00003ca0| 65 20 72 65 74 72 61 63 | 74 69 6f 6e 20 77 69 6c |e retrac|tion wil|
|00003cb0| 6c 0a 20 6e 6f 74 20 61 | 66 66 65 63 74 20 70 72 |l. not a|ffect pr|
|00003cc0| 65 76 69 6f 75 73 20 72 | 65 6c 65 61 73 65 20 76 |evious r|elease v|
|00003cd0| 65 72 73 69 6f 6e 73 20 | 6f 66 20 74 68 65 20 6c |ersions |of the l|
|00003ce0| 69 62 72 61 72 79 2c 20 | 6f 72 20 61 6e 79 20 73 |ibrary, |or any s|
|00003cf0| 6f 66 74 77 61 72 65 0a | 20 70 72 6f 64 75 63 74 |oftware.| product|
|00003d00| 20 74 68 61 74 20 75 73 | 65 64 20 74 68 65 6d 2e | that us|ed them.|
|00003d10| 20 50 72 6f 62 61 62 6c | 79 20 61 6e 20 65 71 75 | Probabl|y an equ|
|00003d20| 69 76 61 6c 65 6e 74 20 | 62 69 74 20 6f 66 20 63 |ivalent |bit of c|
|00003d30| 6f 64 65 20 77 69 6c 6c | 20 74 68 65 6e 20 62 65 |ode will| then be|
|00003d40| 0a 20 77 72 69 74 74 65 | 6e 20 62 79 20 73 6f 6d |. writte|n by som|
|00003d50| 65 62 6f 64 79 20 65 6c | 73 65 20 74 6f 20 66 69 |ebody el|se to fi|
|00003d60| 6c 6c 20 74 68 65 20 67 | 61 70 2e 0a 0a 20 49 66 |ll the g|ap... If|
|00003d70| 20 44 65 73 6b 4c 69 62 | 20 69 73 20 75 70 64 61 | DeskLib| is upda|
|00003d80| 74 65 64 20 62 79 20 73 | 6f 6d 65 6f 6e 65 20 77 |ted by s|omeone w|
|00003d90| 72 69 74 69 6e 67 20 63 | 6f 64 65 20 62 61 73 65 |riting c|ode base|
|00003da0| 64 20 75 70 6f 6e 20 79 | 6f 75 72 20 73 75 67 67 |d upon y|our sugg|
|00003db0| 65 73 74 69 6f 6e 73 0a | 20 61 6e 64 2f 6f 72 20 |estions.| and/or |
|00003dc0| 63 6f 64 65 2c 20 74 68 | 65 6e 20 74 68 65 79 20 |code, th|en they |
|00003dd0| 72 65 74 61 69 6e 20 63 | 6f 70 79 72 69 67 68 74 |retain c|opyright|
|00003de0| 20 66 6f 72 20 74 68 61 | 74 20 77 68 69 63 68 20 | for tha|t which |
|00003df0| 74 68 65 79 20 68 61 76 | 65 20 77 72 69 74 74 65 |they hav|e writte|
|00003e00| 6e 2c 0a 20 74 68 6f 75 | 67 68 20 79 6f 75 20 77 |n,. thou|gh you w|
|00003e10| 69 6c 6c 20 62 65 20 63 | 72 65 64 69 74 65 64 20 |ill be c|redited |
|00003e20| 69 6e 20 74 68 65 20 75 | 70 64 61 74 65 64 20 66 |in the u|pdated f|
|00003e30| 69 6c 65 28 73 29 2e 0a | 0a 20 49 66 20 79 6f 75 |ile(s)..|. If you|
|00003e40| 20 77 72 69 74 65 20 61 | 6e 79 20 46 72 65 65 57 | write a|ny FreeW|
|00003e50| 61 72 65 20 75 73 69 6e | 67 20 74 68 65 20 44 65 |are usin|g the De|
|00003e60| 73 6b 4c 69 62 20 6c 69 | 62 72 61 72 69 65 73 2c |skLib li|braries,|
|00003e70| 20 69 74 20 77 6f 75 6c | 64 20 62 65 20 72 65 61 | it woul|d be rea|
|00003e80| 6c 6c 79 0a 20 6e 69 63 | 65 20 6f 66 20 79 6f 75 |lly. nic|e of you|
|00003e90| 20 74 6f 20 73 65 6e 64 | 20 6d 65 20 61 20 63 6f | to send| me a co|
|00003ea0| 70 79 20 6f 66 20 74 68 | 65 20 73 6f 75 72 63 65 |py of th|e source|
|00003eb0| 73 20 61 6e 64 20 66 69 | 6e 61 6c 20 61 70 70 6c |s and fi|nal appl|
|00003ec0| 69 63 61 74 69 6f 6e 20 | 74 6f 0a 20 70 6f 73 73 |ication |to. poss|
|00003ed0| 69 62 6c 79 20 62 65 20 | 69 6e 63 6c 75 64 65 64 |ibly be |included|
|00003ee0| 20 69 6e 20 66 75 74 75 | 72 65 20 44 65 73 6b 4c | in futu|re DeskL|
|00003ef0| 69 62 20 72 65 6c 65 61 | 73 65 73 20 61 73 20 74 |ib relea|ses as t|
|00003f00| 75 74 6f 72 69 61 6c 2f | 64 65 6d 6f 6e 73 74 72 |utorial/|demonstr|
|00003f10| 61 74 69 6f 6e 0a 20 63 | 6f 64 65 2c 20 6f 72 20 |ation. c|ode, or |
|00003f20| 61 74 20 6c 65 61 73 74 | 20 64 69 73 74 72 69 62 |at least| distrib|
|00003f30| 75 74 65 20 79 6f 75 72 | 20 73 6f 75 72 63 65 73 |ute your| sources|
|00003f40| 20 28 6f 72 20 70 61 72 | 74 73 20 74 68 65 72 65 | (or par|ts there|
|00003f50| 6f 66 29 20 77 69 74 68 | 20 79 6f 75 72 0a 20 61 |of) with| your. a|
|00003f60| 70 70 6c 69 63 61 74 69 | 6f 6e 20 73 6f 20 74 68 |pplicati|on so th|
|00003f70| 61 74 20 74 68 65 79 20 | 6d 61 79 20 73 65 72 76 |at they |may serv|
|00003f80| 65 20 61 73 20 65 78 61 | 6d 70 6c 65 20 63 6f 64 |e as exa|mple cod|
|00003f90| 65 20 66 6f 72 20 6f 74 | 68 65 72 73 2e 0a 0a 20 |e for ot|hers... |
|00003fa0| 46 6f 72 20 64 6f 63 75 | 6d 65 6e 74 61 74 69 6f |For docu|mentatio|
|00003fb0| 6e 20 6f 6e 20 75 73 69 | 6e 67 20 44 65 73 6b 4c |n on usi|ng DeskL|
|00003fc0| 69 62 20 69 6e 20 79 6f | 75 72 20 6f 77 6e 20 70 |ib in yo|ur own p|
|00003fd0| 72 6f 67 72 61 6d 6d 69 | 6e 67 20 70 72 6f 6a 65 |rogrammi|ng proje|
|00003fe0| 63 74 73 2c 20 61 6e 64 | 0a 20 73 75 62 6d 69 74 |cts, and|. submit|
|00003ff0| 74 69 6e 67 20 79 6f 75 | 72 20 6f 77 6e 20 63 6f |ting you|r own co|
|00004000| 64 65 2f 69 64 65 61 73 | 20 66 6f 72 20 69 6e 63 |de/ideas| for inc|
|00004010| 6c 75 73 69 6f 6e 20 69 | 6e 20 44 65 73 6b 4c 69 |lusion i|n DeskLi|
|00004020| 62 2c 20 70 6c 65 61 73 | 65 20 72 65 61 64 20 74 |b, pleas|e read t|
|00004030| 68 65 0a 20 66 69 6c 65 | 73 20 69 6e 20 74 68 65 |he. file|s in the|
|00004040| 20 44 6f 63 73 20 64 69 | 72 65 63 74 6f 72 79 2e | Docs di|rectory.|
|00004050| 20 4e 6f 74 65 20 74 68 | 61 74 20 6d 6f 73 74 20 | Note th|at most |
|00004060| 6f 66 20 74 68 65 20 64 | 6f 63 75 6d 65 6e 74 61 |of the d|ocumenta|
|00004070| 74 69 6f 6e 20 6f 66 0a | 20 66 75 6e 63 74 69 6f |tion of.| functio|
|00004080| 6e 20 63 61 6c 6c 73 20 | 69 73 20 70 72 6f 76 69 |n calls |is provi|
|00004090| 64 65 64 20 69 6e 20 74 | 68 65 20 66 6f 72 6d 20 |ded in t|he form |
|000040a0| 6f 66 20 63 6f 6d 6d 65 | 6e 74 73 20 69 6e 20 74 |of comme|nts in t|
|000040b0| 68 65 20 72 65 6c 65 76 | 61 6e 74 20 68 65 61 64 |he relev|ant head|
|000040c0| 65 72 0a 20 28 2e 68 29 | 20 66 69 6c 65 73 20 61 |er. (.h)| files a|
|000040d0| 74 20 70 72 65 73 65 6e | 74 2e 0a 0a 20 54 68 65 |t presen|t... The|
|000040e0| 20 6c 61 73 74 20 70 6f | 69 6e 74 20 69 73 20 74 | last po|int is t|
|000040f0| 68 61 74 20 61 6c 74 68 | 6f 75 67 68 20 77 65 20 |hat alth|ough we |
|00004100| 61 72 65 20 74 72 79 69 | 6e 67 20 74 6f 20 70 72 |are tryi|ng to pr|
|00004110| 6f 76 69 64 65 20 63 6f | 6d 70 6c 65 74 65 20 75 |ovide co|mplete u|
|00004120| 73 65 66 75 6c 0a 20 63 | 6f 64 65 2c 20 73 6f 6d |seful. c|ode, som|
|00004130| 65 20 62 75 67 73 20 61 | 72 65 20 62 6f 75 6e 64 |e bugs a|re bound|
|00004140| 20 74 6f 20 66 61 6c 6c | 20 74 68 72 6f 75 67 68 | to fall| through|
|00004150| 20 74 68 65 20 6e 65 74 | 2e 2e 2e 20 53 6f 6d 65 | the net|... Some|
|00004160| 20 64 65 63 69 73 69 6f | 6e 73 20 6f 6e 0a 20 6e | decisio|ns on. n|
|00004170| 61 6d 69 6e 67 20 6f 72 | 20 64 61 74 61 20 73 74 |aming or| data st|
|00004180| 72 75 63 74 75 72 65 73 | 20 6d 61 79 20 73 65 65 |ructures| may see|
|00004190| 6d 20 62 61 64 20 74 6f | 20 79 6f 75 20 28 73 6f |m bad to| you (so|
|000041a0| 6d 65 20 64 6f 20 74 6f | 20 6d 65 29 2c 20 62 75 |me do to| me), bu|
|000041b0| 74 20 77 65 0a 20 68 61 | 76 65 20 6f 75 72 20 72 |t we. ha|ve our r|
|000041c0| 65 61 73 6f 6e 73 20 28 | 75 73 75 61 6c 6c 79 20 |easons (|usually |
|000041d0| 63 6f 6e 73 69 73 74 65 | 6e 63 79 29 20 66 6f 72 |consiste|ncy) for|
|000041e0| 20 64 6f 69 6e 67 20 74 | 68 69 6e 67 73 20 74 68 | doing t|hings th|
|000041f0| 69 73 20 77 61 79 2e 0a | 20 57 65 20 61 72 65 20 |is way..| We are |
|00004200| 64 6f 69 6e 67 20 6f 75 | 72 20 62 65 73 74 3a 20 |doing ou|r best: |
|00004210| 43 6f 6e 73 74 72 75 63 | 74 69 76 65 20 63 72 69 |Construc|tive cri|
|00004220| 74 69 63 69 73 6d 20 69 | 73 20 77 65 6c 63 6f 6d |ticism i|s welcom|
|00004230| 65 2c 20 62 75 74 20 70 | 6c 65 61 73 65 0a 20 64 |e, but p|lease. d|
|00004240| 6f 6e 27 74 20 77 69 6e | 67 65 20 61 74 20 75 73 |on't win|ge at us|
|00004250| 20 2d 20 49 66 20 79 6f | 75 20 64 6f 6e 27 74 20 | - If yo|u don't |
|00004260| 6c 69 6b 65 20 73 6f 6d | 65 74 68 69 6e 67 2c 20 |like som|ething, |
|00004270| 74 68 65 6e 20 64 6f 6e | 27 74 20 62 6f 74 68 65 |then don|'t bothe|
|00004280| 72 20 6d 65 20 2d 20 67 | 6f 0a 20 61 77 61 79 20 |r me - g|o. away |
|00004290| 61 6e 64 20 73 70 65 6e | 64 20 61 20 79 65 61 72 |and spen|d a year|
|000042a0| 20 77 72 69 74 69 6e 67 | 20 74 68 65 20 63 6f 64 | writing| the cod|
|000042b0| 65 20 79 6f 75 72 73 65 | 6c 66 2e 2e 2e 20 49 20 |e yourse|lf... I |
|000042c0| 64 6f 6e 27 74 20 77 65 | 6c 63 6f 6d 65 0a 20 63 |don't we|lcome. c|
|000042d0| 72 69 74 69 63 69 73 6d | 20 66 72 6f 6d 20 70 65 |riticism| from pe|
|000042e0| 6f 70 6c 65 20 77 68 6f | 20 61 72 65 20 75 6e 77 |ople who| are unw|
|000042f0| 69 6c 6c 69 6e 67 20 74 | 6f 20 77 72 69 74 65 20 |illing t|o write |
|00004300| 74 68 65 20 63 6f 64 65 | 20 74 68 65 6d 73 65 6c |the code| themsel|
|00004310| 76 65 73 2e 0a 0a 20 4e | 6f 77 20 70 6c 65 61 73 |ves... N|ow pleas|
|00004320| 65 20 67 6f 20 62 61 63 | 6b 20 61 6e 64 20 72 65 |e go bac|k and re|
|00004330| 61 64 20 74 68 65 20 63 | 6f 6e 64 69 74 69 6f 6e |ad the c|ondition|
|00004340| 73 20 74 68 61 74 20 79 | 6f 75 20 73 6b 69 70 70 |s that y|ou skipp|
|00004350| 65 64 20 61 74 20 74 68 | 65 20 74 6f 70 20 6f 66 |ed at th|e top of|
|00004360| 0a 20 74 68 69 73 20 66 | 69 6c 65 2c 20 62 65 63 |. this f|ile, bec|
|00004370| 61 75 73 65 20 74 68 65 | 79 20 61 72 65 20 69 6d |ause the|y are im|
|00004380| 70 6f 72 74 61 6e 74 20 | 3b 2d 29 0a 0a 20 2d 2d |portant |;-).. --|
|00004390| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000043a0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000043b0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000043c0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000043d0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 0a 0a 20 41 75 74 68 |--------|-.. Auth|
|000043e0| 6f 72 73 3a 0a 20 20 20 | 54 68 69 73 20 6c 69 62 |ors:.   |This lib|
|000043f0| 72 61 72 79 20 68 61 73 | 20 62 65 65 6e 20 62 75 |rary has| been bu|
|00004400| 69 6c 74 20 75 70 20 62 | 79 20 61 20 67 72 6f 75 |ilt up b|y a grou|
|00004410| 70 20 6f 66 20 61 75 74 | 68 6f 72 73 2e 20 49 6e |p of aut|hors. In|
|00004420| 64 69 76 69 64 75 61 6c | 20 66 69 6c 65 73 0a 20 |dividual| files. |
|00004430| 20 20 63 6f 6e 74 61 69 | 6e 20 63 6f 70 79 72 69 |  contai|n copyri|
|00004440| 67 68 74 20 6e 6f 74 69 | 63 65 73 20 66 6f 72 20 |ght noti|ces for |
|00004450| 74 68 65 20 61 75 74 68 | 6f 72 28 73 29 20 77 68 |the auth|or(s) wh|
|00004460| 6f 20 63 72 65 61 74 65 | 64 20 74 68 65 6d 2e 20 |o create|d them. |
|00004470| 54 68 65 0a 20 20 20 61 | 75 74 68 6f 72 73 20 28 |The.   a|uthors (|
|00004480| 61 6e 64 20 6f 74 68 65 | 72 20 63 6f 6e 74 72 69 |and othe|r contri|
|00004490| 62 75 74 6f 72 73 29 20 | 49 27 76 65 20 72 65 6d |butors) |I've rem|
|000044a0| 65 6d 62 65 72 65 64 20 | 74 6f 20 77 72 69 74 65 |embered |to write|
|000044b0| 20 64 6f 77 6e 20 68 65 | 72 65 0a 20 20 20 61 72 | down he|re.   ar|
|000044c0| 65 20 28 61 6c 70 68 61 | 62 65 74 69 63 61 6c 6c |e (alpha|beticall|
|000044d0| 79 29 3a 0a 0a 20 20 20 | 20 50 65 74 65 72 20 41 |y):..   | Peter A|
|000044e0| 72 6e 6f 6c 64 0a 20 20 | 20 20 4d 61 74 74 68 65 |rnold.  |  Matthe|
|000044f0| 77 20 41 73 74 6c 65 79 | 0a 20 20 20 20 4c 65 65 |w Astley|.    Lee|
|00004500| 20 41 74 6b 69 6e 73 6f | 6e 0a 20 20 20 20 50 68 | Atkinso|n.    Ph|
|00004510| 69 6c 69 70 20 42 61 6e | 6b 73 0a 20 20 20 20 53 |ilip Ban|ks.    S|
|00004520| 68 61 75 6e 20 42 6c 61 | 63 6b 6d 6f 72 65 0a 20 |haun Bla|ckmore. |
|00004530| 20 20 20 54 69 6d 20 42 | 72 6f 77 73 65 0a 20 20 |   Tim B|rowse.  |
|00004540| 20 20 54 6f 6e 79 20 42 | 72 79 61 6e 74 0a 20 20 |  Tony B|ryant.  |
|00004550| 20 20 50 68 69 6c 69 70 | 20 43 6f 6c 6d 65 72 0a |  Philip| Colmer.|
|00004560| 20 20 20 20 45 72 69 6b | 20 64 65 20 4b 6f 72 74 |    Erik| de Kort|
|00004570| 0a 20 20 20 20 4b 65 69 | 74 68 20 48 61 6c 6c 0a |.    Kei|th Hall.|
|00004580| 20 20 20 20 54 6f 6e 79 | 20 48 6f 75 67 68 74 6f |    Tony| Houghto|
|00004590| 6e 0a 20 20 20 20 4a 61 | 73 6f 6e 20 48 6f 77 61 |n.    Ja|son Howa|
|000045a0| 74 0a 20 20 20 20 54 6f | 6e 79 20 48 6f 77 61 74 |t.    To|ny Howat|
|000045b0| 0a 20 20 20 20 50 65 74 | 65 72 20 47 61 75 6e 74 |.    Pet|er Gaunt|
|000045c0| 0a 20 20 20 20 54 6f 6d | 20 4b 69 72 62 79 2d 47 |.    Tom| Kirby-G|
|000045d0| 72 65 65 6e 0a 20 20 20 | 20 44 61 76 69 64 20 4c |reen.   | David L|
|000045e0| 65 6e 74 68 61 6c 6c 0a | 20 20 20 20 4b 65 69 74 |enthall.|    Keit|
|000045f0| 68 20 4d 61 72 6c 6f 77 | 0a 20 20 20 20 53 74 75 |h Marlow|.    Stu|
|00004600| 61 72 74 20 4d 61 72 74 | 69 6e 0a 20 20 20 20 53 |art Mart|in.    S|
|00004610| 65 72 67 69 6f 20 4d 6f | 6e 65 73 69 0a 20 20 20 |ergio Mo|nesi.   |
|00004620| 20 45 72 6e 65 73 74 20 | 4f 6e 67 0a 20 20 20 20 | Ernest |Ong.    |
|00004630| 41 69 6e 73 6c 65 79 20 | 50 65 72 65 69 72 61 0a |Ainsley |Pereira.|
|00004640| 20 20 20 20 44 61 76 69 | 64 20 50 69 6c 6c 69 6e |    Davi|d Pillin|
|00004650| 67 0a 20 20 20 20 45 64 | 6f 75 61 72 64 20 50 6f |g.    Ed|ouard Po|
|00004660| 6f 72 0a 20 20 20 20 4a | 75 6c 69 61 6e 20 53 6d |or.    J|ulian Sm|
|00004670| 69 74 68 0a 20 20 20 20 | 42 65 6e 20 53 75 6d 6d |ith.    |Ben Summ|
|00004680| 65 72 73 0a 20 20 20 20 | 57 69 6c 6c 69 61 6d 20 |ers.    |William |
|00004690| 57 61 67 68 6f 72 6e 0a | 20 20 20 20 52 6f 62 69 |Waghorn.|    Robi|
|000046a0| 6e 20 57 61 74 74 73 0a | 20 20 20 20 4a 61 73 6f |n Watts.|    Jaso|
|000046b0| 6e 20 57 69 6c 6c 69 61 | 6d 73 0a 20 20 20 20 4d |n Willia|ms.    M|
|000046c0| 61 72 6b 20 48 2e 20 57 | 69 6c 6b 69 6e 73 6f 6e |ark H. W|ilkinson|
|000046d0| 0a 20 20 20 20 4a 6f 68 | 6e 20 57 69 6e 74 65 72 |.    Joh|n Winter|
|000046e0| 73 0a 0a 20 20 20 54 68 | 61 6e 6b 73 20 61 6c 73 |s..   Th|anks als|
|000046f0| 6f 20 74 6f 20 74 68 65 | 20 6e 75 6d 65 72 6f 75 |o to the| numerou|
|00004700| 73 20 6f 74 68 65 72 73 | 20 77 68 6f 20 68 61 76 |s others| who hav|
|00004710| 65 20 6f 66 66 65 72 65 | 64 20 73 75 67 67 65 73 |e offere|d sugges|
|00004720| 74 69 6f 6e 73 2c 20 65 | 74 63 2e 0a 20 20 20 54 |tions, e|tc..   T|
|00004730| 68 61 6e 6b 73 20 74 6f | 20 41 63 6f 72 6e 20 66 |hanks to| Acorn f|
|00004740| 6f 72 20 64 65 73 69 67 | 6e 69 6e 67 20 74 68 65 |or desig|ning the|
|00004750| 20 6d 61 63 68 69 6e 65 | 20 61 6e 64 20 74 68 65 | machine| and the|
|00004760| 20 63 6f 6d 70 69 6c 65 | 72 2e 0a 20 20 20 41 6e | compile|r..   An|
|00004770| 64 20 66 6f 72 20 52 49 | 53 43 20 4f 53 20 4c 69 |d for RI|SC OS Li|
|00004780| 62 3f 3f 20 20 49 20 67 | 75 65 73 73 20 73 6f 2c |b??  I g|uess so,|
|00004790| 20 6f 72 20 74 68 69 73 | 20 77 6f 75 6c 64 20 6e | or this| would n|
|000047a0| 65 76 65 72 20 68 61 76 | 65 20 61 70 70 65 61 72 |ever hav|e appear|
|000047b0| 65 64 2c 20 61 6e 64 0a | 20 20 20 49 20 77 6f 75 |ed, and.|   I wou|
|000047c0| 6c 64 20 62 65 20 66 6f | 72 63 65 64 20 74 6f 20 |ld be fo|rced to |
|000047d0| 72 65 6c 61 78 20 69 6e | 20 74 68 65 20 77 65 65 |relax in| the wee|
|000047e0| 6b 65 6e 64 73 20 3b 2d | 29 0a 0a 20 2d 2d 2d 2d |kends ;-|).. ----|
|000047f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004800| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004810| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004820| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004830| 2d 2d 2d 2d 2d 2d 2d 0a | 0a 20 43 6f 6e 74 61 63 |-------.|. Contac|
|00004840| 74 69 6e 67 20 74 68 65 | 20 6d 6f 64 65 72 61 74 |ting the| moderat|
|00004850| 6f 72 3a 0a 0a 20 49 66 | 20 79 6f 75 20 66 69 6e |or:.. If| you fin|
|00004860| 64 20 61 6e 79 20 62 75 | 67 73 20 6f 72 20 70 72 |d any bu|gs or pr|
|00004870| 6f 62 6c 65 6d 73 20 69 | 6e 20 44 65 73 6b 4c 69 |oblems i|n DeskLi|
|00004880| 62 2c 20 6f 72 20 69 66 | 20 79 6f 75 20 63 61 6e |b, or if| you can|
|00004890| 20 73 75 70 70 6c 79 0a | 20 73 75 67 67 65 73 74 | supply.| suggest|
|000048a0| 69 6f 6e 73 20 6f 72 20 | 63 6f 64 65 20 66 6f 72 |ions or |code for|
|000048b0| 20 61 6c 74 65 72 61 74 | 69 6f 6e 73 2c 20 61 64 | alterat|ions, ad|
|000048c0| 64 69 74 69 6f 6e 73 2c | 20 6f 72 20 74 75 74 6f |ditions,| or tuto|
|000048d0| 72 69 61 6c 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |rial app|lication|
|000048e0| 73 2c 0a 20 74 68 65 6e | 20 70 6c 65 61 73 65 20 |s,. then| please |
|000048f0| 77 72 69 74 65 20 74 6f | 3a 0a 20 0a 20 20 20 4a |write to|:. .   J|
|00004900| 61 73 6f 6e 20 57 69 6c | 6c 69 61 6d 73 2c 0a 20 |ason Wil|liams,. |
|00004910| 20 20 43 6f 6d 70 75 74 | 65 72 20 43 6f 6e 63 65 |  Comput|er Conce|
|00004920| 70 74 73 20 4c 69 6d 69 | 74 65 64 2c 0a 20 20 20 |pts Limi|ted,.   |
|00004930| 47 61 64 64 65 73 64 65 | 6e 20 50 6c 61 63 65 2c |Gaddesde|n Place,|
|00004940| 0a 20 20 20 48 65 6d 65 | 6c 20 48 65 6d 70 73 74 |.   Heme|l Hempst|
|00004950| 65 61 64 2c 0a 20 20 20 | 48 65 72 74 73 20 48 50 |ead,.   |Herts HP|
|00004960| 32 20 36 45 58 0a 20 20 | 20 45 6e 67 6c 61 6e 64 |2 6EX.  | England|
|00004970| 2e 0a 0a 28 69 6e 63 6c | 75 64 69 6e 67 20 61 20 |...(incl|uding a |
|00004980| 73 6d 61 6c 6c 20 6c 75 | 6d 70 20 6f 66 20 63 61 |small lu|mp of ca|
|00004990| 73 68 20 28 31 20 62 72 | 69 74 69 73 68 20 70 6f |sh (1 br|itish po|
|000049a0| 75 6e 64 20 77 6f 75 6c | 64 20 73 75 66 66 69 63 |und woul|d suffic|
|000049b0| 65 29 20 74 6f 20 63 6f | 76 65 72 0a 72 65 74 75 |e) to co|ver.retu|
|000049c0| 72 6e 20 70 6f 73 74 61 | 67 65 20 77 6f 75 6c 64 |rn posta|ge would|
|000049d0| 20 62 65 20 61 70 70 72 | 65 63 69 61 74 65 64 21 | be appr|eciated!|
|000049e0| 29 0a 0a 20 6f 72 20 65 | 6d 61 69 6c 3a 0a 20 20 |).. or e|mail:.  |
|000049f0| 20 6a 61 73 6f 6e 40 63 | 63 6f 6e 63 65 70 74 73 | jason@c|concepts|
|00004a00| 2e 63 6f 2e 75 6b 0a 0a | 20 54 68 65 73 65 20 61 |.co.uk..| These a|
|00004a10| 64 64 72 65 73 73 65 73 | 20 77 65 72 65 20 76 61 |ddresses| were va|
|00004a20| 6c 69 64 20 61 73 20 6f | 66 20 74 68 65 20 72 65 |lid as o|f the re|
|00004a30| 6c 65 61 73 65 20 64 61 | 74 65 2e 0a 20 49 66 20 |lease da|te.. If |
|00004a40| 79 6f 75 20 66 61 69 6c | 20 74 6f 20 72 65 61 63 |you fail| to reac|
|00004a50| 68 20 6d 65 20 61 74 20 | 61 6e 79 20 6f 66 20 74 |h me at |any of t|
|00004a60| 68 65 6d 2c 20 74 68 65 | 6e 20 49 20 63 61 6e 20 |hem, the|n I can |
|00004a70| 61 6c 73 6f 20 67 65 6e | 65 72 61 6c 6c 79 20 62 |also gen|erally b|
|00004a80| 65 0a 20 63 6f 6e 74 61 | 63 74 65 64 20 62 79 20 |e. conta|cted by |
|00004a90| 70 6f 73 74 69 6e 67 20 | 61 6e 20 61 72 74 69 63 |posting |an artic|
|00004aa0| 6c 65 20 6f 6e 74 6f 20 | 75 73 65 6e 65 74 27 73 |le onto |usenet's|
|00004ab0| 20 63 6f 6d 70 2e 73 79 | 73 2e 61 63 6f 72 6e 20 | comp.sy|s.acorn |
|00004ac0| 6e 65 77 73 67 72 6f 75 | 70 2c 0a 20 77 68 69 63 |newsgrou|p,. whic|
|00004ad0| 68 20 49 20 28 6f 72 20 | 73 6f 6d 65 6f 6e 65 29 |h I (or |someone)|
|00004ae0| 20 77 69 6c 6c 20 62 65 | 20 77 61 74 63 68 69 6e | will be| watchin|
|00004af0| 67 20 72 65 67 61 72 64 | 6c 65 73 73 20 6f 66 20 |g regard|less of |
|00004b00| 77 68 65 72 65 20 49 20 | 68 61 70 70 65 6e 20 74 |where I |happen t|
|00004b10| 6f 20 62 65 0a 20 6c 69 | 76 69 6e 67 2e 0a 0a 20 |o be. li|ving... |
|00004b20| 55 70 64 61 74 65 73 20 | 74 6f 20 74 68 69 73 20 |Updates |to this |
|00004b30| 6c 69 62 72 61 72 79 20 | 61 72 65 20 6c 69 6b 65 |library |are like|
|00004b40| 6c 79 20 74 6f 20 62 65 | 20 64 69 73 74 72 69 62 |ly to be| distrib|
|00004b50| 75 74 65 64 20 6f 76 65 | 72 20 63 6f 6d 70 2e 73 |uted ove|r comp.s|
|00004b60| 6f 75 72 63 65 73 2e 61 | 63 6f 72 6e 2c 0a 20 76 |ources.a|corn,. v|
|00004b70| 61 72 69 6f 75 73 20 41 | 72 63 68 69 76 65 20 73 |arious A|rchive s|
|00004b80| 65 72 76 65 72 73 2c 20 | 73 65 6c 65 63 74 65 64 |ervers, |selected|
|00004b90| 20 22 50 44 22 20 4c 69 | 62 72 61 72 69 65 73 2c | "PD" Li|braries,|
|00004ba0| 20 61 6e 64 20 62 79 20 | 68 69 67 68 20 76 65 6c | and by |high vel|
|00004bb0| 6f 63 69 74 79 20 6c 6c | 61 6d 61 2e 0a 0a 20 49 |ocity ll|ama... I|
|00004bc0| 66 20 79 6f 75 20 77 69 | 73 68 20 74 6f 20 75 73 |f you wi|sh to us|
|00004bd0| 65 20 44 65 73 6b 4c 69 | 62 20 69 6e 20 61 20 63 |e DeskLi|b in a c|
|00004be0| 6f 6d 6d 65 72 63 69 61 | 6c 20 70 72 6f 64 75 63 |ommercia|l produc|
|00004bf0| 74 20 28 6f 72 20 41 4e | 59 20 69 6d 70 6f 72 74 |t (or AN|Y import|
|00004c00| 61 6e 74 20 6f 72 0a 20 | 67 6c 6f 62 61 6c 2d 72 |ant or. |global-r|
|00004c10| 65 6c 65 61 73 65 20 73 | 6f 66 74 77 61 72 65 20 |elease s|oftware |
|00004c20| 66 6f 72 20 74 68 61 74 | 20 6d 61 74 74 65 72 29 |for that| matter)|
|00004c30| 2c 20 74 68 65 6e 20 50 | 4c 45 41 53 45 20 77 72 |, then P|LEASE wr|
|00004c40| 69 74 65 20 74 6f 20 6d | 65 20 61 74 20 74 68 65 |ite to m|e at the|
|00004c50| 0a 20 61 62 6f 76 65 20 | 61 64 64 72 65 73 73 20 |. above |address |
|00004c60| 65 6e 63 6c 6f 73 69 6e | 67 20 61 20 62 6c 61 6e |enclosin|g a blan|
|00004c70| 6b 20 33 2e 35 22 20 64 | 69 73 63 2c 20 61 6e 64 |k 3.5" d|isc, and|
|00004c80| 20 49 20 77 69 6c 6c 20 | 65 6e 64 65 61 76 6f 75 | I will |endeavou|
|00004c90| 72 20 74 6f 20 61 6e 73 | 77 65 72 0a 20 61 6e 79 |r to ans|wer. any|
|00004ca0| 20 71 75 65 72 69 65 73 | 20 79 6f 75 20 68 61 76 | queries| you hav|
|00004cb0| 65 2c 20 61 6e 64 20 66 | 6f 72 77 61 72 64 20 79 |e, and f|orward y|
|00004cc0| 6f 75 20 74 68 65 20 6c | 61 74 65 73 74 20 76 65 |ou the l|atest ve|
|00004cd0| 72 73 69 6f 6e 20 6f 66 | 20 74 68 65 20 6c 69 62 |rsion of| the lib|
|00004ce0| 72 61 72 79 0a 20 73 6f | 75 72 63 65 73 2e 20 49 |rary. so|urces. I|
|00004cf0| 74 20 69 73 20 69 6e 20 | 79 6f 75 72 20 6f 77 6e |t is in |your own|
|00004d00| 20 62 65 73 74 20 69 6e | 74 65 72 65 73 74 73 21 | best in|terests!|
|00004d10| 20 54 68 65 20 6f 6e 6c | 79 20 77 61 79 20 74 6f | The onl|y way to|
|00004d20| 20 67 65 74 20 73 75 70 | 70 6f 72 74 20 69 73 0a | get sup|port is.|
|00004d30| 20 62 79 20 63 6f 6e 74 | 61 63 74 69 6e 67 20 6d | by cont|acting m|
|00004d40| 65 2e 0a 0a 46 69 6c 65 | 44 61 74 61 82 41 75 74 |e...File|Data.Aut|
|00004d50| 68 6f 72 4e 6f 74 65 00 | 12 66 00 00 44 ff ff ff |horNote.|.f..D...|
|00004d60| f8 e3 ff 88 03 00 29 2e | 53 54 4f 50 20 50 52 45 |......).|STOP PRE|
|00004d70| 53 53 0a 0a 49 20 68 61 | 76 65 20 72 65 61 6c 69 |SS..I ha|ve reali|
|00004d80| 73 65 64 20 74 68 61 74 | 20 49 20 64 6f 6e 27 74 |sed that| I don't|
|00004d90| 20 6f 66 74 65 6e 20 68 | 61 76 65 20 74 69 6d 65 | often h|ave time|
|00004da0| 20 74 6f 20 64 6f 20 6d | 75 63 68 20 77 6f 72 6b | to do m|uch work|
|00004db0| 20 6f 6e 20 44 65 73 6b | 4c 69 62 0a 6d 79 73 65 | on Desk|Lib.myse|
|00004dc0| 6c 66 2e 20 54 68 69 73 | 20 68 61 73 20 72 65 73 |lf. This| has res|
|00004dd0| 75 6c 74 65 64 20 69 6e | 20 73 75 73 70 65 6e 73 |ulted in| suspens|
|00004de0| 69 6f 6e 20 6f 66 20 6d | 79 20 61 63 74 69 76 69 |ion of m|y activi|
|00004df0| 74 69 65 73 20 6f 6e 20 | 61 20 6d 65 6e 75 20 74 |ties on |a menu t|
|00004e00| 65 6d 70 6c 61 74 65 0a | 73 79 73 74 65 6d 2e 20 |emplate.|system. |
|00004e10| 54 68 65 20 6d 61 69 6e | 20 70 72 6f 62 6c 65 6d |The main| problem|
|00004e20| 20 69 73 20 74 68 61 74 | 20 6d 61 6e 79 20 6f 66 | is that| many of|
|00004e30| 20 74 68 65 20 72 6f 75 | 74 69 6e 65 73 20 69 6e | the rou|tines in|
|00004e40| 20 44 65 73 6b 4c 69 62 | 20 61 72 65 20 6a 75 73 | DeskLib| are jus|
|00004e50| 74 0a 54 4f 4f 20 67 65 | 6e 65 72 69 63 2c 20 61 |t.TOO ge|neric, a|
|00004e60| 6e 64 20 63 61 6e 20 62 | 65 20 62 65 74 74 65 72 |nd can b|e better|
|00004e70| 20 77 72 69 74 74 65 6e | 20 66 6f 72 20 69 6e 64 | written| for ind|
|00004e80| 69 76 69 64 75 61 6c 20 | 61 70 70 6c 69 63 61 74 |ividual |applicat|
|00004e90| 69 6f 6e 73 20 69 66 20 | 74 68 65 79 0a 69 6e 63 |ions if |they.inc|
|00004ea0| 6c 75 64 65 20 6e 61 73 | 74 79 20 68 61 63 6b 79 |lude nas|ty hacky|
|00004eb0| 20 68 61 6e 64 2d 74 75 | 6e 65 64 20 74 68 69 6e | hand-tu|ned thin|
|00004ec0| 67 73 20 69 6e 20 74 68 | 65 6d 2e 20 48 6f 77 65 |gs in th|em. Howe|
|00004ed0| 76 65 72 2c 20 73 6f 6d | 65 20 70 61 72 74 73 20 |ver, som|e parts |
|00004ee0| 6f 66 0a 44 65 73 6b 4c | 69 62 20 61 72 65 20 75 |of.DeskL|ib are u|
|00004ef0| 73 65 66 75 6c 20 27 6c | 69 74 74 6c 65 27 20 72 |seful 'l|ittle' r|
|00004f00| 6f 75 74 69 6e 65 73 2c | 20 77 68 69 63 68 20 49 |outines,| which I|
|00004f10| 20 66 65 65 6c 20 61 72 | 65 20 6d 6f 72 65 20 75 | feel ar|e more u|
|00004f20| 73 65 66 75 6c 20 69 6e | 20 61 6e 79 0a 63 69 72 |seful in| any.cir|
|00004f30| 63 75 6d 73 74 61 6e 63 | 65 73 3a 0a 0a 20 20 43 |cumstanc|es:..  C|
|00004f40| 6f 6d 70 61 63 74 20 61 | 6e 64 20 65 66 66 69 63 |ompact a|nd effic|
|00004f50| 69 65 6e 74 20 66 75 6e | 63 74 69 6f 6e 20 63 61 |ient fun|ction ca|
|00004f60| 6c 6c 20 69 6e 74 65 72 | 66 61 63 65 73 20 66 6f |ll inter|faces fo|
|00004f70| 72 20 53 57 49 73 20 28 | 69 6e 20 61 73 73 65 6d |r SWIs (|in assem|
|00004f80| 62 6c 65 72 29 0a 20 20 | 53 6d 61 6c 6c 20 72 6f |bler).  |Small ro|
|00004f90| 75 74 69 6e 65 73 20 6c | 69 6b 65 20 49 63 6f 6e |utines l|ike Icon|
|00004fa0| 5f 53 65 6c 65 63 74 28 | 29 20 77 68 69 63 68 20 |_Select(|) which |
|00004fb0| 6d 61 6b 65 20 74 68 65 | 20 70 72 6f 67 72 61 6d |make the| program|
|00004fc0| 20 6d 6f 72 65 20 72 65 | 61 64 61 62 6c 65 0a 20 | more re|adable. |
|00004fd0| 20 20 20 61 6e 64 2f 6f | 72 20 73 61 76 65 20 61 |   and/o|r save a|
|00004fe0| 20 6c 6f 74 20 6f 66 20 | 70 72 6f 67 72 61 6d 6d | lot of |programm|
|00004ff0| 69 6e 67 20 62 6f 74 68 | 65 72 20 6f 6e 20 22 6e |ing both|er on "n|
|00005000| 69 74 74 79 20 67 72 69 | 74 74 79 22 20 73 74 75 |itty gri|tty" stu|
|00005010| 66 66 2e 0a 0a 54 68 65 | 20 6f 74 68 65 72 20 72 |ff...The| other r|
|00005020| 6f 75 74 69 6e 65 73 20 | 61 72 65 20 6d 6f 72 65 |outines |are more|
|00005030| 20 75 73 65 66 75 6c 20 | 61 73 20 74 75 74 6f 72 | useful |as tutor|
|00005040| 69 61 6c 20 74 79 70 65 | 20 63 6f 64 65 20 66 6f |ial type| code fo|
|00005050| 72 20 79 6f 75 20 74 6f | 20 6c 6f 6f 6b 20 61 74 |r you to| look at|
|00005060| 2c 0a 63 68 6f 70 20 62 | 69 74 73 20 6f 75 74 20 |,.chop b|its out |
|00005070| 6f 66 2c 20 65 74 63 2e | 20 77 68 65 6e 20 77 72 |of, etc.| when wr|
|00005080| 69 74 69 6e 67 20 79 6f | 75 72 20 6f 77 6e 20 63 |iting yo|ur own c|
|00005090| 6f 64 65 20 66 6f 72 20 | 74 68 6f 73 65 20 6f 70 |ode for |those op|
|000050a0| 65 72 61 74 69 6f 6e 73 | 2e 0a 54 68 75 73 2c 20 |erations|..Thus, |
|000050b0| 69 74 20 77 6f 75 6c 64 | 20 62 65 20 70 72 65 66 |it would| be pref|
|000050c0| 65 72 61 62 6c 65 20 74 | 6f 20 61 64 64 20 73 6d |erable t|o add sm|
|000050d0| 61 6c 6c 2c 20 75 73 65 | 66 75 6c 2c 20 74 69 6d |all, use|ful, tim|
|000050e0| 65 73 61 76 65 72 73 20 | 72 61 74 68 65 72 20 74 |esavers |rather t|
|000050f0| 68 61 6e 0a 6c 61 72 67 | 65 2c 20 62 6c 6f 61 74 |han.larg|e, bloat|
|00005100| 65 64 20 22 61 6c 6c 2d | 73 69 6e 67 69 6e 67 20 |ed "all-|singing |
|00005110| 61 6c 6c 2d 64 61 6e 63 | 69 6e 67 22 20 72 6f 75 |all-danc|ing" rou|
|00005120| 74 69 6e 65 73 2e 0a 0a | 54 68 75 73 2c 20 69 66 |tines...|Thus, if|
|00005130| 20 79 6f 75 20 73 65 6e | 64 20 61 6e 79 20 63 6f | you sen|d any co|
|00005140| 64 65 2c 20 49 20 77 69 | 6c 6c 20 63 6f 6e 63 65 |de, I wi|ll conce|
|00005150| 6e 74 72 61 74 65 20 6d | 79 20 61 76 61 69 6c 61 |ntrate m|y availa|
|00005160| 62 6c 65 20 74 69 6d 65 | 20 6f 6e 20 74 68 65 0a |ble time| on the.|
|00005170| 73 69 6d 70 6c 65 72 2c | 20 6d 6f 72 65 20 75 73 |simpler,| more us|
|00005180| 65 66 75 6c 20 72 6f 75 | 74 69 6e 65 73 2c 20 61 |eful rou|tines, a|
|00005190| 73 20 49 20 66 65 65 6c | 20 74 68 65 79 20 61 72 |s I feel| they ar|
|000051a0| 65 20 67 65 6e 65 72 61 | 6c 6c 79 20 6d 6f 72 65 |e genera|lly more|
|000051b0| 20 67 6c 6f 62 61 6c 6c | 79 0a 75 73 65 66 75 6c | globall|y.useful|
|000051c0| 20 74 68 61 6e 20 62 69 | 67 67 65 72 2c 20 6d 6f | than bi|gger, mo|
|000051d0| 72 65 20 63 6f 6d 70 6c | 65 78 20 72 6f 75 74 69 |re compl|ex routi|
|000051e0| 6e 65 73 2e 0a 0a 2d 2d | 2d 0a 0a 49 66 20 79 6f |nes...--|-..If yo|
|000051f0| 75 20 77 72 69 74 65 20 | 61 6e 79 20 63 6f 64 65 |u write |any code|
|00005200| 20 77 68 69 63 68 20 79 | 6f 75 20 66 65 65 6c 20 | which y|ou feel |
|00005210| 79 6f 75 20 6d 61 79 20 | 6f 6e 65 20 64 61 79 20 |you may |one day |
|00005220| 64 65 69 67 6e 20 74 6f | 20 73 65 6e 64 20 74 6f |deign to| send to|
|00005230| 20 74 68 65 0a 44 65 73 | 6b 4c 69 62 20 6d 6f 64 | the.Des|kLib mod|
|00005240| 65 72 61 74 6f 72 20 66 | 6f 72 20 70 6f 73 73 69 |erator f|or possi|
|00005250| 62 6c 65 20 69 6e 63 6c | 75 73 69 6f 6e 20 69 6e |ble incl|usion in|
|00005260| 20 74 68 65 20 6c 69 62 | 72 61 72 79 2c 20 74 68 | the lib|rary, th|
|00005270| 65 6e 20 70 6c 65 61 73 | 65 20 72 65 61 64 0a 74 |en pleas|e read.t|
|00005280| 68 72 6f 75 67 68 20 74 | 68 65 20 66 6f 6c 6c 6f |hrough t|he follo|
|00005290| 77 69 6e 67 20 74 65 78 | 74 2e 20 49 74 20 69 73 |wing tex|t. It is|
|000052a0| 20 61 6c 73 6f 20 73 75 | 67 67 65 73 74 65 64 20 | also su|ggested |
|000052b0| 74 68 61 74 20 79 6f 75 | 20 66 61 6d 69 6c 69 61 |that you| familia|
|000052c0| 72 69 73 65 0a 79 6f 75 | 72 73 65 6c 66 20 77 69 |rise.you|rself wi|
|000052d0| 74 68 20 74 68 65 20 77 | 61 79 20 6d 6f 73 74 20 |th the w|ay most |
|000052e0| 6f 66 20 74 68 65 20 6c | 69 62 72 61 72 79 20 73 |of the l|ibrary s|
|000052f0| 74 72 75 63 74 75 72 65 | 73 20 68 61 76 65 20 62 |tructure|s have b|
|00005300| 65 65 6e 20 6c 61 69 64 | 20 6f 75 74 2c 20 61 6e |een laid| out, an|
|00005310| 64 0a 74 68 65 20 6e 61 | 6d 69 6e 67 20 63 6f 6e |d.the na|ming con|
|00005320| 76 65 6e 74 69 6f 6e 73 | 20 75 73 65 64 2c 20 73 |ventions| used, s|
|00005330| 6f 20 74 68 61 74 20 79 | 6f 75 20 63 61 6e 20 6d |o that y|ou can m|
|00005340| 61 6b 65 20 79 6f 75 72 | 20 63 6f 64 65 73 27 20 |ake your| codes' |
|00005350| 65 78 74 65 72 6e 61 6c | 0a 69 6e 74 65 72 66 61 |external|.interfa|
|00005360| 63 65 20 61 73 20 63 6f | 6e 73 69 73 74 65 6e 74 |ce as co|nsistent|
|00005370| 20 77 69 74 68 20 74 68 | 65 20 72 65 73 74 20 6f | with th|e rest o|
|00005380| 66 20 44 65 73 6b 4c 69 | 62 20 61 73 20 70 6f 73 |f DeskLi|b as pos|
|00005390| 73 69 62 6c 65 0a 0a 54 | 68 65 20 66 6f 6c 6c 6f |sible..T|he follo|
|000053a0| 77 69 6e 67 20 69 73 20 | 6e 6f 74 20 6d 61 6e 64 |wing is |not mand|
|000053b0| 61 74 6f 72 79 2c 20 62 | 75 74 20 69 74 20 77 69 |atory, b|ut it wi|
|000053c0| 6c 6c 20 68 65 6c 70 2c | 20 61 6e 64 20 69 74 27 |ll help,| and it'|
|000053d0| 6c 6c 20 73 61 76 65 20 | 6d 65 0a 72 65 2d 77 72 |ll save |me.re-wr|
|000053e0| 69 74 69 6e 67 20 79 6f | 75 72 20 63 6f 64 65 20 |iting yo|ur code |
|000053f0| 62 65 66 6f 72 65 20 69 | 74 20 67 6f 65 73 20 69 |before i|t goes i|
|00005400| 6e 21 0a 0a 0a 50 72 6f | 67 72 61 6d 6d 69 6e 67 |n!...Pro|gramming|
|00005410| 20 63 6f 6e 76 65 6e 74 | 69 6f 6e 73 0a 3d 3d 3d | convent|ions.===|
|00005420| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00005430| 3d 3d 3d 3d 0a 0a 20 54 | 68 65 72 65 20 61 72 65 |====.. T|here are|
|00005440| 20 76 61 72 69 6f 75 73 | 20 63 6f 6e 76 65 6e 74 | various| convent|
|00005450| 69 6f 6e 73 20 77 68 69 | 63 68 20 49 20 68 61 76 |ions whi|ch I hav|
|00005460| 65 20 74 72 69 65 64 20 | 74 6f 20 69 6d 70 6f 73 |e tried |to impos|
|00005470| 65 20 75 70 6f 6e 20 74 | 68 65 20 44 65 73 6b 4c |e upon t|he DeskL|
|00005480| 69 62 0a 20 63 6f 64 65 | 20 74 6f 20 72 65 74 61 |ib. code| to reta|
|00005490| 69 6e 20 61 73 20 6d 75 | 63 68 20 63 6f 6e 73 69 |in as mu|ch consi|
|000054a0| 73 74 65 6e 63 79 20 61 | 73 20 70 6f 73 73 69 62 |stency a|s possib|
|000054b0| 6c 65 2e 20 49 66 20 77 | 72 69 74 69 6e 67 20 67 |le. If w|riting g|
|000054c0| 65 6e 65 72 69 63 20 63 | 6f 64 65 0a 20 74 68 61 |eneric c|ode. tha|
|000054d0| 74 20 79 6f 75 20 6d 69 | 67 68 74 20 61 64 64 20 |t you mi|ght add |
|000054e0| 74 6f 20 44 65 73 6b 4c | 69 62 20 66 6f 72 20 61 |to DeskL|ib for a|
|000054f0| 6c 6c 20 74 6f 20 75 73 | 65 20 69 6e 20 74 68 65 |ll to us|e in the|
|00005500| 20 66 75 74 75 72 65 2c | 20 74 68 65 6e 20 70 6c | future,| then pl|
|00005510| 65 61 73 65 20 74 72 79 | 0a 20 74 6f 20 77 72 69 |ease try|. to wri|
|00005520| 74 65 20 69 74 20 69 6e | 20 74 68 65 20 73 61 6d |te it in| the sam|
|00005530| 65 20 73 74 79 6c 65 20 | 61 73 20 74 68 65 20 63 |e style |as the c|
|00005540| 75 72 72 65 6e 74 20 63 | 6f 64 65 20 28 65 76 65 |urrent c|ode (eve|
|00005550| 6e 20 69 66 20 79 6f 75 | 20 64 6f 6e 27 74 0a 20 |n if you| don't. |
|00005560| 70 65 72 73 6f 6e 61 6c | 6c 79 20 6c 69 6b 65 20 |personal|ly like |
|00005570| 74 68 69 73 20 73 74 79 | 6c 65 2c 20 69 74 20 69 |this sty|le, it i|
|00005580| 73 20 2a 76 65 72 79 2a | 20 62 61 64 20 74 6f 20 |s *very*| bad to |
|00005590| 68 61 76 65 20 69 6e 63 | 6f 6e 73 69 73 74 65 6e |have inc|onsisten|
|000055a0| 63 69 65 73 2c 20 61 6e | 64 20 49 0a 20 77 69 6c |cies, an|d I. wil|
|000055b0| 6c 20 62 65 20 66 6f 72 | 63 65 64 20 74 6f 20 72 |l be for|ced to r|
|000055c0| 65 2d 77 72 69 74 65 20 | 61 6c 6c 20 79 6f 75 72 |e-write |all your|
|000055d0| 20 63 6f 64 65 20 74 6f | 20 63 6f 6d 70 6c 79 2c | code to| comply,|
|000055e0| 20 77 68 69 63 68 20 69 | 73 20 61 20 6c 6f 74 20 | which i|s a lot |
|000055f0| 6f 66 0a 20 77 61 73 74 | 65 64 20 62 6f 74 68 65 |of. wast|ed bothe|
|00005600| 72 2e 2e 2e 29 0a 0a 20 | 54 68 65 20 6d 61 69 6e |r...).. |The main|
|00005610| 20 61 69 6d 73 20 6f 66 | 20 74 68 65 20 66 6f 6c | aims of| the fol|
|00005620| 6c 6f 77 69 6e 67 20 63 | 6f 6e 76 65 6e 74 69 6f |lowing c|onventio|
|00005630| 6e 73 20 61 72 65 3a 0a | 20 20 20 2d 4e 61 6d 69 |ns are:.|   -Nami|
|00005640| 6e 67 20 63 6f 6e 73 69 | 73 74 65 6e 63 79 2e 20 |ng consi|stency. |
|00005650| 49 20 68 61 76 65 20 63 | 68 6f 73 65 6e 20 74 6f |I have c|hosen to|
|00005660| 20 65 63 68 6f 20 74 68 | 65 20 73 74 79 6c 65 20 | echo th|e style |
|00005670| 75 73 65 64 20 69 6e 20 | 41 63 6f 72 6e 27 73 20 |used in |Acorn's |
|00005680| 53 57 49 0a 20 20 20 20 | 6e 61 6d 65 73 20 28 73 |SWI.    |names (s|
|00005690| 65 65 20 62 65 6c 6f 77 | 29 2e 0a 20 20 20 2d 52 |ee below|)..   -R|
|000056a0| 65 61 64 61 62 69 6c 69 | 74 79 2e 20 41 6c 74 68 |eadabili|ty. Alth|
|000056b0| 6f 75 67 68 20 22 65 76 | 65 6e 74 2e 74 79 70 65 |ough "ev|ent.type|
|000056c0| 22 20 6d 65 61 6e 73 20 | 6d 6f 72 65 20 74 79 70 |" means |more typ|
|000056d0| 69 6e 67 20 77 6f 72 6b | 20 74 68 61 6e 20 22 65 |ing work| than "e|
|000056e0| 2d 3e 65 22 2c 0a 20 20 | 20 20 69 74 20 69 73 20 |->e",.  |  it is |
|000056f0| 66 61 72 20 62 65 74 74 | 65 72 20 69 6e 20 61 20 |far bett|er in a |
|00005700| 67 6c 6f 62 61 6c 20 6c | 69 62 72 61 72 79 20 73 |global l|ibrary s|
|00005710| 75 63 68 20 61 73 20 74 | 68 69 73 20 66 6f 72 20 |uch as t|his for |
|00005720| 74 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 0a 20 20 |the foll|owing.  |
|00005730| 20 20 72 65 61 73 6f 6e | 73 3a 0a 20 20 20 20 20 |  reason|s:.     |
|00005740| 20 2d 20 41 6e 79 6f 6e | 65 20 72 65 61 64 69 6e | - Anyon|e readin|
|00005750| 67 20 73 6f 6d 65 20 73 | 6f 75 72 63 65 20 63 6f |g some s|ource co|
|00005760| 64 65 20 77 69 6c 6c 20 | 62 65 20 61 62 6c 65 20 |de will |be able |
|00005770| 74 6f 20 77 6f 72 6b 20 | 6f 75 74 20 66 61 69 72 |to work |out fair|
|00005780| 6c 79 0a 20 20 20 20 20 | 20 20 20 65 61 73 69 6c |ly.     |   easil|
|00005790| 79 20 77 68 61 74 20 69 | 73 20 67 6f 69 6e 67 20 |y what i|s going |
|000057a0| 6f 6e 2c 20 65 76 65 6e | 20 69 66 20 74 68 65 79 |on, even| if they|
|000057b0| 20 68 61 76 65 6e 27 74 | 20 73 65 65 6e 20 74 68 | haven't| seen th|
|000057c0| 65 20 6c 69 62 72 61 72 | 79 0a 20 20 20 20 20 20 |e librar|y.      |
|000057d0| 20 20 6e 61 6d 69 6e 67 | 20 62 65 66 6f 72 65 2e |  naming| before.|
|000057e0| 0a 20 20 20 20 20 20 2d | 20 59 6f 75 20 64 6f 6e |.      -| You don|
|000057f0| 27 74 20 6e 65 65 64 20 | 74 6f 20 6d 65 6d 6f 72 |'t need |to memor|
|00005800| 69 73 65 20 68 75 67 65 | 20 67 6f 62 73 20 6f 66 |ise huge| gobs of|
|00005810| 20 41 53 43 49 49 20 65 | 6e 63 6f 64 69 6e 67 73 | ASCII e|ncodings|
|00005820| 20 6a 75 73 74 20 74 6f | 0a 20 20 20 20 20 20 20 | just to|.       |
|00005830| 20 70 72 6f 67 72 61 6d | 20 77 69 74 68 20 74 68 | program| with th|
|00005840| 65 20 6c 69 62 72 61 72 | 79 20 2d 20 69 66 20 79 |e librar|y - if y|
|00005850| 6f 75 20 77 61 6e 74 20 | 61 6e 20 65 76 65 6e 74 |ou want |an event|
|00005860| 20 74 79 70 65 2c 20 69 | 74 20 69 73 20 6d 6f 73 | type, i|t is mos|
|00005870| 74 0a 20 20 20 20 20 20 | 20 20 6c 69 6b 65 6c 79 |t.      |  likely|
|00005880| 20 63 61 6c 6c 65 64 20 | 61 6e 20 65 76 65 6e 74 | called |an event|
|00005890| 20 74 79 70 65 2c 20 6e | 6f 74 20 61 6e 20 65 2d | type, n|ot an e-|
|000058a0| 3e 65 2e 0a 20 20 20 20 | 20 20 2d 20 4c 65 61 72 |>e..    |  - Lear|
|000058b0| 6e 69 6e 67 20 74 68 65 | 20 69 6e 73 20 61 6e 64 |ning the| ins and|
|000058c0| 20 6f 75 74 73 20 6f 66 | 20 61 20 6e 65 77 20 6c | outs of| a new l|
|000058d0| 69 62 72 61 72 79 20 69 | 73 20 66 61 72 20 71 75 |ibrary i|s far qu|
|000058e0| 69 63 6b 65 72 20 61 6e | 64 20 6c 65 73 73 0a 20 |icker an|d less. |
|000058f0| 20 20 20 20 20 20 20 70 | 61 69 6e 66 75 6c 20 69 |       p|ainful i|
|00005900| 66 20 74 68 69 6e 67 73 | 20 68 61 76 65 20 6d 65 |f things| have me|
|00005910| 61 6e 69 6e 67 66 75 6c | 20 6e 61 6d 65 73 20 2d |aningful| names -|
|00005920| 20 65 73 70 65 63 69 61 | 6c 6c 79 20 69 66 20 74 | especia|lly if t|
|00005930| 68 65 79 20 74 61 6c 6c | 79 0a 20 20 20 20 20 20 |hey tall|y.      |
|00005940| 20 20 77 69 74 68 20 73 | 69 6d 69 6c 61 72 20 6e |  with s|imilar n|
|00005950| 61 6d 65 73 20 75 73 65 | 64 20 69 6e 20 6f 74 68 |ames use|d in oth|
|00005960| 65 72 20 6c 61 6e 67 75 | 61 67 65 73 20 70 65 6f |er langu|ages peo|
|00005970| 70 6c 65 20 61 72 65 20 | 75 73 65 64 20 74 6f 2e |ple are |used to.|
|00005980| 0a 20 20 20 20 20 20 2d | 20 44 65 62 75 67 67 69 |.      -| Debuggi|
|00005990| 6e 67 20 69 73 20 65 61 | 73 69 65 72 2c 20 61 73 |ng is ea|sier, as|
|000059a0| 20 72 65 6d 65 6d 62 65 | 72 69 6e 67 20 77 68 61 | remembe|ring wha|
|000059b0| 74 20 61 6e 20 22 65 76 | 65 6e 74 2d 3e 74 79 70 |t an "ev|ent->typ|
|000059c0| 65 22 20 69 73 20 74 65 | 6e 64 73 0a 20 20 20 20 |e" is te|nds.    |
|000059d0| 20 20 20 20 74 6f 20 62 | 65 20 65 61 73 69 65 72 |    to b|e easier|
|000059e0| 20 74 68 61 6e 20 72 65 | 6d 65 6d 62 65 72 69 6e | than re|memberin|
|000059f0| 67 20 77 68 61 74 20 74 | 68 65 20 22 65 2d 3e 65 |g what t|he "e->e|
|00005a00| 22 20 77 61 73 2e 0a 20 | 20 20 20 20 20 2d 20 52 |" was.. |     - R|
|00005a10| 65 61 64 61 62 69 6c 69 | 74 79 20 69 73 20 69 6d |eadabili|ty is im|
|00005a20| 70 72 6f 76 65 64 2c 20 | 73 6f 20 6f 74 68 65 72 |proved, |so other|
|00005a30| 20 70 65 6f 70 6c 65 20 | 63 61 6e 20 6d 6f 72 65 | people |can more|
|00005a40| 20 65 61 73 69 6c 79 20 | 75 6e 64 65 72 73 74 61 | easily |understa|
|00005a50| 6e 64 0a 20 20 20 20 20 | 20 20 20 79 6f 75 72 20 |nd.     |   your |
|00005a60| 63 6f 64 65 2c 20 61 6e | 64 20 69 66 20 79 6f 75 |code, an|d if you|
|00005a70| 20 6c 65 61 76 65 20 73 | 6f 6d 65 20 63 6f 64 65 | leave s|ome code|
|00005a80| 20 61 6c 6f 6e 65 20 66 | 6f 72 20 61 20 66 65 77 | alone f|or a few|
|00005a90| 20 77 65 65 6b 73 20 61 | 6e 64 20 74 68 65 6e 0a | weeks a|nd then.|
|00005aa0| 20 20 20 20 20 20 20 20 | 63 6f 6d 65 20 62 61 63 |        |come bac|
|00005ab0| 6b 20 74 6f 20 69 74 2c | 20 79 6f 75 20 77 69 6c |k to it,| you wil|
|00005ac0| 6c 20 62 65 20 61 62 6c | 65 20 74 6f 20 77 6f 72 |l be abl|e to wor|
|00005ad0| 6b 20 6f 75 74 20 77 68 | 61 74 20 79 6f 75 20 68 |k out wh|at you h|
|00005ae0| 61 64 20 64 6f 6e 65 20 | 6d 6f 72 65 0a 20 20 20 |ad done |more.   |
|00005af0| 20 20 20 20 20 65 61 73 | 69 6c 79 2e 0a 20 20 20 |     eas|ily..   |
|00005b00| 20 20 20 2d 20 50 6f 72 | 74 61 62 69 6c 69 74 79 |   - Por|tability|
|00005b10| 20 69 73 20 69 6e 63 72 | 65 61 73 65 64 2c 20 61 | is incr|eased, a|
|00005b20| 73 20 69 74 20 69 73 20 | 65 61 73 69 65 72 20 74 |s it is |easier t|
|00005b30| 6f 20 74 72 61 6e 73 6c | 61 74 65 20 63 6f 64 65 |o transl|ate code|
|00005b40| 20 66 75 6c 6c 20 6f 66 | 0a 20 20 20 20 20 20 20 | full of|.       |
|00005b50| 20 6d 65 61 6e 69 6e 67 | 66 75 6c 20 6e 61 6d 65 | meaning|ful name|
|00005b60| 73 20 74 68 61 6e 20 63 | 6f 64 65 20 66 75 6c 6c |s than c|ode full|
|00005b70| 20 6f 66 20 72 61 6e 64 | 6f 6d 20 41 53 43 49 49 | of rand|om ASCII|
|00005b80| 20 73 79 6d 62 6f 6c 73 | 2e 0a 0a 20 41 6e 79 6f | symbols|... Anyo|
|00005b90| 6e 65 20 77 68 6f 20 64 | 6f 65 73 20 6e 6f 74 20 |ne who d|oes not |
|00005ba0| 6c 69 6b 65 20 74 68 65 | 20 6e 61 6d 65 73 20 6f |like the| names o|
|00005bb0| 66 20 74 79 70 65 73 20 | 61 6e 64 20 66 75 6e 63 |f types |and func|
|00005bc0| 74 69 6f 6e 73 20 69 6e | 20 74 68 65 20 6c 69 62 |tions in| the lib|
|00005bd0| 72 61 72 79 0a 20 63 61 | 6e 20 61 6c 77 61 79 73 |rary. ca|n always|
|00005be0| 20 75 73 65 20 23 64 65 | 66 69 6e 65 73 20 6f 72 | use #de|fines or|
|00005bf0| 20 61 6c 74 65 72 20 74 | 68 65 69 72 20 63 6f 70 | alter t|heir cop|
|00005c00| 79 20 6f 66 20 74 68 65 | 20 73 6f 75 72 63 65 73 |y of the| sources|
|00005c10| 20 74 6f 20 6d 61 6b 65 | 20 74 68 65 0a 20 6e 61 | to make| the. na|
|00005c20| 6d 65 73 20 6d 65 61 6e | 69 6e 67 6c 65 73 73 20 |mes mean|ingless |
|00005c30| 61 67 61 69 6e 20 69 66 | 20 74 68 65 79 20 73 6f |again if| they so|
|00005c40| 20 77 69 73 68 2e 20 28 | 54 68 6f 75 67 68 20 69 | wish. (|Though i|
|00005c50| 74 20 69 73 20 72 65 63 | 6f 6d 6d 65 6e 64 65 64 |t is rec|ommended|
|00005c60| 20 74 68 61 74 20 79 6f | 75 0a 20 75 73 65 20 23 | that yo|u. use #|
|00005c70| 64 65 66 69 6e 65 73 2c | 20 73 6f 20 74 68 61 74 |defines,| so that|
|00005c80| 20 74 68 65 20 63 6f 64 | 65 20 72 65 6d 61 69 6e | the cod|e remain|
|00005c90| 73 20 63 6f 6d 70 61 74 | 69 62 6c 65 20 77 69 74 |s compat|ible wit|
|00005ca0| 68 20 66 75 74 75 72 65 | 20 72 65 6c 65 61 73 65 |h future| release|
|00005cb0| 73 20 6f 66 0a 20 74 68 | 65 20 4c 69 62 72 61 72 |s of. th|e Librar|
|00005cc0| 79 2e 29 0a 0a 20 66 75 | 6e 63 74 69 6f 6e 20 6e |y.).. fu|nction n|
|00005cd0| 61 6d 65 73 3a 0a 20 20 | 20 49 20 68 61 76 65 20 |ames:.  | I have |
|00005ce0| 6f 70 74 65 64 20 74 6f | 20 75 73 65 20 74 68 65 |opted to| use the|
|00005cf0| 20 73 61 6d 65 20 73 74 | 79 6c 65 20 61 73 20 41 | same st|yle as A|
|00005d00| 63 6f 72 6e 20 73 74 61 | 6e 64 61 72 64 69 73 65 |corn sta|ndardise|
|00005d10| 64 20 77 69 74 68 20 74 | 68 65 69 72 20 53 57 49 |d with t|heir SWI|
|00005d20| 0a 20 20 20 6e 61 6d 65 | 73 2e 20 54 68 61 74 20 |.   name|s. That |
|00005d30| 69 73 2c 20 20 6d 6f 64 | 75 6c 65 2d 6e 61 6d 65 |is,  mod|ule-name|
|00005d40| 20 75 6e 64 65 72 6c 69 | 6e 65 20 66 75 6e 63 74 | underli|ne funct|
|00005d50| 69 6f 6e 2d 6e 61 6d 65 | 2c 20 77 68 65 72 65 20 |ion-name|, where |
|00005d60| 6d 6f 64 75 6c 65 2d 6e | 61 6d 65 0a 20 20 20 61 |module-n|ame.   a|
|00005d70| 6e 64 20 66 75 6e 63 74 | 69 6f 6e 2d 6e 61 6d 65 |nd funct|ion-name|
|00005d80| 20 61 72 65 20 61 6c 6c | 20 6c 6f 77 65 72 63 61 | are all| lowerca|
|00005d90| 73 65 20 65 78 63 65 70 | 74 20 66 6f 72 20 74 68 |se excep|t for th|
|00005da0| 65 20 69 6e 69 74 69 61 | 6c 20 6c 65 74 74 65 72 |e initia|l letter|
|00005db0| 73 20 6f 66 0a 20 20 20 | 77 6f 72 64 73 3a 0a 20 |s of.   |words:. |
|00005dc0| 20 20 0a 20 69 2e 65 2e | 20 57 69 6d 70 5f 4f 70 |  . i.e.| Wimp_Op|
|00005dd0| 65 6e 57 69 6e 64 6f 77 | 28 29 3b 0a 20 20 20 20 |enWindow|();.    |
|00005de0| 20 20 44 69 61 6c 6f 67 | 5f 53 61 76 65 41 73 28 |  Dialog|_SaveAs(|
|00005df0| 29 3b 0a 20 20 20 20 20 | 20 49 63 6f 6e 5f 50 6c |);.     | Icon_Pl|
|00005e00| 61 63 65 43 61 72 65 74 | 28 29 3b 0a 0a 20 28 4e |aceCaret|();.. (N|
|00005e10| 6f 74 65 20 74 68 61 74 | 20 66 6f 72 20 74 68 65 |ote that| for the|
|00005e20| 20 6c 69 62 72 61 72 69 | 65 73 20 49 20 68 61 76 | librari|es I hav|
|00005e30| 65 20 64 65 66 69 6e 65 | 64 20 53 57 49 20 6e 61 |e define|d SWI na|
|00005e40| 6d 65 73 20 61 73 20 53 | 57 49 5f 57 69 6d 70 5f |mes as S|WI_Wimp_|
|00005e50| 4f 70 65 6e 57 69 6e 64 | 6f 77 0a 20 73 6f 20 74 |OpenWind|ow. so t|
|00005e60| 68 61 74 20 74 68 65 72 | 65 20 69 73 20 6e 6f 20 |hat ther|e is no |
|00005e70| 63 6c 61 73 68 20 62 65 | 74 77 65 65 6e 20 74 68 |clash be|tween th|
|00005e80| 65 20 23 64 65 66 69 6e | 65 64 20 53 57 49 20 6e |e #defin|ed SWI n|
|00005e90| 61 6d 65 20 61 6e 64 20 | 74 68 65 20 66 75 6e 63 |ame and |the func|
|00005ea0| 69 6f 6e 20 6e 61 6d 65 | 29 0a 0a 20 44 65 73 6b |ion name|).. Desk|
|00005eb0| 4c 69 62 20 75 73 65 73 | 20 61 20 70 6f 6c 69 63 |Lib uses| a polic|
|00005ec0| 79 20 6f 66 20 73 70 6c | 69 74 74 69 6e 67 20 63 |y of spl|itting c|
|00005ed0| 6f 64 65 20 75 70 20 69 | 6e 74 6f 20 74 68 65 20 |ode up i|nto the |
|00005ee0| 73 6d 61 6c 6c 65 73 74 | 20 72 65 61 73 6f 6e 61 |smallest| reasona|
|00005ef0| 62 6c 65 0a 20 73 65 67 | 6d 65 6e 74 73 20 73 6f |ble. seg|ments so|
|00005f00| 20 74 68 61 74 20 61 20 | 6d 69 6e 69 6d 75 6d 20 | that a |minimum |
|00005f10| 6f 66 20 63 6f 64 65 20 | 69 73 20 69 6e 63 6c 75 |of code |is inclu|
|00005f20| 64 65 64 20 69 66 20 74 | 68 65 20 75 73 65 72 20 |ded if t|he user |
|00005f30| 6f 6e 6c 79 20 63 61 6c | 6c 73 20 6f 6e 65 0a 20 |only cal|ls one. |
|00005f40| 66 75 6e 63 74 69 6f 6e | 2e 20 54 68 65 20 72 65 |function|. The re|
|00005f50| 73 75 6c 74 20 6f 66 20 | 74 68 69 73 20 69 73 20 |sult of |this is |
|00005f60| 74 68 61 74 20 69 74 20 | 69 73 20 6e 65 63 65 73 |that it |is neces|
|00005f70| 73 61 72 79 20 74 6f 20 | 73 75 70 70 6c 79 20 73 |sary to |supply s|
|00005f80| 6f 6d 65 0a 20 69 6e 74 | 65 72 6e 61 6c 2d 75 73 |ome. int|ernal-us|
|00005f90| 65 20 66 75 6e 63 74 69 | 6f 6e 73 20 28 61 6e 64 |e functi|ons (and|
|00005fa0| 20 76 61 72 69 61 62 6c | 65 73 29 20 74 6f 20 65 | variabl|es) to e|
|00005fb0| 78 74 65 72 6e 61 6c 20 | 63 61 6c 6c 65 72 73 20 |xternal |callers |
|00005fc0| 28 6f 74 68 65 72 20 70 | 61 72 74 73 20 6f 66 0a |(other p|arts of.|
|00005fd0| 20 44 65 73 6b 4c 69 62 | 29 2e 0a 20 54 68 65 73 | DeskLib|).. Thes|
|00005fe0| 65 20 61 72 65 20 74 6f | 20 62 65 20 6e 61 6d 65 |e are to| be name|
|00005ff0| 64 20 61 73 20 61 62 6f | 76 65 2c 20 62 75 74 20 |d as abo|ve, but |
|00006000| 75 73 65 20 61 20 64 6f | 75 62 6c 65 20 75 6e 64 |use a do|uble und|
|00006010| 65 72 6c 69 6e 65 20 74 | 6f 20 6d 61 6b 65 20 69 |erline t|o make i|
|00006020| 74 20 63 6c 65 61 72 0a | 20 74 68 61 74 20 74 68 |t clear.| that th|
|00006030| 65 79 20 61 72 65 20 69 | 6e 74 65 72 6e 61 6c 20 |ey are i|nternal |
|00006040| 72 6f 75 74 69 6e 65 73 | 20 74 68 61 74 20 73 68 |routines| that sh|
|00006050| 6f 75 6c 64 20 67 65 6e | 65 72 61 6c 6c 79 20 6e |ould gen|erally n|
|00006060| 6f 74 20 62 65 20 75 73 | 65 64 20 75 6e 6c 65 73 |ot be us|ed unles|
|00006070| 73 20 62 79 0a 20 61 20 | 6e 65 77 20 72 6f 75 74 |s by. a |new rout|
|00006080| 69 6e 65 20 66 6f 72 20 | 69 6e 63 6c 75 73 69 6f |ine for |inclusio|
|00006090| 6e 20 69 6e 74 6f 20 44 | 65 73 6b 4c 69 62 20 69 |n into D|eskLib i|
|000060a0| 74 73 65 6c 66 2e 2e 2e | 0a 0a 0a 20 76 61 72 69 |tself...|... vari|
|000060b0| 61 62 6c 65 2f 74 79 70 | 65 20 6e 61 6d 65 73 3a |able/typ|e names:|
|000060c0| 0a 20 20 20 54 68 65 20 | 4c 41 53 54 20 74 68 69 |.   The |LAST thi|
|000060d0| 6e 67 20 74 68 61 74 20 | 77 65 20 77 61 6e 74 20 |ng that |we want |
|000060e0| 69 73 20 31 2d 6c 65 74 | 74 65 72 20 76 61 72 69 |is 1-let|ter vari|
|000060f0| 61 62 6c 65 20 6e 61 6d | 65 73 2e 20 55 6e 64 65 |able nam|es. Unde|
|00006100| 6e 69 61 62 6c 79 20 74 | 68 65 79 0a 20 20 20 61 |niably t|hey.   a|
|00006110| 72 65 20 66 61 73 74 65 | 72 20 74 6f 20 74 79 70 |re faste|r to typ|
|00006120| 65 2c 20 62 75 74 20 74 | 68 65 79 20 72 65 6e 64 |e, but t|hey rend|
|00006130| 65 72 20 63 6f 64 65 20 | 66 61 72 20 6d 6f 72 65 |er code |far more|
|00006140| 20 64 69 66 66 69 63 75 | 6c 74 20 74 6f 20 72 65 | difficu|lt to re|
|00006150| 61 64 2c 20 65 76 65 6e | 0a 20 20 20 66 6f 72 20 |ad, even|.   for |
|00006160| 70 65 6f 70 6c 65 20 77 | 68 6f 20 61 72 65 20 66 |people w|ho are f|
|00006170| 6c 75 65 6e 74 20 77 69 | 74 68 20 74 68 65 6d 2c |luent wi|th them,|
|00006180| 20 61 6e 64 20 74 68 65 | 79 20 6d 61 6b 65 20 6c | and the|y make l|
|00006190| 65 61 72 6e 69 6e 67 20 | 74 68 65 20 75 73 65 20 |earning |the use |
|000061a0| 6f 66 20 61 0a 20 20 20 | 6c 69 62 72 61 72 79 20 |of a.   |library |
|000061b0| 61 20 6c 6f 6e 67 20 61 | 6e 64 20 61 72 64 75 6f |a long a|nd arduo|
|000061c0| 75 73 20 74 61 73 6b 2e | 20 41 6c 73 6f 2c 20 77 |us task.| Also, w|
|000061d0| 6f 72 6b 69 6e 67 20 6f | 75 74 20 77 68 61 74 20 |orking o|ut what |
|000061e0| 61 6e 20 22 6d 22 20 69 | 73 20 66 72 6f 6d 0a 20 |an "m" i|s from. |
|000061f0| 20 20 69 74 73 20 63 6f | 6e 74 65 78 74 20 69 73 |  its co|ntext is|
|00006200| 20 61 6e 20 75 6e 64 65 | 73 69 72 61 62 6c 65 20 | an unde|sirable |
|00006210| 74 68 69 6e 67 2e 0a 20 | 20 20 28 69 2e 65 2e 20 |thing.. |  (i.e. |
|00006220| 22 77 22 2c 20 22 69 22 | 2c 20 22 6d 22 2c 20 22 |"w", "i"|, "m", "|
|00006230| 6d 22 2c 20 61 6e 64 20 | 22 65 22 20 61 72 65 20 |m", and |"e" are |
|00006240| 64 65 66 69 6e 69 74 65 | 6c 79 20 6f 75 74 21 29 |definite|ly out!)|
|00006250| 0a 0a 20 20 20 54 68 65 | 20 73 65 63 6f 6e 64 20 |..   The| second |
|00006260| 74 6f 20 6c 61 73 74 20 | 74 68 69 6e 67 20 74 68 |to last |thing th|
|00006270| 61 74 20 77 65 20 77 61 | 6e 74 20 69 73 20 61 20 |at we wa|nt is a |
|00006280| 72 65 61 6c 6c 79 20 6c | 6f 6e 67 20 76 61 72 69 |really l|ong vari|
|00006290| 61 62 6c 65 20 6e 61 6d | 65 2c 20 61 73 0a 20 20 |able nam|e, as.  |
|000062a0| 20 69 74 20 69 73 20 61 | 6e 20 61 6e 6e 6f 79 61 | it is a|n annoya|
|000062b0| 6e 63 65 20 74 6f 20 68 | 61 76 65 20 74 6f 20 74 |nce to h|ave to t|
|000062c0| 79 70 65 20 65 78 63 65 | 65 64 69 6e 67 6c 79 20 |ype exce|edingly |
|000062d0| 6c 6f 6e 67 20 6e 61 6d | 65 73 20 6f 76 65 72 20 |long nam|es over |
|000062e0| 61 6e 64 20 6f 76 65 72 | 2e 0a 20 20 20 54 68 75 |and over|..   Thu|
|000062f0| 73 2c 20 73 6f 6d 65 20 | 74 68 69 6e 67 73 20 61 |s, some |things a|
|00006300| 72 65 20 67 6f 6e 67 20 | 74 6f 20 68 61 76 65 20 |re gong |to have |
|00006310| 74 6f 20 62 65 20 61 62 | 62 72 65 76 69 61 74 65 |to be ab|breviate|
|00006320| 64 2e 0a 20 20 20 28 69 | 2e 65 2e 20 22 73 61 76 |d..   (i|.e. "sav|
|00006330| 65 61 73 5f 72 65 61 64 | 5f 6c 65 61 66 6e 61 6d |eas_read|_leafnam|
|00006340| 65 5f 64 75 72 69 6e 67 | 5f 73 65 6e 64 22 20 69 |e_during|_send" i|
|00006350| 73 20 61 6c 73 6f 20 6e | 6f 74 20 74 6f 6f 20 67 |s also n|ot too g|
|00006360| 6f 6f 64 29 0a 0a 20 20 | 20 41 62 62 72 65 76 69 |ood)..  | Abbrevi|
|00006370| 61 74 69 6f 6e 73 20 73 | 68 6f 75 6c 64 20 62 65 |ations s|hould be|
|00006380| 20 34 20 74 6f 20 36 20 | 63 68 61 72 61 63 74 65 | 4 to 6 |characte|
|00006390| 72 73 20 6c 6f 6e 67 20 | 77 68 65 72 65 20 70 6f |rs long |where po|
|000063a0| 73 73 69 62 6c 65 2e 20 | 65 2e 67 2e 0a 20 20 20 |ssible. |e.g..   |
|000063b0| 20 20 20 69 63 6f 6e 20 | 20 20 20 20 20 20 20 20 |   icon |        |
|000063c0| 20 2d 3e 20 20 69 63 6f | 6e 0a 20 20 20 20 20 20 | ->  ico|n.      |
|000063d0| 77 69 6e 64 6f 77 20 20 | 20 20 20 20 20 20 2d 3e |window  |      ->|
|000063e0| 20 20 77 69 6e 64 6f 77 | 0a 20 20 20 20 20 20 6d |  window|.      m|
|000063f0| 65 6e 75 20 20 20 20 20 | 20 20 20 20 20 2d 3e 20 |enu     |     -> |
+--------+-------------------------+-------------------------+--------+--------+