MAINDEBUG User's Guide, Chapter 1

previous   next   top   complete contents   complete index   framed top   this page unframed


1. Introduction

The MAINSAIL debugger, MAINDEBUG, provides an interactive tool for observing and controlling the execution of MAINSAIL MODULEs. The debugger coordinates the execution of a MODULE with the concurrent display of the MODULE's source text. When a runtime error such as a NULLPOINTER access or an invalid ARRAY subscript occurs, the debugger can be used to display the source text and put the cursor at the statement that caused the error. Relevant text is also interactively displayed when controlling MODULE execution by means of breakpoints and single stepping.

The debugger is a high-level “MAINSAIL debugger”; it works on MAINSAIL language constructs rather than on the underlying hardware's instruction set. Commands controlling MODULE execution operate on MAINSAIL statements and not on native operation codes. Commands that examine and modify data elements operate on MAINSAIL data types and not on processor-dependent “bytes” or “words”.

The debugger uses the MAINSAIL compiler to parse the expressions, statements, definitions, and declarations contained in debugger commands, The MAINSAIL compiler must therefore be present on any system on which MAINDEBUG is to be used.

XIDAK reserves the right to create debugger commands for internal use only. Such commands are not documented here and are subject to change and/or removal without notice. Debugger commands may change from release to release of MAINSAIL.

1.1. Version

This version of the MAINDEBUG User's Guide is current as of the proposed Version 16.30.1 of MAINSAIL (which has not yet been released).


previous   next   top   complete contents   complete index   framed top   this page unframed

MAINDEBUG User's Guide, Chapter 1