SCI Kernel Documentation/Debugging Functions - Revision history

Andrew Branscom at 00:30, 26 December 2025

2025-12-26T00:30:39Z

← Older revision		Revision as of 19:30, 25 December 2025
Line 26:		Line 26:
	<div align="center"><span style="font-size: 22pt">Debugging Functions</span><br />''Author: [[Jeff Stephenson]]   1988-04-04''<br />''Revision by: [[David Slayback]]   1989-07-25''</div></div>		<div align="center"><span style="font-size: 22pt">Debugging Functions</span><br />''Author: [[Jeff Stephenson]]   1988-04-04''<br />''Revision by: [[David Slayback]]   1989-07-25''</div></div>

	~~ ~~		<br />

	==<br /> Debugging Functions ==		==<br /> Debugging Functions ==

Line 157:		Line 156:
	</blockquote>		</blockquote>

	~~ ~~		==<br /> References ==

			<references /><!-- Do not edit this section. It is autopopulated by <ref></ref> tags -->

	~~;Notes~~		==<br /> Also See ==
	<~~references~~ />

			* [[:Category: Documentation\| Documentation]]
			* [[:Category: Official Documentation\| Official Documentation]]
			* [[:Category: Kernel Functions\| Kernel Functions]]


	[[SCI Kernel Documentation \| Table of Contents]]		[[Official SCI Documentation]]<br />
			[[SCI Kernel Documentation\|Table of Contents]]
	~~ ~~

	<span style="float: left">[[SCI Kernel Documentation/File Functions\|< Previous: File Functions]]</span>		<span style="float: left">[[SCI Kernel Documentation/File Functions\|< Previous: File Functions]]</span>
	<span style="float: right">[[SCI Kernel Documentation/Index\|Next: Index >]]</span>		<span style="float: right">[[SCI Kernel Documentation/Index\|Next: Index >]]</span>


			[[Category:References]]
			[[Category:Historical Pages]]
			[[Category:Development]]
	[[Category:Documentation]]		[[Category:Documentation]]
	[[Category:~~SCI~~ Documentation]]		[[Category:Official Documentation]]
	[[Category:~~SCI~~ Kernel Functions]]		[[Category:Technical Info]]
			[[Category:Kernel Functions]]
	[[Category:Debugging]]		[[Category:Debugging]]
	[[Category:SCI Debugging]]		[[Category:SCI Debugging]]
	[[Category:SCI Debugging Functions]]		[[Category:SCI Debugging Functions]]

Andrew Branscom at 23:32, 24 December 2025

2025-12-24T23:32:54Z

← Older revision		Revision as of 18:32, 24 December 2025
Line 23:		Line 23:
	[[SCI Kernel Documentation/Debugging Functions\|17]] \|		[[SCI Kernel Documentation/Debugging Functions\|17]] \|
	[[SCI Kernel Documentation/Index\|Index]]		[[SCI Kernel Documentation/Index\|Index]]
	</div>~~<br />~~		</div>

	<div align="center"><span style="font-size: 22pt">Debugging Functions</span><br />''Author: [[Jeff Stephenson]]   1988-04-04''<br />''Revision by: [[David Slayback]]   1989-07-25''</div></div>		<div align="center"><span style="font-size: 22pt">Debugging Functions</span><br />''Author: [[Jeff Stephenson]]   1988-04-04''<br />''Revision by: [[David Slayback]]   1989-07-25''</div></div>

Andrew Branscom at 00:53, 20 December 2025

2025-12-20T00:53:35Z

← Older revision		Revision as of 19:53, 19 December 2025
Line 1:		Line 1:
	[[Category:SCI Pages]]		[[Category:SCI Pages]]
	[[Official SCI Documentation]]<br />		[[Official SCI Documentation]]<br />
	[[SCI Kernel Documentation]]		[[SCI Kernel Documentation\|Table of Contents]]

	<div align="center">		<div align="center">

