Home » Archimedes archive » Archimedes World » AW-1995-01-Disc2.adf » Disk2Jan95 » !AWJan95/Goodies/Event/!EvntShell/HelpText

!AWJan95/Goodies/Event/!EvntShell/HelpText

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Archimedes World » AW-1995-01-Disc2.adf » Disk2Jan95
Filename: !AWJan95/Goodies/Event/!EvntShell/HelpText
Read OK:
File size: 06D1 bytes
Load address: 0000
Exec address: 0000
File contents
The following is a sample of the help text that I would like to be included somewhere in the documentation of any program that is distributed using the EvntShell library. This is partly because I would like to know what is being written or distributed, partly because I hope that more people will be encouraged to use the library, and partly because Risc User (whose heap manager routines are used heavily by the library) require a mention as well.

-----------------------------------------------------------------------------

This program has been written using the routines supplied with the EvntShell library which is copyright Paul Hobbs. The library routines may be distributed subject to the following conditions:

You have permission to use any part or the whole library in any Public Domain/ShareWare project ONCE YOUR COPY HAS BEEN REGISTERED, as long as I am fully credited (via the inclusion of this file in the program documentation). If you wish to use these routines in a program that is for sale (for however much and for whatever reasons) or released as copyright material then my express permission in writing must be obtained. I maintain copyright on all the material supplied and reserve the right to amend these conditions in cases where I deem misuse.

The library code is supplied free of charge to everyone 'as is'. There is no guarantee that it is free from bugs and no warranty is given about its suitability for use.

Further details about EvntShell may be obtained from the author:

Paul Hobbs
Rheinpfalzstrasse 2
85049 Ingolstadt
Germany

The heap manager routines used by EvntShell are copyright Risc User and are used with permission.

