Tornado API Reference : GUI Tcl Library (UNIX)
crosswindTclApi - Tcl exposures for debugger GUI
downtcl - request evaluation of an expression in the debugger's interpreter
sourceContextDisplay - move the source context to a new location
sourceContextForget - forget cached information about a source file
sourceContextForgetAll - forget all cached information about source files
sourceRedisplay - redisplay the source window
markSet - set a mark on a source line
markInfo - return information about a mark
markDelete - delete a mark
markGoto - move the source context to the position of a mark
markList - enumerate all marks
selection - return the text of the current selection in the code window
This library contains implementations of Tcl commands specific to CrossWind.
downtcl - request evaluation of an expression in the debugger's interpreter
CrossWind
downTcl [-noresult] expr...
The supplied expression expr is sent to the debug engine, where it is evaluated as a Tcl expression in the debugger's Tcl interpreter. The result of that expression is received from the debugger and becomes the result of the downtcl expression itself unless -noresult is specified.
The result of evaluating the expression or nothing.
Unless -noresult is specified, the CrossWind process will wait indefinitely for the debugger to return the result of the evaluation. During this time, the CrossWind user interface will not be responsive.
sourceContextDisplay - move the source context to a new location
CrossWind
sourceContextDisplay path line [addr]
This command causes CrossWind to present the file named by path in the source window, positioned at line. In mixed source/assembly mode, addr can further refine the presentation by specifying a particular address. If the address is not known, it may be omitted or specified as -1. If the source file and line number are not known, they may be specified as nil and 0 respectively; then a pure assembly listing will be presented in the display centering around the supplied address.
crosswindTclApi, sourceRedisplay, markSet
sourceContextForget - forget cached information about a source file
CrossWind
sourceContextForget filename
This command causes CrossWind to forget any information it has cached about the given source file. It is used internally to discard source files whenever the debugger loads a new object module.
sourceContextForgetAll - forget all cached information about source files
CrossWind
sourceContextForgetAll
This command discards all cached information about all source files. It is used internally whenever the debugger connects to a new target.
crosswindTclApi, sourceContextForget
sourceRedisplay - redisplay the source window
CrossWind
sourceRedisplay
This command refreshes the source display. It is used internally to manually request a redisplay of the source whenever the source display mode is changed.
crosswindTclApi, sourceContextDisplay
markSet - set a mark on a source line
CrossWind
markSet name type path line addr
This command makes a new "mark" in the source window. Marks are displayed in the left side of the source window. Marks are associated with a particular line of source and are given names. If markSet is applied to a mark name that already exists, the mark is moved. Two marks on the same source line must have different names. If the exact machine address is known, it can be given; if not, it may be omitted or specified as -1. The mark type describes what icon will be used to draw it. Icons for CrossWind marks are found in the directory:
$WIND_BASE/host/resource/bitmaps/CrossWind/marks
crosswindTclApi, sourceContextDisplay, markDelete, markGoto, markList
markInfo - return information about a mark
CrossWind
markInfo name
This command returns information about a named mark: the type, path, line and address information established for the mark by the markSet command are returned. If the named mark does not exist, an empty string is returned.
The mark information or an empty string.
crosswindTclApi, markDelete, markGoto, markSet
markDelete - delete a mark
CrossWind
markDelete name
This command deletes the named mark, which was established with markSet, removing it from the source display.
crosswindTclApi, markSet
markGoto - move the source context to the position of a mark
CrossWind
markGoto name
This command causes the source window to display the source centered around the mark.
crosswindTclApi, markSet
markList - enumerate all marks
CrossWind
markList
This command returns a list of the names of all existing marks.
A list of all marks.
crosswindTclApi, markSet
selection - return the text of the current selection in the code window
CrossWind
selection
This command returns the text that is selected in the source window. The selected source is shown in reverse video. If no source is selected, this command returns an empty string.