Youmans <3diff@flib.gnu.ai.mit.edu>.
+2000-05-07 Eli Zaretskii <eliz@is.elta.co.il>
+
+ * gdbmi.texinfo: Lots of typos and grammar fixes from Brian
+ Youmans <3diff@flib.gnu.ai.mit.edu>.
+
Wed Apr 26 18:35:19 2000 Andrew Cagney <cagney@b1.cygnus.com>
* gdbmi.texinfo (GDB/MI Output Syntax v2.0): Convert Draft 2.0
Wed Apr 26 18:35:19 2000 Andrew Cagney <cagney@b1.cygnus.com>
* gdbmi.texinfo (GDB/MI Output Syntax v2.0): Convert Draft 2.0
* GDB/MI Breakpoint Table Commands::
* GDB/MI Data Manipulation::
* GDB/MI Program Control::
* GDB/MI Breakpoint Table Commands::
* GDB/MI Data Manipulation::
* GDB/MI Program Control::
-* GDB/MI Misc Commands::
+* GDB/MI Miscellaneous Commands::
* GDB/MI Stack Manipulation::
* GDB/MI Symbol Query::
* GDB/MI Target Manipulation::
* GDB/MI Stack Manipulation::
* GDB/MI Symbol Query::
* GDB/MI Target Manipulation::
@cindex output syntax of @sc{gdb/mi}
@cindex @sc{gdb/mi}, output syntax
The output from @sc{gdb/mi} consists of zero or more out-of-band records
@cindex output syntax of @sc{gdb/mi}
@cindex @sc{gdb/mi}, output syntax
The output from @sc{gdb/mi} consists of zero or more out-of-band records
-followed, optionally, by a single result record. The result record
-being for the most recent command. The sequence of output records is
+followed, optionally, by a single result record. This result record
+is for the most recent command. The sequence of output records is
terminated by @samp{(gdb)}.
If an input command was prefixed with a @code{@var{token}} then the
terminated by @samp{(gdb)}.
If an input command was prefixed with a @code{@var{token}} then the
@cindex compatibility, @sc{gdb/mi} and CLI
@cindex @sc{gdb/mi}, compatibility with CLI
@cindex compatibility, @sc{gdb/mi} and CLI
@cindex @sc{gdb/mi}, compatibility with CLI
-To help users familiar with the GDB's existing CLI interface, @sc{gdb/mi}
+To help users familiar with GDB's existing CLI interface, @sc{gdb/mi}
accepts existing CLI commands. As specified by the syntax, such
commands can be directly entered into the @sc{gdb/mi} interface and GDB will
respond.
accepts existing CLI commands. As specified by the syntax, such
commands can be directly entered into the @sc{gdb/mi} interface and GDB will
respond.
@end example
Create a watchpoint. With the @samp{-a} option it will create an
@end example
Create a watchpoint. With the @samp{-a} option it will create an
-@dfn{access} watchpoint, i.e. a watchpoints that triggers either on a
+@dfn{access} watchpoint, i.e. a watchpoint that triggers either on a
read from or on a write to the memory location. With the @samp{-r}
option, the watchpoint created is a @dfn{read} watchpoint, i.e. it will
trigger only when the memory location is accessed for reading. Without
read from or on a write to the memory location. With the @samp{-r}
option, the watchpoint created is a @dfn{read} watchpoint, i.e. it will
trigger only when the memory location is accessed for reading. Without
is the line number to disassemble around
@item @var{lines}
is the the number of disassembly lines to be produced. If it is -1,
is the line number to disassemble around
@item @var{lines}
is the the number of disassembly lines to be produced. If it is -1,
-the whole function will be disassembled, in case no @var{end-add} is
+the whole function will be disassembled, in case no @var{end-addr} is
specified. If @var{end-addr} is specified as a non-zero value, and
specified. If @var{end-addr} is specified as a non-zero value, and
-@var{lines} is lower that the number of disassembly lines between
+@var{lines} is lower than the number of disassembly lines between
@var{start-addr} and @var{end-addr}, only @var{lines} lines are
displayed; if @var{lines} is higher than the number of lines between
@var{start-addr} and @var{end-addr}, only the lines up to @var{end-addr}
@var{start-addr} and @var{end-addr}, only @var{lines} lines are
displayed; if @var{lines} is higher than the number of lines between
@var{start-addr} and @var{end-addr}, only the lines up to @var{end-addr}
-Disassemble 3 instruction from the start of @code{main}:
+Disassemble 3 instructions from the start of @code{main}:
-Disassemble 3 instruction from the start of @code{main} in mixed mode:
+Disassemble 3 instructions from the start of @code{main} in mixed mode:
@subsubheading GDB Command
The corresponding GDB commands are @samp{print}, @samp{output}, and
@subsubheading GDB Command
The corresponding GDB commands are @samp{print}, @samp{output}, and
-@code{call}. In @code{gdbtk} only, there's a corresponding
+@samp{call}. In @code{gdbtk} only, there's a corresponding
@samp{gdb_eval} command.
@subsubheading Example
@samp{gdb_eval} command.
@subsubheading Example
-data-list-register-values @var{fmt} [ ( @var{regno} )*]
@end example
-data-list-register-values @var{fmt} [ ( @var{regno} )*]
@end example
-Display the registers contents. @var{fmt} is the format according to
-which the registers contents are to be returned, followed by an optional
+Display the registers' contents. @var{fmt} is the format according to
+which the registers' contents are to be returned, followed by an optional
list of numbers specifying the registers to display. A missing list of
numbers indicates that the contents of all the registers must be returned.
list of numbers specifying the registers to display. A missing list of
numbers indicates that the contents of all the registers must be returned.
This command displays memory contents as a table of @var{nr-rows} by
@var{nr-cols} words, each word being @var{word-size} bytes. In total,
@code{@var{nr-rows} * @var{nr-cols} * @var{word-size}} bytes are read
This command displays memory contents as a table of @var{nr-rows} by
@var{nr-cols} words, each word being @var{word-size} bytes. In total,
@code{@var{nr-rows} * @var{nr-cols} * @var{word-size}} bytes are read
-(returned as @samp{total-bytes}. Should less then the requested number
+(returned as @samp{total-bytes}). Should less then the requested number
of bytes be returned by the target, the missing words are identified
of bytes be returned by the target, the missing words are identified
-using @samp{N/A}. The number of bytes read from the target is returned
+using @samp{N/A}. The number of bytes read from the target is returned
in @samp{nr-bytes} and the starting address used to read memory in
@samp{addr}.
in @samp{nr-bytes} and the starting address used to read memory in
@samp{addr}.
@subsubheading GDB Command
@subsubheading GDB Command
-the corresponding GDB command is @samp{disable display}.
+The corresponding GDB command is @samp{disable display}.
@subsubheading Example
N.A.
@subsubheading Example
N.A.
@subsubheading GDB Command
@subsubheading GDB Command
-the corresponding GDB command is @samp{cd}.
+The corresponding GDB command is @samp{cd}.
@subsubheading GDB Command
@subsubheading GDB Command
-The corresponding GDB command is @samp{run}
+The corresponding GDB command is @samp{run}.
Asynchronous command. Resumes the inferior which executes one machine
instruction. The output, once stop, will vary depend on whether we have
Asynchronous command. Resumes the inferior which executes one machine
instruction. The output, once stop, will vary depend on whether we have
+@c Someone who knows this should figure out what 'once stop' is supposed
+@c to be. 'once stop is reached'? - BTY
stopped in the middle of a source line or not. In the former case, the
address at which the program stopped will be printed as well.
stopped in the middle of a source line or not. In the former case, the
address at which the program stopped will be printed as well.
which the symbol table is also read. If no file is specified, the
command clears the executable and symbol information. If breakpoints
are set when using this command with no arguments, gdb will produce
which the symbol table is also read. If no file is specified, the
command clears the executable and symbol information. If breakpoints
are set when using this command with no arguments, gdb will produce
-error messages. Oterwise, no output is produced, except a completion
+error messages. Otherwise, no output is produced, except a completion
notification.
@subsubheading GDB Command
notification.
@subsubheading GDB Command
@subsubheading GDB Command
@subsubheading GDB Command
-The corresponding GDB command os @samp{info shared}.
+The corresponding GDB command is @samp{info shared}.
@subsubheading Example
N.A.
@subsubheading Example
N.A.
@end example
Read symbol table info from the specified @var{file} argument. When
@end example
Read symbol table info from the specified @var{file} argument. When
-used without arguments, clears GDB'S symbol table info. No output is
+used without arguments, clears GDB's symbol table info. No output is
produced, except for a completion notification.
@subsubheading GDB Command
produced, except for a completion notification.
@subsubheading GDB Command
@end smallexample
@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@end smallexample
@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-@node GDB/MI Misc Commands
-@section Misc GDB commands in @sc{gdb/mi}
+@node GDB/MI Miscellaneous Commands
+@section Miscellaneous GDB commands in @sc{gdb/mi}
@c @subheading -gdb-complete
@c @subheading -gdb-complete
The @var{show-values} argument must have a value of 0 or 1. A value of
0 means that only the names of the arguments are listed, a value of 1
The @var{show-values} argument must have a value of 0 or 1. A value of
0 means that only the names of the arguments are listed, a value of 1
-means that both names and values of the argumetns are printed.
+means that both names and values of the arguments are printed.
@subsubheading GDB Command
@subsubheading GDB Command
-stack-list-locals @var{print-values}
@end example
-stack-list-locals @var{print-values}
@end example
-Display the local variables names for the current frame. With an
+Display the local variable names for the current frame. With an
argument of 0 prints only the names of the variables, with argument of 1
prints also their values.
argument of 0 prints only the names of the variables, with argument of 1
prints also their values.
@subsubheading GDB Command
@subsubheading GDB Command
-the corresponding GDB command is @samp{info address}.
+The corresponding GDB command is @samp{info address}.
@subsubheading Example
N.A.
@subsubheading Example
N.A.
@subsubheading Example
Note: each status message appears on a single line. Here the messages
@subsubheading Example
Note: each status message appears on a single line. Here the messages
-have been broken down, so they can fit into a page.
+have been broken down so that they can fit onto a page.
@subheading Motivation for Variable Objects in @sc{gdb/mi}
For the implementation of a variable debugger window (locals, watched
@subheading Motivation for Variable Objects in @sc{gdb/mi}
For the implementation of a variable debugger window (locals, watched
-expressions, etc.), we are proposing the adaptation of the existent code
+expressions, etc.), we are proposing the adaptation of the existing code
used by @code{Insight}.
The two main reasons for that are:
used by @code{Insight}.
The two main reasons for that are:
When returning the actual values of the objects, this facility allows
for the individual selection of the display format used in the result
creation. It can be chosen among: binary, decimal, hexadecimal, octal
When returning the actual values of the objects, this facility allows
for the individual selection of the display format used in the result
creation. It can be chosen among: binary, decimal, hexadecimal, octal
-and natural. Natural refers to the a default format automatically
+and natural. Natural refers to a default format automatically
chosen based on the variable type (like decimal for an @code{int}, hex
for pointers, etc.).
chosen based on the variable type (like decimal for an @code{int}, hex
for pointers, etc.).
specified by @var{frame-addr}. A @samp{*} indicates that the current
frame should be used.
specified by @var{frame-addr}. A @samp{*} indicates that the current
frame should be used.
-Expression is any expression valid on the current language set (must not
+@var{expression} is any expression valid on the current language set (must not
begin with a @samp{*}), or one of the following:
@itemize @bullet
begin with a @samp{*}), or one of the following:
@itemize @bullet
addresses this problem.
The output from @sc{gdb/mi} consists of zero or more out-of-band records
addresses this problem.
The output from @sc{gdb/mi} consists of zero or more out-of-band records
-optionally followed by a single result record. The result record being
-for the most recent command input. The sequence being terminated by
+optionally followed by a single result record, the result record being
+for the most recent command input. The sequence is terminated by
``(gdb)''.
Asynchronous @sc{gdb/mi} output is similar.
``(gdb)''.
Asynchronous @sc{gdb/mi} output is similar.
-@var{console-stream-output} is output that should be displayed as is in the
+@var{console-stream-output} is output that should be displayed as is, in the
console. It is the textual response to a CLI command. All the console
output is prefixed by the prefix ``~''.
console. It is the textual response to a CLI command. All the console
output is prefixed by the prefix ``~''.