home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Jason Aller Floppy Collection
/
75.img
/
CODEVIEW.ZIP
/
CV.HLP
(
.txt
)
< prev
next >
Wrap
Codeview Help
|
1988-02-23
|
22KB
|
679 lines
IIntro to Help
KKeyboard/Mouse
RRun Commands
DDisplay Commands
EExpressions
WWatch/Break
MMemory Operations
SSystem Commands
XRegular Xpressions
TThread Command
CODEVIEW (R) HELP SYSTEM
You can enter the Help system in one of two ways:
1. Click on Help or press
ALT+H
to open the Help menu; then make a menu
selection to go directly to a category (each has 1-4 screens).
2. By entering
or pressing
, you go directly to this screen.
Once in the Help system, move forward or backward to another screen by
clicking one of the selection boxes below, or pressing one of the indicated
hot keys. Colors and syntax used in the screens are described below:
Headings and titles
Headings
Indicates that
Key terms or punctuation
Key terms
optional
Explanatory text
Text
Indicates either
Information you supply
Placeholders
SCREEN 1 OF 1 (Introducing Help)
Description
Keyboard
Mouse
Enter Help system
menu
Open register window
Options
menu
Toggle display mode
View
Switch to Output screen
View
menu
Click left on
Switch cursor window
Execute cursor line
at location
Click right on source line
Trace through routine
Click left on Trace
Set breakpoint at cursor
at location
Click left on source line
Step over routine
Click right on Trace
Make window grow
CONTROL+G
Drag line up or down
Make window tiny
CONTROL+T
Drag line up or down
Scroll up a line
Move cursor off top
Click left on up arrow
Scroll up a page
Click above elevator
Scroll down a line
Move cursor off bottom
Click left on down arrow
Scroll down a page
Click below elevator
SCREEN 1 OF 1 (Keyboard/Mouse)
Trace
count
Executes current source line or
instruction. If
count
is given,
(Click left on
Trace
) repeats
count
times. Traces through
routines and interrupts.
Program Step
count
Executes current source line or
instruction. If
count
is given,
(Click right on
Trace
) repeats
count
times. Steps over
routines and interrupts.
address
Executes until debugger encounters
address
, a previously set breakpoint,
(Click on
or the end of the program.
Execute
Executes in slow motion until you
press a key.
SCREEN 1 OF 1 (Run Commands)
Display Expression
expression
format
Evaluates
expression
and displays the value. If
format
is given, the value is displayed in the
corresponding format, as show below:
Specifier
Input Type
Output Format
Integer
Signed decimal integer
Integer
Unsigned decimal integer
Integer
Unsigned octal integer
Integer
Hexadecimal integer
Floating point
Scientific notation
"E" or "f," whichever is more compact
Character
ASCII equivalent of character
String
C null-terminated string
Integers can have
prefix.
SCREEN 1 OF 4 (Display Commands)
Display Symbols
module
routine
symbol
Displays symbols as described below:
module
routine
symbol
This
symbol
routine
module
module
routine
All symbols in
routine
module
module
symbol
This
symbol
module
(must be static).
module
All static symbols in
module
. Will not find
local or dynamic variables.
routine
symbol
This
symbol
routine
. Searches all modules.
routine
All symbols in
routine
. Searches all modules.
symbol
Looks for
symbol
in this order:
current routine, current module, all modules.
All symbols in current routine.
All module names.
All symbols in all modules.
SCREEN 2 OF 4 (Display Commands)
Set Mode
Sets display mode to source (
assembly (
, or mixed (
Current Location
Puts current line in center of display
window.
Stack Trace
Displays routines and their arguments.
ALT+C
The current routine is on top; the
initial routine is on bottom
Unassemble
range
Displays instructions in
range
. If no
range is given, scrolls down one screen.
expression
Displays source lines, starting at
expression
. If
is given,
loads source file. If no arguments are
given, scrolls down one screen.
SCREEN 3 OF 4 (Display Commands)
Graphic Display Command
variable
Displays value of
variable
in a dialog box in the
center of the screen. If
variable
is a structure,
record, or BASIC user-defined type, then each field
variable
is displayed. Otherwise, exactly one
field is displayed.
Select a field by clicking left on the same line as
the field, or by moving the cursor and pressing
ENTER. If the field is a pointer, the pointer is
dereferenced. If the field is a structure, record,
or user-defined type, the field is expanded. Click
right or press the backspace key to return to
previous display.
Press ESC or click left outside of dialog box to
remove display.
SCREEN 4 OF 4 (Display Commands)
CodeView Expressions
Expressions in CodeView commands consist of symbols, constants, and/or
operators. Operators join symbols and constants into larger expressions.
For example, "+" joins the constants "4" and "5" in the expression "4+5".
Syntax for operators and constants is presented in the next three screens.
Changing Expression Evaluators
language
Changes evaluator to
FORTRAN
, or
BASIC
language
is not given, displays current evaluator.
You can also choose evaluators with the Language menu.
uses source-
file extension to select evaluator (with C as default choice).
Notes on Extended Operators (
and
routine
variable
Local or global variable.
module
linenumber
Source-line address.
SCREEN 1 OF 4 (Expressions)
C Expressions
Precedence
Operators
Syntax
Radix
highest 1
number
Octal
sizeof
number
Decimal
* / % :
number
Hexadecimal
< > <= >=
== !=
Memory Operators
Return byte at
= += -= *= /= %=
Return word at
lowest 10
BY WO DW
Return dbl. word
See Screens #8 and #14 for use of extended
operators (
and
SCREEN 2 OF 4 (Expressions)
FORTRAN Expressions
Precedence
Operators
highest 1
+ -
(unary)
Constant
Radix
+ -
(binary)
number
Default radix
.LT. .LE. .EQ. .NE. .GT. .GE.
radix
number
Specified radix
.NOT.
number
Hexadecimal
.AND.
.EQV. .NEQV.
lowest 11
See Screens #8 and #14 for use of extended
operators (
and
SCREEN 3 OF 4 (Expressions)
BASIC Expressions
Constant
Radix
Precedence
Operators
number
Default radix
highest 1
number
Octal
number
Octal
+ -
(unary)
number
Hexadecimal
\ MOD
+ -
(binary)
Suffix
Type
= <> < > <= >=
Integer
Single
Double
See Screens #8 and #14 for use of
lowest 14
variable
extended operators (
and
SCREEN 4 OF 4 (Expressions)
Watch
expression
format
Displays
expression
format
Expression
range
range
format. See
Screen #4 for format information,
and #14 for type information.
Watchpoint
expression
Breaks execution when
expression
is true (non-zero).
Tracepoint
expression
format
Breaks when
expression
or any
range
value in
range
changes. Displays
same as Watch Expression.
Watch List
Lists watch statements.
Watch Delete
number
Deletes indicated watch
statement, or all if
is given.
SCREEN 1 OF 2 (Watch/Break)
Breakpoint
count
Sets breakpoint at address
. If
count
is given, breakpoint is taken
after
count
times. If
is given,
the command is executed at each break.
Breakpoint
Deletes breakpoints in
, or all
Clear
breakpoints if
is given instead.
Breakpoint
Disables breakpoints in
, or all
Disable
breakpoints if
is given instead.
Breakpoint
Enables breakpoints in
, or all
Enable
breakpoints if
is given instead.
Breakpoint
List breakpoints, including status,
location, pass count, and associated
commands.
SCREEN 2 OF 2 (Watch/Break)
Memory Type Formats--used with Dump, Watch, and Enter commands:
ASCII-format string
Byte (8-bit hexadecimal unsigned integer)
Integer (16-bit decimal)
Unsigned (16-bit decimal unsigned integer)
Word (16-bit unsigned hexadecimal)
Double Word (32-bit unsigned hexadecimal)
Short Real (4 bytes)
Long Real (8 bytes)
Ten-byte Real
Specifying Addresses and Address Ranges
expression1
expression2
Specifies offset or segmented address.
address1 address2
Range from
address1
address2
address1
size
Range beginning at
address1
and of length
SCREEN 1 OF 3 (Memory Operations)
Enter
Enters values of
, beginning at
Debugger will prompt if
is not given.
Items in
are separated by spaces.
range
Dumps values of
range
. Previous or
default type assumed if
is not given.
Assemble
address
Assembles mnemonic instructions beginning
address
. Assumes next instruction if
address
is not given.
Register
expression
Sets one of the following registers:
or 386 extended register.
Sets a condition from one of these pairs:
SCREEN 2 OF 3 (Memory Operations)
Search Memory
range list
Displays each address in
range
that
begins a sequence matching each byte
Compare Memory
range address
Compares bytes in
range
to an equal-
sized block beginning at
address
Fill Memory
range list
Fills
range
with byte values in
repeating values until
range
filled.
Move Memory
range address
Copies values in
range
to an equal-
sized block beginning at
address
Port Input
Displays value at
Port Output
port byte
Assigns
Displays 8087 registers and stack.
SCREEN 3 OF 3 (Memory Operations)
Enters CodeView Help System.
arguments
Reloads program. Uses new command-line
arguments
if given.
Option
Sets (
), clears (
), or displays the
status of
lip/Swap,
ytes Coded,
Sense, or
86 option.
Exits the CodeView debugger.
Radix
radix
Sets radix to 8, 10, or 16, if
radix
given; otherwise displays current radix.
Redraw
Redraws display screen.
SCREEN 1 OF 3 (System Commands)
Screen Exchange
Displays the output screen. Press any key
to return to the debugging screen.
Shell Escape
command
Starts a new DOS shell and executes the
program or DOS command given as
command
command
is not given, user can enter commands
from the DOS prompt, and then enter
when
ready to return to the DOS prompt.
Tab Set
number
Sets the number of spaces per tab, to
number
Text Selection
mouse
Selects text when the right mouse button is
held down and the mouse is dragged right or
left. The selected text appears in the next
dialog box, or at the cursor position when
SHIFT+INS is pressed.
SCREEN 2 OF 3 (System Commands)
Redirection Commands
device
Redirects command output to
device
(file or device). If
given, output is echoed on CodeView screen. If second
given, output is appended.
device
Redirects command input from
device
(file or device).
device
Redirects both command input and command output.
Commands Used with Redirection
comment
Displays
comment
but does not attempt to execute.
Pauses until user presses a key.
Delays for half a second.
SCREEN 3 OF 3 (System Commands)
Search Command
regex
Searches from cursor line for
regex
, or previous regular
expression if regex not given--
regex
consists of text and
(optionally) any of the following special characters:
Character
Function
Removes special meaning (if any) of next character, so
that it is treated as ordinary text. Special characters
\ . * [ ] ^ $
Matches any character.
Matches zero or more repetitions of previous character.
Matches beginning or end of line, respectively.
Continued on next screen.
SCREEN 1 OF 2 (Regular Expressions)
Character
Function
characters
Matches any of the characters within brackets. The
following characters have special meaning within brackets:
When appearing at the beginning of characters,
reverses the function of the brackets so that all
characters will be matched except those in the
brackets. (Example: "[^a]" matches all characters
except "a.")
Matches characters in range specified by characters
on either side of
. (Example: "[a-c]" matches "a,"
"b," or "c.") To nullify special meaning of
place at start or end of characters. (Example:
"[-ac]".)
SCREEN 2 OF 2 (Regular Expressions)
Thread Command
specifier
command
Performs
command
on thread(s) denoted by
specifier
. Legal values of
specifer
command
given below and on following screens.
Specifier
Description
(blank)
Displays the status of all threads.
Specifies last thread executed.
Specifies all threads.
Specifies indicated thread by numeric value.
Specifies current thread.
SCREEN 1 OF 3 (Thread Command)
Command
Description
(blank)
Status of selected thread(s) is displayed.
Breakpoint is set for the specified thread(s).
This command is followed by the normal
breakpoint syntax (see Screen #13).
Specified thread is executed in slow motion,
while other threads are frozen.
is legal
only in source mode; it executes current
thread, while other threads run concurrently.
Specified thread(s) is frozen.
Control is passed to specified thread, while
other threads are frozen.
runs all threads
concurrently.
SCREEN 2 OF 3 (Thread Command)
Command
Description
A program step is executed for the specified
thread, while other threads are frozen.
legal only in source mode; it executes a program
step for current thread, while other threads run
concurrently.
Specified thread is selected as current thread.
Similar to
, except that
traces through
function on calls and
does not.
Specified thread is unfrozen.
SCREEN 3 OF 3 (Thread Command)
=========Execute Code========== ================Examine Data=================
T [<count>] ............. Trace ? <expr>[,format] ........ Display Expression
P [<count>] ...... Program Step X?[mod!][fun.][sym][*] ...... Examine Symbols
G [<addr>] ................. Go D[<type>] [<range>] .................... Dump
E ..................... Execute R [<reg>] [[=]<expr>] .............. Register
L [<args>] ............ Restart 7 ........................ 8087 Register Dump
=================Breakpoints==================== =======Watch Statements======
BP [<addr>] [<count>] ["<cmd>"] . Breakpoint Set W? <expr> ............. Watch
BC [<list>] ................... Breakpoint Clear W[<type>] <range> ..... Watch
BD [<list>] ................. Breakpoint Disable WP? <expr> ....... Watchpoint
BE [<list>] .................. Breakpoint Enable TP? <expr> ....... Tracepoint
BL ............................. Breakpoint List TP[<type> <range> Tracepoint
=====================Modify===================== Y<list> ........ Delete Watch
A [<addr>] ............................ Assemble W ................ List Watch
E[<type>] [<list>] ....................... Enter =========Redirection=========
=====Examine Source===== ====System Control==== [T]>[>]<device> . Send Output
S[+|-|&] ...... Set Mode N[<radix>] . Set Radix <<device> ..... Receive Input
U [<range>] . Unassemble Q ............... Quit =<device> ..... Redirect Both
V [<addr>] . View Source /[<regex>] .... Search " ..................... Pause
. ..... Current Location \ .... Screen Exchange : ..................... Delay
K .......... Stack Trace #[<num>] ..... Tab Set *[<comment>] ........ Comment