Home » Archimedes archive » Acorn Computing » 1994 08 subscription disc.adf » 9408s » Shareware/Event/Documents/!EShellDoc/TextHelp/Debug
Shareware/Event/Documents/!EShellDoc/TextHelp/Debug
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 » Acorn Computing » 1994 08 subscription disc.adf » 9408s |
| Filename: | Shareware/Event/Documents/!EShellDoc/TextHelp/Debug |
| Read OK: | ✔ |
| File size: | 0564 bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
Duplicates
There is 1 duplicate copy of this file in the archive:
- Archimedes archive » Acorn Computing » 1994 08 subscription disc.adf » 9408s » Shareware/Event/Documents/!EShellDoc/TextHelp/Debug
- Archimedes archive » Archimedes World » AW-1995-01-Disc2.adf » Disk2Jan95 » !AWJan95/Goodies/Event/Docs/Debug
File contents
PROCshell_TraceExit
Params =>
none
Closes the trace file if it is open. Normally
only called by the EvntShell library when the
application closes down.
--------------------------------------------------------
PROCshell_Tracef0()
Params =>
str trace output
Writes the given string into the trace file if
it is open. If <PROCshell_TraceInit> was called
with a null filename ("") then the trace output
will be broadcast using Acorn's message system
to be picked up and displayed by !ShellDBug if
it is running.
--------------------------------------------------------
PROCshell_TraceInit()
Params =>
str file name for trace output
(can be "" - see below)
Initialises the trace file (must be called
before any other trace functions). If the
file name is "" then no file is opened, trace
output is broadcast as a user message to be
displayed by !ShellDBug.
--------------------------------------------------------
FNshell_TraceIsOn
Params =>
none
<=
TRUE if trace is enabled, FALSE otherwise.
--------------------------------------------------------
PROCshell_TraceOff
Params =>
none
Turns off trace output.
--------------------------------------------------------
PROCshell_TraceOn
Params =>
none
Turns on trace output.
-------------------------------------------------------- 00000000 50 52 4f 43 73 68 65 6c 6c 5f 54 72 61 63 65 45 |PROCshell_TraceE|
00000010 78 69 74 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 |xit.Params =>. |
00000020 20 20 20 20 20 20 20 6e 6f 6e 65 0a 0a 43 6c 6f | none..Clo|
00000030 73 65 73 20 74 68 65 20 74 72 61 63 65 20 66 69 |ses the trace fi|
00000040 6c 65 20 69 66 20 69 74 20 69 73 20 6f 70 65 6e |le if it is open|
00000050 2e 20 4e 6f 72 6d 61 6c 6c 79 0a 6f 6e 6c 79 20 |. Normally.only |
00000060 63 61 6c 6c 65 64 20 62 79 20 74 68 65 20 45 76 |called by the Ev|
00000070 6e 74 53 68 65 6c 6c 20 6c 69 62 72 61 72 79 20 |ntShell library |
00000080 77 68 65 6e 20 74 68 65 0a 61 70 70 6c 69 63 61 |when the.applica|
00000090 74 69 6f 6e 20 63 6c 6f 73 65 73 20 64 6f 77 6e |tion closes down|
000000a0 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |...-------------|
000000b0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------|
*
000000d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f |-----------..PRO|
000000e0 43 73 68 65 6c 6c 5f 54 72 61 63 65 66 30 28 29 |Cshell_Tracef0()|
000000f0 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 20 |.Params =>. |
00000100 20 20 20 20 73 74 72 20 74 72 61 63 65 20 6f 75 | str trace ou|
00000110 74 70 75 74 0a 0a 57 72 69 74 65 73 20 74 68 65 |tput..Writes the|
00000120 20 67 69 76 65 6e 20 73 74 72 69 6e 67 20 69 6e | given string in|
00000130 74 6f 20 74 68 65 20 74 72 61 63 65 20 66 69 6c |to the trace fil|
00000140 65 20 69 66 0a 69 74 20 69 73 20 6f 70 65 6e 2e |e if.it is open.|
00000150 20 49 66 20 3c 50 52 4f 43 73 68 65 6c 6c 5f 54 | If <PROCshell_T|
00000160 72 61 63 65 49 6e 69 74 3e 20 77 61 73 20 63 61 |raceInit> was ca|
00000170 6c 6c 65 64 0a 77 69 74 68 20 61 20 6e 75 6c 6c |lled.with a null|
00000180 20 66 69 6c 65 6e 61 6d 65 20 28 22 22 29 20 74 | filename ("") t|
00000190 68 65 6e 20 74 68 65 20 74 72 61 63 65 20 6f 75 |hen the trace ou|
000001a0 74 70 75 74 0a 77 69 6c 6c 20 62 65 20 62 72 6f |tput.will be bro|
000001b0 61 64 63 61 73 74 20 75 73 69 6e 67 20 41 63 6f |adcast using Aco|
000001c0 72 6e 27 73 20 6d 65 73 73 61 67 65 20 73 79 73 |rn's message sys|
000001d0 74 65 6d 0a 74 6f 20 62 65 20 70 69 63 6b 65 64 |tem.to be picked|
000001e0 20 75 70 20 61 6e 64 20 64 69 73 70 6c 61 79 65 | up and displaye|
000001f0 64 20 62 79 20 21 53 68 65 6c 6c 44 42 75 67 20 |d by !ShellDBug |
00000200 69 66 0a 69 74 20 69 73 20 72 75 6e 6e 69 6e 67 |if.it is running|
00000210 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |...-------------|
00000220 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------|
*
00000240 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f |-----------..PRO|
00000250 43 73 68 65 6c 6c 5f 54 72 61 63 65 49 6e 69 74 |Cshell_TraceInit|
00000260 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 |().Params =>. |
00000270 20 20 20 20 20 20 73 74 72 20 66 69 6c 65 20 6e | str file n|
00000280 61 6d 65 20 66 6f 72 20 74 72 61 63 65 20 6f 75 |ame for trace ou|
00000290 74 70 75 74 0a 20 20 20 20 20 20 20 20 20 20 20 |tput. |
000002a0 20 20 28 63 61 6e 20 62 65 20 22 22 20 2d 20 73 | (can be "" - s|
000002b0 65 65 20 62 65 6c 6f 77 29 0a 0a 49 6e 69 74 69 |ee below)..Initi|
000002c0 61 6c 69 73 65 73 20 74 68 65 20 74 72 61 63 65 |alises the trace|
000002d0 20 66 69 6c 65 20 28 6d 75 73 74 20 62 65 20 63 | file (must be c|
000002e0 61 6c 6c 65 64 0a 62 65 66 6f 72 65 20 61 6e 79 |alled.before any|
000002f0 20 6f 74 68 65 72 20 74 72 61 63 65 20 66 75 6e | other trace fun|
00000300 63 74 69 6f 6e 73 29 2e 20 49 66 20 74 68 65 0a |ctions). If the.|
00000310 66 69 6c 65 20 6e 61 6d 65 20 69 73 20 22 22 20 |file name is "" |
00000320 74 68 65 6e 20 6e 6f 20 66 69 6c 65 20 69 73 20 |then no file is |
00000330 6f 70 65 6e 65 64 2c 20 74 72 61 63 65 0a 6f 75 |opened, trace.ou|
00000340 74 70 75 74 20 69 73 20 62 72 6f 61 64 63 61 73 |tput is broadcas|
00000350 74 20 61 73 20 61 20 75 73 65 72 20 6d 65 73 73 |t as a user mess|
00000360 61 67 65 20 74 6f 20 62 65 0a 64 69 73 70 6c 61 |age to be.displa|
00000370 79 65 64 20 62 79 20 21 53 68 65 6c 6c 44 42 75 |yed by !ShellDBu|
00000380 67 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |g...------------|
00000390 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------|
*
000003b0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e |------------..FN|
000003c0 73 68 65 6c 6c 5f 54 72 61 63 65 49 73 4f 6e 0a |shell_TraceIsOn.|
000003d0 50 61 72 61 6d 73 20 20 3d 3e 0a 20 20 20 20 20 |Params =>. |
000003e0 20 20 20 20 20 6e 6f 6e 65 0a 0a 20 20 20 20 20 | none.. |
000003f0 20 20 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 20 | <=. |
00000400 54 52 55 45 20 69 66 20 74 72 61 63 65 20 69 73 |TRUE if trace is|
00000410 20 65 6e 61 62 6c 65 64 2c 20 46 41 4c 53 45 20 | enabled, FALSE |
00000420 6f 74 68 65 72 77 69 73 65 2e 0a 0a 2d 2d 2d 2d |otherwise...----|
00000430 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------|
*
00000460 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f |----..PROCshell_|
00000470 54 72 61 63 65 4f 66 66 0a 50 61 72 61 6d 73 20 |TraceOff.Params |
00000480 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 20 6e 6f | =>. no|
00000490 6e 65 0a 0a 54 75 72 6e 73 20 6f 66 66 20 74 72 |ne..Turns off tr|
000004a0 61 63 65 20 6f 75 74 70 75 74 2e 0a 0a 2d 2d 2d |ace output...---|
000004b0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------|
*
000004e0 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c |-----..PROCshell|
000004f0 5f 54 72 61 63 65 4f 6e 0a 50 61 72 61 6d 73 20 |_TraceOn.Params |
00000500 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 20 6e 6f | =>. no|
00000510 6e 65 0a 0a 54 75 72 6e 73 20 6f 6e 20 74 72 61 |ne..Turns on tra|
00000520 63 65 20 6f 75 74 70 75 74 2e 0a 0a 2d 2d 2d 2d |ce output...----|
00000530 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------|
*
00000560 2d 2d 2d 2d |----|
00000564 
.