Click above to get retro games delivered to your door ever month!

 The CA-Clipper Debugger--(CLD.EXE)

 Overview

     Allows you to debug your source code while your executable file is
     running.

 Syntax

     CLD [[/43 | /50 | /S] [@<scriptFile>]
        <exeFile> [<argument list>]]

 Command Line Arguments

     This is the command line syntax to invoke the Debugger.  If issued
     without any arguments, a brief help screen is displayed.

     /43 specifies 43 line mode and is available on EGA and VGA monitors.

     /50 specifies 50 line mode and is available on 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 and 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.  If this file has not been compiled using
     the /B compiler option to embed debugging information, debugging is not
     possible.

     <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 from The CA-Clipper
     Debugger chapter of the Programming and Utilities guide.

     ?|?? <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 character 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 character string specified by the
     last Locate Find command.

     Locate Previous

     Locates the previous occurrence of the character string specified by the
     last Locate Find command.

     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 a variable or expression as a Tracepoint.

     Point Watchpoint <exp>

     Specifies a variable or 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.