-----------------------------------------------------------------------------
00000000  54 68 65 20 66 6f 6c 6c  6f 77 69 6e 67 20 69 73  |The following is|
00000010  20 61 20 73 61 6d 70 6c  65 20 6f 66 20 74 68 65  | a sample of the|
00000020  20 68 65 6c 70 20 74 65  78 74 20 74 68 61 74 20  | help text that |
00000030  49 20 77 6f 75 6c 64 20  6c 69 6b 65 20 74 6f 20  |I would like to |
00000040  62 65 20 69 6e 63 6c 75  64 65 64 20 73 6f 6d 65  |be included some|
00000050  77 68 65 72 65 20 69 6e  20 74 68 65 20 64 6f 63  |where in the doc|
00000060  75 6d 65 6e 74 61 74 69  6f 6e 20 6f 66 20 61 6e  |umentation of an|
00000070  79 20 70 72 6f 67 72 61  6d 20 74 68 61 74 20 69  |y program that i|
00000080  73 20 64 69 73 74 72 69  62 75 74 65 64 20 75 73  |s distributed us|
00000090  69 6e 67 20 74 68 65 20  45 76 6e 74 53 68 65 6c  |ing the EvntShel|
000000a0  6c 20 6c 69 62 72 61 72  79 2e 20 54 68 69 73 20  |l library. This |
000000b0  69 73 20 70 61 72 74 6c  79 20 62 65 63 61 75 73  |is partly becaus|
000000c0  65 20 49 20 77 6f 75 6c  64 20 6c 69 6b 65 20 74  |e I would like t|
000000d0  6f 20 6b 6e 6f 77 20 77  68 61 74 20 69 73 20 62  |o know what is b|
000000e0  65 69 6e 67 20 77 72 69  74 74 65 6e 20 6f 72 20  |eing written or |
000000f0  64 69 73 74 72 69 62 75  74 65 64 2c 20 70 61 72  |distributed, par|
00000100  74 6c 79 20 62 65 63 61  75 73 65 20 49 20 68 6f  |tly because I ho|
00000110  70 65 20 74 68 61 74 20  6d 6f 72 65 20 70 65 6f  |pe that more peo|
00000120  70 6c 65 20 77 69 6c 6c  20 62 65 20 65 6e 63 6f  |ple will be enco|
00000130  75 72 61 67 65 64 20 74  6f 20 75 73 65 20 74 68  |uraged to use th|
00000140  65 20 6c 69 62 72 61 72  79 2c 20 61 6e 64 20 70  |e library, and p|
00000150  61 72 74 6c 79 20 62 65  63 61 75 73 65 20 52 69  |artly because Ri|
00000160  73 63 20 55 73 65 72 20  28 77 68 6f 73 65 20 68  |sc User (whose h|
00000170  65 61 70 20 6d 61 6e 61  67 65 72 20 72 6f 75 74  |eap manager rout|
00000180  69 6e 65 73 20 61 72 65  20 75 73 65 64 20 68 65  |ines are used he|
00000190  61 76 69 6c 79 20 62 79  20 74 68 65 20 6c 69 62  |avily by the lib|
000001a0  72 61 72 79 29 20 72 65  71 75 69 72 65 20 61 20  |rary) require a |
000001b0  6d 65 6e 74 69 6f 6e 20  61 73 20 77 65 6c 6c 2e  |mention as well.|
000001c0  0a 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |..--------------|
000001d0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000200  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 0a  |---------------.|
00000210  0a 54 68 69 73 20 70 72  6f 67 72 61 6d 20 68 61  |.This program ha|
00000220  73 20 62 65 65 6e 20 77  72 69 74 74 65 6e 20 75  |s been written u|
00000230  73 69 6e 67 20 74 68 65  20 72 6f 75 74 69 6e 65  |sing the routine|
00000240  73 20 73 75 70 70 6c 69  65 64 20 77 69 74 68 20  |s supplied with |
00000250  74 68 65 20 45 76 6e 74  53 68 65 6c 6c 20 6c 69  |the EvntShell li|
00000260  62 72 61 72 79 20 77 68  69 63 68 20 69 73 20 63  |brary which is c|
00000270  6f 70 79 72 69 67 68 74  20 50 61 75 6c 20 48 6f  |opyright Paul Ho|
00000280  62 62 73 2e 20 54 68 65  20 6c 69 62 72 61 72 79  |bbs. The library|
00000290  20 72 6f 75 74 69 6e 65  73 20 6d 61 79 20 62 65  | routines may be|
000002a0  20 64 69 73 74 72 69 62  75 74 65 64 20 73 75 62  | distributed sub|
000002b0  6a 65 63 74 20 74 6f 20  74 68 65 20 66 6f 6c 6c  |ject to the foll|
000002c0  6f 77 69 6e 67 20 63 6f  6e 64 69 74 69 6f 6e 73  |owing conditions|
000002d0  3a 0a 0a 59 6f 75 20 68  61 76 65 20 70 65 72 6d  |:..You have perm|
000002e0  69 73 73 69 6f 6e 20 74  6f 20 75 73 65 20 61 6e  |ission to use an|
000002f0  79 20 70 61 72 74 20 6f  72 20 74 68 65 20 77 68  |y part or the wh|
00000300  6f 6c 65 20 6c 69 62 72  61 72 79 20 69 6e 20 61  |ole library in a|
00000310  6e 79 20 50 75 62 6c 69  63 20 44 6f 6d 61 69 6e  |ny Public Domain|
00000320  2f 53 68 61 72 65 57 61  72 65 20 70 72 6f 6a 65  |/ShareWare proje|
00000330  63 74 20 4f 4e 43 45 20  59 4f 55 52 20 43 4f 50  |ct ONCE YOUR COP|
00000340  59 20 48 41 53 20 42 45  45 4e 20 52 45 47 49 53  |Y HAS BEEN REGIS|
00000350  54 45 52 45 44 2c 20 61  73 20 6c 6f 6e 67 20 61  |TERED, as long a|
00000360  73 20 49 20 61 6d 20 66  75 6c 6c 79 20 63 72 65  |s I am fully cre|
00000370  64 69 74 65 64 20 28 76  69 61 20 74 68 65 20 69  |dited (via the i|
00000380  6e 63 6c 75 73 69 6f 6e  20 6f 66 20 74 68 69 73  |nclusion of this|
00000390  20 66 69 6c 65 20 69 6e  20 74 68 65 20 70 72 6f  | file in the pro|
000003a0  67 72 61 6d 20 64 6f 63  75 6d 65 6e 74 61 74 69  |gram documentati|
000003b0  6f 6e 29 2e 20 49 66 20  79 6f 75 20 77 69 73 68  |on). If you wish|
000003c0  20 74 6f 20 75 73 65 20  74 68 65 73 65 20 72 6f  | to use these ro|
000003d0  75 74 69 6e 65 73 20 69  6e 20 61 20 70 72 6f 67  |utines in a prog|
000003e0  72 61 6d 20 74 68 61 74  20 69 73 20 66 6f 72 20  |ram that is for |
000003f0  73 61 6c 65 20 28 66 6f  72 20 68 6f 77 65 76 65  |sale (for howeve|
00000400  72 20 6d 75 63 68 20 61  6e 64 20 66 6f 72 20 77  |r much and for w|
00000410  68 61 74 65 76 65 72 20  72 65 61 73 6f 6e 73 29  |hatever reasons)|
00000420  20 6f 72 20 72 65 6c 65  61 73 65 64 20 61 73 20  | or released as |
00000430  63 6f 70 79 72 69 67 68  74 20 6d 61 74 65 72 69  |copyright materi|
00000440  61 6c 20 74 68 65 6e 20  6d 79 20 65 78 70 72 65  |al then my expre|
00000450  73 73 20 70 65 72 6d 69  73 73 69 6f 6e 20 69 6e  |ss permission in|
00000460  20 77 72 69 74 69 6e 67  20 6d 75 73 74 20 62 65  | writing must be|
00000470  20 6f 62 74 61 69 6e 65  64 2e 20 49 20 6d 61 69  | obtained. I mai|
00000480  6e 74 61 69 6e 20 63 6f  70 79 72 69 67 68 74 20  |ntain copyright |
00000490  6f 6e 20 61 6c 6c 20 74  68 65 20 6d 61 74 65 72  |on all the mater|
000004a0  69 61 6c 20 73 75 70 70  6c 69 65 64 20 61 6e 64  |ial supplied and|
000004b0  20 72 65 73 65 72 76 65  20 74 68 65 20 72 69 67  | reserve the rig|
000004c0  68 74 20 74 6f 20 61 6d  65 6e 64 20 74 68 65 73  |ht to amend thes|
000004d0  65 20 63 6f 6e 64 69 74  69 6f 6e 73 20 69 6e 20  |e conditions in |
000004e0  63 61 73 65 73 20 77 68  65 72 65 20 49 20 64 65  |cases where I de|
000004f0  65 6d 20 6d 69 73 75 73  65 2e 0a 0a 54 68 65 20  |em misuse...The |
00000500  6c 69 62 72 61 72 79 20  63 6f 64 65 20 69 73 20  |library code is |
00000510  73 75 70 70 6c 69 65 64  20 66 72 65 65 20 6f 66  |supplied free of|
00000520  20 63 68 61 72 67 65 20  74 6f 20 65 76 65 72 79  | charge to every|
00000530  6f 6e 65 20 27 61 73 20  69 73 27 2e 20 54 68 65  |one 'as is'. The|
00000540  72 65 20 69 73 20 6e 6f  20 67 75 61 72 61 6e 74  |re is no guarant|
00000550  65 65 20 74 68 61 74 20  69 74 20 69 73 20 66 72  |ee that it is fr|
00000560  65 65 20 66 72 6f 6d 20  62 75 67 73 20 61 6e 64  |ee from bugs and|
00000570  20 6e 6f 20 77 61 72 72  61 6e 74 79 20 69 73 20  | no warranty is |
00000580  67 69 76 65 6e 20 61 62  6f 75 74 20 69 74 73 20  |given about its |
00000590  73 75 69 74 61 62 69 6c  69 74 79 20 66 6f 72 20  |suitability for |
000005a0  75 73 65 2e 0a 0a 46 75  72 74 68 65 72 20 64 65  |use...Further de|
000005b0  74 61 69 6c 73 20 61 62  6f 75 74 20 45 76 6e 74  |tails about Evnt|
000005c0  53 68 65 6c 6c 20 6d 61  79 20 62 65 20 6f 62 74  |Shell may be obt|
000005d0  61 69 6e 65 64 20 66 72  6f 6d 20 74 68 65 20 61  |ained from the a|
000005e0  75 74 68 6f 72 3a 0a 0a  50 61 75 6c 20 48 6f 62  |uthor:..Paul Hob|
000005f0  62 73 0a 52 68 65 69 6e  70 66 61 6c 7a 73 74 72  |bs.Rheinpfalzstr|
00000600  61 73 73 65 20 32 0a 38  35 30 34 39 20 49 6e 67  |asse 2.85049 Ing|
00000610  6f 6c 73 74 61 64 74 0a  47 65 72 6d 61 6e 79 0a  |olstadt.Germany.|
00000620  0a 54 68 65 20 68 65 61  70 20 6d 61 6e 61 67 65  |.The heap manage|
00000630  72 20 72 6f 75 74 69 6e  65 73 20 75 73 65 64 20  |r routines used |
00000640  62 79 20 45 76 6e 74 53  68 65 6c 6c 20 61 72 65  |by EvntShell are|
00000650  20 63 6f 70 79 72 69 67  68 74 20 52 69 73 63 20  | copyright Risc |
00000660  55 73 65 72 20 61 6e 64  20 61 72 65 20 75 73 65  |User and are use|
00000670  64 20 77 69 74 68 20 70  65 72 6d 69 73 73 69 6f  |d with permissio|
00000680  6e 2e 0a 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |n...------------|
00000690  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000006d0  2d                                                |-|
000006d1