wdbgenvr.gml

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

.chap *refid=videnv The &dbgname. Environment
.*
.np
This chapter describes the interactions you need in order
to use the debugger.
.*
.section Debugger Windows
.*
.np
The debugger displays its information in windows. Both the character and
the GUI-based debuggers use similar conventions for window manipulation.
.*
.beglevel
.*
.section Window Controls
.*
.np
Each window has the following controls
.begnote $break
.note Minimize, Maximize, Restore
.ix 'window' 'minimizing'
.ix 'window' 'maximizing'
.ix 'window' 'restoring'
You can control the size of each window using the Minimize, Maximize,
and Restore buttons. The buttons appear on the top right corner of the
window. The Minimize button is the down arrow. When you click on the
down arrow, the window becomes an icon at the bottom of the screen.
The Maximize button is the up arrow. When you click on the up arrow,
the window fills the whole screen. The Restore button appears only
when the window is maximized. It is an up and down arrow. Click on the
Restore button to put the window back to its original size.
.note Close
.*
.ix 'window' 'closing'
Each window has a Close button in the top left corner. Double-click on
this button to close the window.
.note System Menu
The
.mi System Menu
.ix 'window' 'System Menu'
contains menu items that operate on the window. It contains:
.begbull $compact
.bull
.mi Restore
.bull
.mi Move
.bull
.mi Size
.bull
.mi Minimize
.bull
.mi Maximize
.endbull
.np
You can activate the System Menu of the main window by clicking once
on the System Menu button (top, left-hand corner) or by typing
ALT-Space.
For Microsoft Windows, you can type ALT-Hyphen to activate a child
window's System Menu.
.note Scroll Bars
.ix 'scroll bars'
Windows that contain information that cannot fit in the window have
scroll bars. Use the scroll bars to reposition the window so the
information you want to see is visible. The small box in the scroll
bar indicates the current scroll position in the window.
.note Title
Each window is titled so that you know what information it contains.
The title appears in the bar at the top of the window.
.note Buttons
.ix 'buttons'
Many windows have small buttons on the left hand side.
These buttons are short forms for performing the most common
operations.
.endnote
.*
.section The Current Window
.*
.np
.ix 'window' 'current'
The current window is the one whose title bar is coloured.
Press CTRL-TAB to move from window to window.
.*
.section Controlling the Size and Location of Windows
.*
.np
The following window operations are possible.
.begbull
.bull
:HDREF refid='wndmove'.
.bull
:HDREF refid='wndrsiz'.
.bull
:HDREF refid='wndzoom'.
.bull
:HDREF refid='menupop'.
.bull
:HDREF refid='txtsel'.
.endbull
.*
.beglevel
.*
.section *refid=wndmove Moving Windows
.*
.np
.ix 'window' 'moving'
To move a window, click in the Title bar and drag it to a new
location. You can also choose
.mi Move
from the
.mi System Menu
and use the cursor keys to reposition the window, pressing ENTER when
the window is in the right spot.
.*
.section *refid=wndrsiz Resizing Windows
.*
.np
.ix 'window' 'resizing'
In the GUI-based version of the debugger, you can resize a window's
width, height, or both. Refer to the system documentation for details.
.np
In the character-based version of the debugger, you can only resize a
window from the corners. Move the cursor to any corner of the window.
Click and drag the mouse to resize the window.
.np
You can also choose
.mi Size
from the
.mi System Menu
to change the size of a window. Use the cursor keys to resize the
window, press ENTER when the window is the right size.
.*
.section *refid=wndzoom Zooming Windows
.*
.np
.ix 'window' 'zooming'
Choose
.menuref 'Zoom' 'Window'
to toggle a window between its maximized and normal sizes.
.*
.section *refid=menupop Context Sensitive Pop-up Menus
.*
.np
The debugger has context sensitive pop-up menus for each window in the
application.
.bi You can access the menu either by pressing the right
.bi mouse button in the window or by typing the period (.) key.
You can then choose a menu item by typing the highlighted character or
by clicking the mouse on it.
.np
.ix 'accelerator' 'for pop-up menu'
.ix 'shortcuts' 'for pop-up menu'
.ix 'keyboard equivalents' 'for pop-up menu'
.ix 'control-key shortcuts'
.ix 'menu' 'shortcuts'
.ix 'menu' 'accelerator'
.ix 'menu' 'control-key shortcuts'
If you have memorized the highlighted menu character, you can bypass
the menu and activate the menu item directly by pressing the CTRL key
in conjunction with that character. The items that appear in the menu
depend on the current window. These menus are described in detail
throughout this document.
.begnote
.note Note
The
.mi Action
.ix 'menu' 'Action'
.ix 'Action menu'
item in the main menu is identical to the the context sensitive pop-up
menu for the current window and may be used instead of pop-up menus.
.endnote
.np
For more information on the choices presented in the pop-up menus, see
the section entitled :HDREF refid='wndvar'..
.*
.section *refid=txtsel Text Selection
.*
.np
.ix 'text' 'selecting'
.ix 'selecting text'
Some windows, such as the Source and Assembly windows, allow you to
select text. For example, you might want to select a variable name or
expression. Menu items will act on the selected item.
.np
You can select text with either the left or right mouse button. If you
use the right button, the pop-up menu appears when you release the
button. With the keyboard, hold SHIFT while using the cursor keys. You
can select a single character and the debugger will automatically
extend the selection to include the entire surrounding word.
.*
.endlevel
.*
.endlevel
.*
.section Menus
.*
.np
.ix 'menus'
.ix 'accelerator' 'for menu items'
.ix 'shortcuts' 'for menu items'
.ix 'keyboard equivalents' 'for menu items'
.ix 'menu' 'alt-key shortcuts'
.ix 'menu' 'shortcuts'
.ix 'menu' 'accelerators'
.ix 'menu' 'keyboard equivalents'
At the top of the debugger window are a number of menu items. You can
select a menu item with the mouse or by pressing ALT and the
highlighted character from the menu title.
.np
Many menu items have accelerators
or keyboard equivalents. They appear to the right of the menu item. As
you learn the debugger, take time to learn the accelerators. They will
help you to use the debugger more effectively.
.*
.section The Toolbar
.*
.figure *depth='3.40' *scale=65 *file='dbgshot' The Debugger Window
.np
The
.wnddef Toolbar
appears under the menu in the GUI-based debugger. The buttons in the
Toolbar
are equivalent to menu selections. There are eight buttons in the toolbar.
Listed from left to right, they are:
.begbull $compact
.bull
.menuref 'Go' 'Run'
.bull
.menuref 'Step Over' 'Run'
.bull
.menuref 'Trace Into' 'Run'
.bull
.menuref 'Until Return' 'Run'
.bull
.menuref 'Undo' 'Undo'
.bull
.menuref 'Redo' 'Undo'
.bull
.ix 'calls' 'unwinding stack'
.menuref 'Unwind Stack' 'Undo'
.bull
.menuref 'Rewind Stack' 'Undo'
.bull
.menuref 'Home' 'Undo'
.endbull
See the sections entitled :HDREF refid='menurun'. and
:HDREF refid='menuund'. for details.
.*
.section Dialogs
.*
.ix 'dialogs' 'general description'
.figure *depth='3.66' *scale=65 *file='dlgbrk' A Typical Dialog
.np
Dialogs appear when you choose a menu item that does not perform an
immediate action. They allow you to make choices and set options.
The dialogs contain the
following:
.begnote $break
.note Edit fields
These are fields in which you can type information.
.note Buttons
You can click on buttons to perform actions.
.note Default button
The default button in a dialog is highlighted. You can select this
button by pressing ENTER.
.note Cancel
All dialogs contain a cancel button. Choose the
Cancel button or press ESC to leave a dialog without saving or implementing
changes you have made to the dialog.
.note Check Boxes
Check boxes are used to control settings in the debugger.
Click on the field, or TAB to it and press SPACE to toggle the
option between on and off.
.note Radio Buttons
Radio buttons present a set of mutually exclusive choices.
Click on a radio button to turn it on or press TAB to move to the
group of radio buttons and use the cursor keys to select a radio
button.
If this does not work, use the accelerator key to turn on the
desired radio button.
Only one radio button is on at all times.
When you select a different radio button,
the currently selected one is turned off.
.note List boxes
A list box contains a list of applicable items.
.note Drop-down List boxes
A drop down list box is a list that does not appear on the screen
until you click on the down arrow on the right of the box.  You
may then select from a list of options.
.endnote
.*
.section Accelerators
.*
.np
.ix 'accelerators'
.ix 'shortcuts'
.ix 'keyboard equivalents'
.ix 'Turbo keyboard emulation'
.ix 'CodeView keyboard emulation'
Accelerators are keys that you can press in place of selecting a menu
item or typing commands.
The debugger comes with a standard set of accelerators that you can
view by choosing
.menuref 'Accelerators' 'Window'
.dot
.np
If you are used to the CodeView debugger, you should be comfortable
with the &dbgname.'s default set of accelerators.
If you are used to using Turbo Debugger, you can select accelerators
which are similar to its accelerator definitions.
To select Turbo accelerators, choose
.menuref 'Accelerator' 'Window'
then select
.menuref 'TD Keys' 'Action'
.dot
.*
.beglevel
.*
.section *refid=defacl Default Accelerators
.*
.np
The default accelerators are:
.begnote $compact $setptnt 15
.note /
Search/Find...
.note ALT-/
Search/Next
.note CTRL-\
Search/Next
.note ?
add a new expression to the Watch window
.note F1
invoke help facility
.note F2
Data/Registers
.note F3
toggle between source level and assembly level debugging
.note F4
Window/Application
.note F5
Run/Go
.note F6
Window/Next
.note F7
Run/Run to Cursor
.note F8
Run/Trace Into
.note F9
Break/Toggle
.note F10
Run/Step Over
.note SHIFT-F9
add a new item to the Watch window
.note CTRL-F4
close the current window
.note CTRL-F5
restore the current window to its normal size
.note CTRL-F6
rotate the current window
.note CTRL-F9
minimize the current window
.note CTRL-F10
maximize the current window
.note ALT-F10
display the floating pop-up menu for the current window
.note CTRL-TAB
rotate the current window
.note CTRL-LEFT
Undo/Undo
.note CTRL-RIGHT
Undo/Redo
.ix 'calls' 'unwinding stack'
.note CTRL-UP
Undo/Unwind Stack
.note CTRL-DOWN
Undo/Rewind Stack
.note CTRL-BACKSPACE
Undo/Home
.note ALT-1
Data/Locals
.note ALT-2
Data/Watches
.note ALT-3
Code/Source
.note ALT-4
File/View...
.note ALT-5
Data/Memory at...
.note ALT-6
Data/Memory at...
.note ALT-7
Data/Registers
.note ALT-8
Data/80x87 FPU
.note ALT-9
File/Command...
.note CTRL-z
Window/Zoom
.note SPACE
Run/Step Over
.note .
display the floating pop-up menu for the current window
.note :
File/Command...
.note =
Search/Match
.note n
Search/Next
.note N
Search/Previous
.note u
Undo/Undo
.note U
Undo/Redo
.note b
Break/At Cursor
.note e
Data/Memory at...
.note g
Run/Execute to...
.note h
move cursor left one
.note i
Run/Trace Into
.note j
move cursor down one
.note k
move cursor up one
.note l
move cursor right one
.note t
Break/Toggle
.note x
Run/Next Sequential
.endnote
.*
.section Turbo Emulation Accelerators
.*
.np
The Turbo emulation accelerators are:
.begnote $compact $setptnt 15
.note F2
Break/Toggle
.note F3
Code/Modules
.note F4
Run/Run to Cursor
.note F5
Window/Zoom
.note F6
Window/Next
.note F7
Run/Trace Into
.note F8
Run/Step Over
.note F9
Run/Go
.note ALT-F2
Break/New...
.note ALT-F3
close the current window
.note ALT-F4
Undo/Undo
.note ALT-F5
Window/Application
.note ALT-F7
trace one assembly instruction
.note ALT-F8
Run/Until Return
.note ALT-F9
Run/Execute to...
.note ALT-F10
activate the pop-up menu for the current window
.note CTRL-F2
Run/Restart
.note CTRL-F4
open a new Watch window
.note CTRL-F7
add a new item to the Watch window
.endnote
.*
.endlevel
.*
.section *refid=menufil The File Menu
.*
.np
The
.mm File
menu contains items that allow you to perform file operations, such
as:
.*
.begmenu File
.*
.menuitem Open
.*
.ix 'program' 'restarting'
.ix 'program' 'arguments'
.ix 'arguments' 'changing'
.ix 'parameters' 'changing'
.ix 'Restart'
Start debugging a new program, or to restart the current program
with new arguments.
.*
.menuitem View
.*
Display a file in a window.
.*
.menuitem Command
.*
Enter a debugger command. For a description of debugger commands,
refer to the section entitled :HDREF refid='vidcmd'..
.*
.menuitem Options
.*
.ix 'options' 'setting'
.ix 'settings'
Set the global debugging options. For a full description of these
options, refer to the section entitled :HDREF refid='dlgopt'..
.*
.menuitem Window Options
.*
Set the options for the debugger's various windows. For a full
description of these options, refer to the section entitled
:HDREF refid='dlgwopt'..
.*
.menuitem Save Setup
.*
Save the debugger's current configuration. This saves the positions
and sizes of all windows as well as all options and settings. By
default, this information is saved into the file
.fi setup.dbg
.ct ,
however, you can save this information into another file to
create alternate debugger configurations.
.*
.menuitem Load Setup
.*
Load a configuration previously saved using
.mi Save Setup.
.*
.menuitem Source Path
.*
.ix 'source' 'locating files'
Modify the list of directories which will be searched when the debugger
is searching for source files.
.*
.menuitem System
.*
The menu item appears only in the character-based version of the debugger.
It spawns a new operating system shell.