Andrew Branscom at 00:47, 20 December 2025

2025-12-20T00:47:25Z

← Older revision		Revision as of 19:47, 19 December 2025
Line 1:		Line 1:
			[[Category:SCI Pages]]
	[[Official SCI Documentation]]<br />		[[Official SCI Documentation]]<br />
			[[SCI Kernel Documentation]]

	<div align="center">		<div align="center">
	Chapter:		Chapter:

Andrew Branscom at 00:30, 20 December 2025

2025-12-20T00:30:37Z

← Older revision		Revision as of 19:30, 19 December 2025
Line 23:		Line 23:
	</div><br />		</div><br />

	<div align="center"><span style="font-size: 22pt">Debugging Functions</span><br />		<div align="center"><span style="font-size: 22pt">Debugging Functions</span><br />''Author: [[Jeff Stephenson]]   1988-04-04''<br />''Revision by: [[David Slayback]]   1989-07-25''</div></div>
	''Author: [[Jeff Stephenson]]''<br />
	''Revision by: David Slayback''</div>

Andrew Branscom: 2 revisions imported

2025-02-16T21:00:46Z

2 revisions imported

← Older revision	Revision as of 16:00, 16 February 2025
(No difference)

Andrew Branscom: 1 revision imported

2024-06-03T05:14:20Z

1 revision imported

← Older revision	Revision as of 00:14, 3 June 2024
(No difference)

Andrew Branscom: /* (StackUsage PStackCur) */

2018-03-03T04:42:20Z

(StackUsage PStackCur)

New page

[[Official SCI Documentation]] 

<div align="center">
Chapter:
[[SCI Kernel Documentation/SCI Overview|1]] |
[[SCI Kernel Documentation/Resource Functions|2]] |
[[SCI Kernel Documentation/List Functions|3]] |
[[SCI Kernel Documentation/Object Functions|4]] |
[[SCI Kernel Documentation/System Functions|5]] |
[[SCI Kernel Documentation/String Functions|6]] |
[[SCI Kernel Documentation/Picture Functions|7]] |
[[SCI Kernel Documentation/Save-Restore Game Functions|8]] |
[[SCI Kernel Documentation/Animation Functions|9]] |
[[SCI Kernel Documentation/Graphic Screen Functions|10]] |
[[SCI Kernel Documentation/Input Functions|11]] |
[[SCI Kernel Documentation/Menu Functions|12]] |
[[SCI Kernel Documentation/Window and Text Functions|13]] |
[[SCI Kernel Documentation/Sound Functions|14]] |
[[SCI Kernel Documentation/Arithmetic Functions|15]] |
[[SCI Kernel Documentation/File Functions|16]] |
[[SCI Kernel Documentation/Debugging Functions|17]] |
[[SCI Kernel Documentation/Index|Index]]
</div> 

<div align="center">Debugging Functions 
''Author: [[Jeff Stephenson]]'' 
''Revision by: David Slayback''</div>

 

== Debugging Functions ==

<blockquote>
There a number of functions designed for debugging Script programs by providing information about the state of the program.
</blockquote>

=== (SetDebug) ===

<blockquote>
Pop up the debugging window. At the top of the window, in red, is the name (if any) of the object self. Below it is the op-code about to be executed. In columns on the right side of the window are the top five values on the stack and the top five parameters. On the left are the contents of the accumulator (acc), the address of the next instruction (the instruction pointer, or ip), and the address of the top of the stack (the stack pointer, or sp).

A number of instructions may be issued while in the debugger (Note that the debugger is case-sensitive, ie. Q != q):

