tracewindow

Postscript file available

A text display widget for tracing Glish function execution

include "guicomponents.g"

Description
The tracewindow is a work in progress. As of this writing (December 1996) the best use of the tracewindow is for the simple display of messages from a running Glish application. (See sdavg.g for the first example of this.) As any application performs its work, some of its operations will be performed behind the scenes, hidden from the user's view; this is especially true of a GUI application. Some users will want to know what is going on behind the scenes, and the well-written program will display those operations as actual Glish function calls, by sending appropriate text to the tracewindow.

The next level of tracing is only hinted at right now (December 1996). The goal - partly accomplished with some global functions located at the bottom of guicomponents.g - is to provide a tool for the user to select any function that appears in the tracewindow, and to view the Glish code that makes up that function. This approach, if properly supported, would allow an interested user to navigate at will through Glish code, starting with the function calls the application prints to the tracewindow, and going just as deep, or as far afield, as she wishes.

This window is primarily useful when used as part of a properly constructed Glish GUI appplication. Such an application will, at the user's request, print the text of crucial function calls and variables to the tracewindow, and will ensure that important lower level functions have text representations for display here in the tracewindow as well. (Please see view_function_test () and view_function_test::text in guicomponents.g.)

See Also
AIPS++Note 194: The SDCalc User Environment

Constructors

tracewindow

Create a window for navigating Glish code.

Functions

append	Display newString on a new line, at the bottom of existing text
clear	Delete all of the text in the window
delete	Destroy the tracewindow
view_named_function	Display the text of the function

Next: tracewindow - Constructor Up: guiutils - Module Previous: evalwindow.delete - Function Contents Index

	Package	display
	Module	guiutils

tracewindow - Tool