wdbgenvr.gml

开放源码的编译器open watcom 1.6.0版的源代码

.*
.menuitem Exit
.*
Close the debugger.
.*
.endmenu
.*
.beglevel
.*
.section *refid=dlgopt The Options Dialog
.*
.ix 'options' 'dialog'
.figure *depth='3.0' *scale=60 *file='dlgopt' The Options Dialog
.np
The Options
dialog allows you to change the following settings:
.begnote
.ix 'configuration' 'automatic saving of'
.ix 'configuration' 'saving'
.ix 'settings' 'automatic saving of'
.ix 'settings' 'saving'
.note Auto configuration save
When this option is on, the debugger automatically saves its configuration
upon exit.
.ix 'Bell'
.ix 'option' 'Bell'
.note Warning Bell
When this option is on, the debugger will beep when a warning or error
is issued.
.ix 'invoke files'
.note Implicit Invoke
If this option is on, the debugger will treat an unknown command as
the name of a command file and automatically try to invoke it. If this
option is off, you must use the invoke command to invoke a command
file.
.np
Under UNIX, a conflict is possible when Invoke is on. A path specified
for a command file name is confused with the short form of the DO
command (/). A similar problem occurs under DOS, OS/2, Windows 3.x,
Windows NT, or Windows 95 when a drive specifier forms part of the
file name.
.ix 'Recursive functions' 'tracing over'
.ix 'Trace Over' 'recursive functions'
.note Recursion Check
Use this option to control the way tracing over recursive function
calls is handled. When this option is on, and you trace over a
function call, the debugger will not stop if the function executes
recursively.
.note Screen flip on execution
Use this option to control whether the debugger automatically flips the
display to the application's screen upon execution.
.bi Leave this option on if you are using the character mode debugger
.bi to debug a Windows 3.x application.
.note Ignore case
.ix 'search' 'ignoring case'
.ix 'case insensitive searching'
This option controls whether or not case is ignored or respected when
the debugger is searching for a string.
.ix 'Radix' 'default'
.ix 'Radix' 'setting'
.note Default Radix
Use this option to define the default radix used by the debugger. The
debugger associates a radix with each action automatically. For
example, if you are asked to enter an address, the debugger assumes
base 16. If you double click on a decimal value, you will be prompted
for a decimal replacement value but there are occasions when the
debugger must use the default radix. If you add an arbitrary
expression to the Watches window, the default radix is used when
interpreting that expression. You can specify any radix between 2 and
36.
.note Double click mS
This option sets the amount of time in milliseconds allowed between two clicks
for the debugger to accept it as a double click.  Enter a larger value
if you are having trouble with double clicks.
.endnote
.*
.section *refid=dlgwopt The Window Options Dialog
.*
.ix 'window' 'options'
.figure *depth='3.57' *scale=60 *file='dlgwopt' The Window Options Dialog
.np
Use the Window Options dialog to define options related to the
debugger's various windows.
All of these options appear in a dialog when you choose
.menuref 'Window Options' 'File'
.dot
.np
The Window Options dialog allows you to set options for the following
windows:
.begbull $compact
.bull
Source
.bull
Modules
.bull
Functions
.bull
Assembly
.bull
Watches
.bull
Locals
.bull
File Variables
.bull
Globals
.bull
Variable
.endbull
.*
.beglevel
.*
.section *refid=asmopt The Assembly Options
.*
.np
.ix 'Assembly options'
.ix 'options' 'Assembly window'
The Assembly options allow you to define how your assembly code
appears.
You can set the following options:
.begnote $break
.note Show Source
Turn on this option if you want source code intermixed with assembly
code.
.note Hexadecimal
Turn on this option if you want immediate operands and values to be
displayed in hexadecimal.
.endnote
.*
.section *refid=varopt The Variables Options
.*
.np
.ix 'Variables options'
.ix 'options' 'Variables window'
.ix 'options' 'Watches window'
Use the Variable options to set display options and to specify which
members of a class you want displayed when a structure or class is
expanded. You can set:
.begnote $break
.note Protected
Display protected members in expanded classes.
.note Private
Display private members in expanded classes.
.note Whole Expression
Turn this option on to show the whole expression used to access fields
and array elements instead of just the element number or field name
itself.
.note Functions
Display C++ member functions in expanded classes.
.note Inherited
Display inherited members in expanded classes.
.note Compiler
Display the compiler-generated members. You will usually not want this
option turned on.
.note Members
Display members of the 'this' pointer as if they were local variables
declared within the member function.
.note Static
Display static members.
.endnote
.*
.section *refid=fileopt The File Options
.*
.np
.ix 'File options'
.ix 'options' 'File window'
You can set the display width of a tab in the File options section.
This value defaults to 8 spaces.
.*
.section *refid=funcopt The Functions and Globals Options
.*
.np
.ix 'Functions options'
.ix 'Globals options'
.ix 'options' 'Functions window'
.ix 'options' 'Globals window'
For both Functions and Global Variables windows,
you can turn on the
.mi Typed Symbols
option.
This restricts the list of symbols to those that are defined in
modules compiled with full debugging information (d2 option).
.*
.section *refid=modopt The Modules Options
.*
.np
.ix 'Modules options'
.ix 'options' 'Modules window'
You can turn on
.mi Show All
to allow the Modules window to display all modules in your program,
not just those which have been compiled with the d2 option.
.*
.endlevel
.*
.endlevel
.*
.section *refid=menucod The Code Menu
.*
.np
The
.mm Code
menu allows you to display windows that show different information
related to your code. It contains the following items:
.*
.begmenu Code
.*
.menuitem Source
.*
Open the Source window. It shows source code at the currently
executing location.
.refalso wndsrc
.*
.menuitem Modules
.*
Display a sorted list of modules contained in the current
program.
.refalso wndmod
.*
.menuitem Functions
.*
Open a sorted list of all functions in the program.
.refalso wndfunc
.*
.menuitem Calls
.*
Open the Call History window. This window displays the program's call
stack.
.refalso wndcall
.*
.menuitem Assembly
.*
Open the Assembly window. It shows assembly code at the currently
executing location.
.refalso wndasm
.*
.menuitem Threads
.*
Open a list of all threads in your program and their current state.
.refalso wndthrd
.*
.menuitem Images
.*
Open a list of the executable images which are related to the
program being debugged.  This includes a list of all loaded DLLs.
.refalso wndimg
.*
.menuitem Replay
.*
Open the program execution Replay window.  This window allows you
to restart your application and replay your debugging session to any
point.
.refalso wndrep
.*
.endmenu
.*
.section *refid=menudat The Data Menu
.*
.np
The
.mm Data
menu contains a number of windows that you can open to view the state
of your program's data. It contains the following items:
.*
.begmenu Data
.*
.menuitem Watches
.*
.ix 'Variables' 'watching'
Open a Watches window. You can add and delete variables from the
Watches window and use it to evaluate complex expressions and perform
typecasting.
.refalso wndvar
.*
.menuitem Locals
.*
.ix 'Local variables'
.ix 'Variables' 'local'
Open a Locals window. It displays the local variables of the currently
executing function.
.refalso wndvar
.*
.menuitem File Variables
.*
.ix 'Variables' 'static'
.ix 'Variables' 'global'
Open a File Variables window.
It contains a list of variables defined at file scope in
the current module.
.refalso wndvar
.*
.menuitem Globals
.*
.ix 'Variables' 'global'
Open a sorted sorted list of all global variables in your program.
Values are not displayed since it would make this window very
expensive to update, but you can select variables from this window and
add them to a Watches window.
.refalso wndglob
.*
.menuitem Registers
.*
.ix 'Registers'
Displays the CPU registers and their values.
.refalso wndreg
.*
.menuitem FPU Registers
.*
Displays the FPU registers and their values.
.refalso wndfpu
.*
.menuitem MMX Registers
.*
Displays the MMX (multi-media extension) registers and their values.
.refalso wndmmx
.*
.menuitem XMM Registers
.*
Displays the XMM (SSE) registers and their values.
.refalso wndxmm
.*
.menuitem Stack
.*
.ix 'SP'
.ix 'ESP'
Displays memory at the stack pointer.
.refalso wndmem
.*
.menuitem I/O Ports
.*
Open a window that lets you manipulate the I/O address space of the
machine.
.refalso wndio
.*
.menuitem Memory at...
.*
.ix 'memory' 'displaying'
.ix 'memory' 'changing'
.ix 'changing memory'
Display memory at a given address.
.refalso wndmem
.*
.menuitem Log
.*
Displays debugger messages and the output from debugger commands.
.refalso wndlog
.*
.endmenu
.*
.section *refid=menuwnd The Window Menu
.*
.np
The
.mm Window
menu allows you to control and arrange the windows on your screen.
.np
The
.mi Window
menu contains the following items:
.*
.begmenu Window
.*
.menuitem Application
.*
Switch to the output screen of the application.
Press any key to return to the debugger.
.*
.menuitem To Log
.*
Save the current window's contents to the log window.
Open the Log window to see the contents.
.*
.menuitem To File
.*
Save the contents of the current window to a file. You must enter a
file name and choose the drive and directory to which you want to save
the information.  This is useful for comparing program state between
debugging sessions.
.*
.menuitem Zoom
.*
Change the size of the current window. Zoom toggles the current window
between its normal and maximum sizes.
.*
.menuitem Next
.*
Rotate through the windows, choosing a new current window.
.*
.menuitem Accelerator
.*
Open the Accelerator window. This window allows you to inspect and
modify the debugger's keyboard shortcut keys.
.*
.endmenu
.*
.section *refid=menuact The Action Menu
.*
.np
Most windows in the debugger have a context sensitive pop-up menu.
The
.mm Action
menu will contain the same menu items as the current window's pop-up
menu. It may be used as an alternative to the pop-up menus. As an
alternative to selecting text with the right mouse button and using
the pop-up menu, you can select text with the left mouse button or
keyboard and use the
.mi Action
menu.
For more information on the choices presented in the pop-up menus,
see the section entitled :HDREF refid='wndvar'..
.*
.section *refid=menuhlp The Help Menu
.*
.np
The
.mm Help
menu contains items that let you use the on-line help facility.
They are:
.*
.begmenu Help
.*
.menuitem Contents
.*
Show the main table of contents of the on-line help information. This
is equivalent to pressing F1.
.*
.menuitem On Help
.*
Display help about how to use the on-line help facility.  This menu item is
not available in character-mode versions of the debugger.
.*
.menuitem Search
.*
Search the on-line help for a topic.  This menu item is
not available in character-mode versions of the debugger.
.*
.menuitem About
.*
Display the "about box".  It contains the copyright and version
information of the debugger.
.*
.endmenu
.*
.section *refid=wndstat The Status Window
.*
.np
The
.wnddef Status
window appears at the bottom of the debugger screen.
As you drag the mouse over a menu item,
descriptive text about that menu item appears in the toolbar.
Messages about the current status of the program and debugger warning
messages also appear in the Status window.
.*
.section *refid=wndlog The Log Window
.*
.figure *depth='2.5' *scale=64 *file='dbglog' The Log Window
.np
Choose
.menuref 'Log' 'Data'
to see the
.wnddef Log
window.
The Log window displays several different types of messages,
including:
.begbull $compact
.bull
status messages such as break point notification
.bull
warning and error messages
.bull
output from debugger commands
.endbull
.np
You can send the contents of any window to the Log window by selecting
.menuref 'To Log' 'Window'
.dot
This allows you to save a window's contents and review it later.
.*
.section *refid=wndacl The Accelerator Window
.*
.ix 'accelerators'
.ix 'shortcuts'
.ix 'keyboard equivalents'
.figure *depth='3.50' *scale=65 *file='dbgacc' The Accelerator Window
.np
The
.wnddef Accelerator
window allows you to control the accelerators or keyboard equivalents
used by the debugger.
Choose
.menuref 'Accelerator' 'Window'
to open this window.
The window displays 4 items relating to each accelerator definition.
They are the key name, the window to which the accelerator applies,
the type of action that the accelerator defines, and the specifics of
that action.
.np
Accelerators may either apply to all windows or to a specific window.
You could define F2 to perform a different action depending upon which
window is current. Accelerators which apply to all windows will have a
window type of
.us all.
.np
An accelerator can define one of three action types.  They are:
.begnote $break
.note pop-up
Activate a pop-up menu item in the current window.
.note menu
Activate an item from the main menu.
.note command
Perform an arbitrary debugger command.
.endnote
.np
You can modify an element of an accelerator definition
by double-clicking on it, or by cursoring to it and pressing ENTER.
Press the right mouse button to access the following menu items:
.*
.begmenu Accelerator Pop-up
.*
.menuitem Modify
.*
Change the currently selected element of an accelerator assignment. If
the key name is selected, the you will be prompted to type a new key.
If the window name is selected, you will be presented with a list of
possible window classes. If the action type or details are selected,
you will be presented with a menu in order to pick the menu item which
will be attached to the accelerator.
.*
.menuitem New
.*
Add a new accelerator assignment.  You will be prompted for all details.
.*
.menuitem Delete
.*
Delete the selected accelerator.
.*
.menuitem TD Keys
.*
Use an approximation of Borland Turbo Debugger's accelerators.
.*
.menuitem WD Keys
.*
Use the default set of accelerators.  If you are familiar with CodeView,
you will be comfortable with these key assignments.
.*
.endmenu