Jason Aller Floppy Collection/75.img/CODEVIEW.ZIP/CV.HLP

Codeview Help | 1988-02-23 | 21.0 KB | 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