[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
CA-Clipper Debugger--CLD.EXE
Allows you to debug your source code while your executable file is running.
------------------------------------------------------------------------------
CLD [[/43 | /50 | /S] [@<scriptFile>]
<exeFile> [<argument list>]]
Arguments
If no command line arguments are specified, CLD displays a brief help
screen.
/43 | /50 | /S specifies the screen mode used by the debugger. These
three options are mutually exclusive and, if more than one is specified,
CLD.EXE uses the last one that occurs on the command line. The default
screen mode is 25 lines, with the debugger using the entire screen.
/43 specifies 43-line mode and is available on EGA monitors only.
/50 specifies 50-line mode and is available on EGA and VGA monitors
only.
/S is available on EGA and VGA monitors only. This option splits
the screen between your application and the debugger, allowing you to
view the application and the debugger simultaneously. On a VGA monitor
/S uses 50-line mode, and on an EGA monitor it uses 43-line mode. In
split screen mode, the top 25 lines of the screen are used by your
application, and the remaining lines are used for the debugger display.
<scriptFile> is the name of a script file with a default extension
of (.cld). CLD searches for the specified <scriptFile> in the current
directory then searches the DOS PATH. A script file is simply an ASCII
text file containing one or more debugger commands, with each command
appearing on a separate line. When the debugger is invoked with a
script file, each command in the file is executed automatically after
the <exeFile> file is loaded.
In addition to any script file called for on the CLD command line, the
debugger automatically searches for a script file with the name
Init.cld. If a file by this name is located in the current directory or
anywhere in the DOS PATH, the debugger executes it as a script file. If
both Init.cld and a command line script file are present, Init.cld is
executed first followed by the command line script file.
<exeFile> is the name of the executable file (.EXE) you want to
debug. CLD searches for the <exeFile> in the current directory only--
the DOS PATH is not searched. The file must include line numbers and
debugging information.
<argument list> is the argument list for <exeFile>. There must be a
space between <argument list> and <exeFile>.
Menu Commands
Listed below is a summary of debugger commands.
?|?? <exp>
Displays the value of an expression.
BP [[At] <lineNum> [[In] <idProgramFile>]]]
BP [<idFunction> | <idProcedure>]
Sets or removes a breakpoint at a specified program and line number or
at a particular function/procedure call.
Callstack [on | Off]
Toggles the display of the Callstack window.
Delete All [BP | TP | WP]
Delete BP | TP | WP <number>
Deletes breakpoints, watchpoints, and tracepoints, either individually
or as a whole.
File DOS
Loads a temporary copy of COMMAND.COM, allowing you to enter DOS
commands without leaving the current application.
File Exit
Terminates the debugger, closes all files, and returns to DOS.
File Open <idFileName>
Opens the specified file for viewing in the Code window.
File Resume
Returns from viewing a file to the program being debugged.
Help [Keys | Windows | Menus | Commands]
Activates the Help window.
List BP | TP | WP
Lists watchpoints, tracepoints, and breakpoints.
Locate Case
Toggles search case-sensitivity setting.
Locate Find <searchString>
Searches the current file for the specified string, obeying the Locate
Case setting.
Locate Goto <lineNum>
Moves the cursor to a specified line in the Code window.
Locate Next
Locates the next occurrence of the string specified by the last Locate
Find command, obeying the Locate Case setting.
Locate Previous
Locates the previous occurrence of the string specified by the last
Locate Find command, obeying the Locate Case setting.
Monitor All
Toggles the display of variables of all storage classes in the Monitor
window.
Monitor Local
Toggles the display of local variables in the Monitor window.
Monitor Private
Toggles the display of private variables in the Monitor window.
Monitor Public
Toggles the display of public variables in the Monitor window.
Monitor Sort
Controls the order in which variables are displayed in the Monitor
window.
Monitor Static
Toggles the display of static variables in the Monitor window.
Num [On | off]
Toggles the display of line numbers at the beginning of each line in the
Code window.
Options Codeblock
Controls the tracing of code blocks during single step mode.
Options Color
Opens the Set Colors window.
Options Exchange
Controls the display of program output while in animate mode.
Options Line
Toggles the display of line numbers at the beginning of each line in the
Code window.
Options Menu
Toggles the debugger menu bar display.
Options Mono
Switches the debugger display mode between color and monochrome.
Options Path <idPathList>
Defines the search path for source files.
Options Preprocessed
Toggles the display of preprocessed code in the Code window.
Options Restore <idScriptFile>
Reads commands from a script file.
Options Save <idScriptFile>
Saves the current debugger settings to a script file.
Options Swap
Controls the display of the application screen when input is required.
Options Tab <tabSize>
Sets the tab size for the Code window.
Point Breakpoint
Sets or removes a breakpoint at the current cursor position.
Point Delete <number>
Deletes a tracepoint or watchpoint setting.
Point Tracepoint <exp>
Specifies an expression as a tracepoint.
Point Watchpoint <exp>
Specifies an expression as a watchpoint.
Run Animate
Executes the application in animate mode.
Run Go
Executes the application in run mode.
Run Next
Executes the application until line zero of the next activation is
encountered. This is equivalent to creating a tracepoint of "PROCLINE()
= 0".
Run Restart
Reloads the current application in preparation for reexecution.
Run Speed <delay>
Sets the step delay for animate mode.
Run Step
Executes the current program in single step mode.
Run To
Executes the current program up to the current cursor position.
Run Trace
Executes the current program in trace mode.
View <idFileName>
Opens the specified file for viewing in the Code window.
View App
Displays program output.
View Callstack
Toggles the display of the Callstack window.
View Sets
Displays the View Sets window.
View Workareas
Displays the View Workareas window.
Window Iconize
Toggles the active debugger window between icon and window display
modes.
Window Move
Moves the active debugger window.
Window Next
Selects the next debugger window.
Window Prev
Selects the previous debugger window.
Window Size
Changes the size of the active debugger window.
Window Tile
Restores the debugger windows to their default size and location.
Window Zoom
Toggles the active debugger window between window and full-screen
display modes.
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson