mirrors/binutils-gdb
1
0
Fork 0
mirror of https://sourceware.org/git/binutils-gdb.git synced 2024-11-26 19:44:11 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

* gdbmi.texinfo: Lots of typos and grammar fixes from Brian

Browse Source 
Youmans <3diff@flib.gnu.ai.mit.edu>.
This commit is contained in:
Eli Zaretskii 2000-05-07 10:55:24 +00:00
parent 5c84d377b6
commit d68fc55938
2 changed files with 39 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
gdb/mi/ChangeLog-mi
View File

@ -1,3 +1,8 @@
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

66
gdb/mi/gdbmi.texinfo
View File

@ -110,7 +110,7 @@ Elena Zannoni.
* 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::
@ -215,8 +215,8 @@ We want it to be easy to spot a @sc{mi} operation.
@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
@ -405,7 +405,7 @@ Here's what happens if you pass a non-existent command:
@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.
@ -891,7 +891,7 @@ Here's an example of the result when there are no breakpoints:
@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
@ -1039,9 +1039,9 @@ is the name of the file to disassemble
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
@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}
@ -1109,7 +1109,7 @@ inst="sethi %hi(0x11800), %o2"@},
(gdb)
@end smallexample
Disassemble 3 instruction from the start of @code{main}:
Disassemble 3 instructions from the start of @code{main}:
@smallexample
(gdb)
@ -1124,7 +1124,7 @@ inst="sethi %hi(0x11800), %o2"@}@}
(gdb)
@end smallexample
Disassemble 3 instruction from the start of @code{main} in mixed mode:
Disassemble 3 instructions from the start of @code{main} in mixed mode:
@smallexample
(gdb)
@ -1163,7 +1163,7 @@ If the expression contains spaces, it must be enclosed in double quotes.
@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
@ -1274,8 +1274,8 @@ For the PPC MBX board:
-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.
@ -1400,9 +1400,9 @@ An offset to add to the @var{address} before fetching memory.
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
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}.
@ -1499,7 +1499,7 @@ Disable display @var{number}.
@subsubheading GDB Command
the corresponding GDB command is @samp{disable display}.
The corresponding GDB command is @samp{disable display}.
@subsubheading Example
N.A.
@ -1575,7 +1575,7 @@ Set GDB's working directory.
@subsubheading GDB Command
the corresponding GDB command is @samp{cd}.
The corresponding GDB command is @samp{cd}.
@subsubheading Example
@ -1984,7 +1984,7 @@ encountered or the program exits.
@subsubheading GDB Command
The corresponding GDB command is @samp{run}
The corresponding GDB command is @samp{run}.
@subsubheading Example
@ -2076,6 +2076,8 @@ Regular stepping:
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.
@ -2154,7 +2156,7 @@ Specify the executable file to be debugged. This file is the one from
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
@ -2254,7 +2256,7 @@ List the shared libraries in the program.
@subsubheading GDB Command
The corresponding GDB command os @samp{info shared}.
The corresponding GDB command is @samp{info shared}.
@subsubheading Example
N.A.
@ -2289,7 +2291,7 @@ N.A.
@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
@ -2306,8 +2308,8 @@ The corresponding GDB command is @samp{symbol-file}.
@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
@ -2552,7 +2554,7 @@ stack.
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
@ -2720,7 +2722,7 @@ Show a single frame:
-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.
@ -2786,7 +2788,7 @@ Describe where @var{symbol} is stored.
@subsubheading GDB Command
the corresponding GDB command is @samp{info address}.
The corresponding GDB command is @samp{info address}.
@subsubheading Example
N.A.
@ -3086,7 +3088,7 @@ The corresponding GDB command is @samp{load}.
@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.
@smallexample
(gdb)
@ -3419,7 +3421,7 @@ The tracepoint commands are not yet implemented.
@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:
@ -3466,7 +3468,7 @@ Appropriate language differences are handled for C, C@t{++} and Java.
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.).
@ -3532,7 +3534,7 @@ The frame under which the expression should be evaluated can be
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
@ -3763,8 +3765,8 @@ What follows is a draft revision to the output specification that
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.
@ -3879,7 +3881,7 @@ handle (new breakpoint information). All notify output is prefixed by
the prefix `='.
@item
@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 ``~''.