<blockquote>
{|
|- valign="top"
|width= "100"|<shft><shft>-Z||Put the debugging window away. This also can be used to pop the debugging window up while the program is running.
|- valign="top"
|q||Quit. Exit to DOS. Using <shft><shft>- to pop up the debugger and q to quit will generally get you out of the program even if your code is broken.
|- valign="top"
|s||Toggle the send stack on/off.
|- valign="top"
|Enter||Step to the next instruction, tracing into the procedure or method referenced by a call or send instruction.
|- valign="top"
|Tab||Step to the next instruction treating a call or a send as an indivisible instruction (don't trace into them).
|- valign="top"
|tn||Display the value of temporary variable number n.
|- valign="top"
|ln||Display the value of local variable number n.
|- valign="top"
|gn||Display the value of global variable number n.
|- valign="top"
|i||Open an inspector window, allowing you to inspect the values of the properties of objects. See [[#.28InspectObj_object.29|InspectObj]] below.
|- valign="top"
|o||Look at all objects.
|- valign="top"
|O||Look at all objects with their hex addresses given. The actual address to inspect is <addr>+$0006.
|- valign="top"
|a||Look at object in the accumulator.
|- valign="top"
|c||Look at current object on top of send stack.
|}
</blockquote>
</blockquote>

=== (InspectObj object) ===

<blockquote>
Open an inspector window on object. This displays the property names and values for the object. Typing 'i' when this is displayed prompts for a property name, whose value will be displayed either as a number, string, or another object depending on what it is. If another object, 'i' can be typed again to inspect its properties, and so on until the interpreter runs out of stack.
</blockquote>

=== (ShowSends) ===

<blockquote>
Show the current send stack. This allows you to see how you got where you are. Entries in the display are of the form (object selector:) where object is the object to which a message whose selector was selector: was sent. The top line in the display is the most recent send, the line below that is the send to the method which made that send, and so on to the bottom line, which is the initial send from the main loop in the base script.
</blockquote>

=== (ShowObjs withID) ===

<blockquote>
Display all static and dynamic objects which are currently in the heap. If withID is TRUE, show the object IDs as well.
</blockquote>

=== (ShowFree) ===

<blockquote>
Displays the free memory blocks in the heap in the form number-of-bytes@address.
</blockquote>

=== (MemoryInfo LargestPtr) ===

<blockquote>
Returns the size (in bytes) of the largest block of memory available in the heap.
</blockquote>

=== (MemoryInfo LargestHandle) ===

<blockquote>
Return the size (in bytes) of the largest hunk available in hunk space. If the largest available hunk is greater than 64K, returns 64K.
</blockquote>

=== (MemoryInfo FreeHeap) ===

<blockquote>
Return the amount of memory (in bytes) which is free in the heap.
</blockquote>

=== (MemoryInfo FreeHunk) ===

<blockquote>
Return the amount of memory (in paragraphs, or 16 byte blocks) which is free in hunk space.
</blockquote>

=== (StackUsage MStackSize) ===

<blockquote>
Return the stack size of the PMachine stack.
</blockquote>

=== (StackUsage MStackMax) ===

<blockquote>
Return the maximum stack size reached so far of the PMachine stack.
</blockquote>

=== (StackUsage MStackCur) ===

<blockquote>
Return the current stack size of the PMachine stack.
</blockquote>

=== (StackUsage PStackSize) ===

<blockquote>
Return the stack size of the Processor stack.
</blockquote>

=== (StackUsage PStackMax) ===

<blockquote>
Return the maximum stack size reached so far of the Processor stack.
</blockquote>

=== (StackUsage PStackCur) ===

<blockquote>
Return the current stack size of the Processor stack.
</blockquote>

 

;Notes
<references />

 

[[SCI Kernel Documentation | Table of Contents]]

 

[[SCI Kernel Documentation/File Functions|< Previous: File Functions]]
[[SCI Kernel Documentation/Index|Next: Index >]]

 

[[Category:Documentation]]
[[Category:SCI Documentation]]
[[Category:SCI Kernel Functions]]
[[Category:Debugging]]
[[Category:SCI Debugging]]
[[Category:SCI Debugging Functions]]