aboutsummaryrefslogtreecommitdiff
path: root/gdb/mi
diff options
context:
space:
mode:
authorAndrew Cagney <cagney@redhat.com>2000-04-26 23:39:53 +0000
committerAndrew Cagney <cagney@redhat.com>2000-04-26 23:39:53 +0000
commit8b0ceefcd4fcf135c1318e0cfea999dd13dd6283 (patch)
tree21d35993ca72307085e9d8620fc160458cf7bae0 /gdb/mi
parent8ecb95a25526c836fdc75ffd49baaac32e130c1f (diff)
downloadgdb-8b0ceefcd4fcf135c1318e0cfea999dd13dd6283.zip
gdb-8b0ceefcd4fcf135c1318e0cfea999dd13dd6283.tar.gz
gdb-8b0ceefcd4fcf135c1318e0cfea999dd13dd6283.tar.bz2
Add section discussing future changes to output syntax.
Diffstat (limited to 'gdb/mi')
-rw-r--r--gdb/mi/ChangeLog-mi6
-rw-r--r--gdb/mi/gdbmi.texinfo40
2 files changed, 36 insertions, 10 deletions
diff --git a/gdb/mi/ChangeLog-mi b/gdb/mi/ChangeLog-mi
index c03ef58..d64a3f7 100644
--- a/gdb/mi/ChangeLog-mi
+++ b/gdb/mi/ChangeLog-mi
@@ -1,3 +1,9 @@
+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
+ Output Syntax into a new section. Cross reference.
+ (menu): Fix tipo. GDB/MI Compatibility with CLI.
+
2000-04-23 Eli Zaretskii <eliz@is.elta.co.il>
* gdbmi.texinfo: Lots of changes, to include this document as part
diff --git a/gdb/mi/gdbmi.texinfo b/gdb/mi/gdbmi.texinfo
index a90c9d4..509ea6c 100644
--- a/gdb/mi/gdbmi.texinfo
+++ b/gdb/mi/gdbmi.texinfo
@@ -104,7 +104,7 @@ Elena Zannoni.
@menu
* GDB/MI Command Syntax::
-* GDB/MI and CLI::
+* GDB/MI Compatibility with CLI::
* GDB/MI Output Records::
* GDB/MI Command Description Format::
* GDB/MI Breakpoint Table Commands::
@@ -117,6 +117,7 @@ Elena Zannoni.
* GDB/MI Thread Commands::
* GDB/MI Tracepoint Commands::
* GDB/MI Variable Objects::
+* GDB/MI Draft Changes to Output Syntax::
@end menu
@c When these are implemented, they should be moved to be between Misc and
@@ -340,6 +341,9 @@ the log output is prefixed by @samp{&}.
@xref{GDB/MI Stream Records, , @sc{gdb/mi} Stream Records}, for more
details about the various output records.
+@xref{GDB/MI Draft Changes to Output Syntax, , @sc{gdb/mi} Draft Changes
+to Output Syntax}, for proposed revisions to the current output syntax.
+
@node GDB/MI Simple Examples
@subsection Simple Examples of @sc{gdb/mi} Interaction
@cindex @sc{gdb/mi}, simple examples
@@ -396,7 +400,7 @@ Here's what happens if you pass a non-existent command:
@end example
@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-@node GDB/MI and CLI
+@node GDB/MI Compatibility with CLI
@section @sc{gdb/mi} Compatibility with CLI
@cindex compatibility, @sc{gdb/mi} and CLI
@@ -3732,12 +3736,31 @@ Update the value of the variable object @var{name} by evaluating its
expression after fetching all the new values from memory or registers.
A @samp{*} causes all existing variable objects to be updated.
-@ignore
-@c%%%%%%%%%%%%%%%%%%%%%%%%%%%% APPENDIX %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-@appendix Proposed v2.0 Output Syntax
+@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+@node GDB/MI Draft Changes to Output Syntax
+@section @sc{gdb/mi} Draft Changes to Output Syntax
+
+@cindex draft changes to output syntax of @sc{gdb/mi}
+@cindex @sc{gdb/mi}, draft changes to output syntax
+
+One problem identified in the existing @sc{gdb/mi} output syntax was the
+difficulty in differentiating between a tuple such as:
+
+@example
+@{number="1",type="breakpoint",disp="keep",enabled="y"@}
+@end example
-This appendix is not part of the MI specification. It is provided as a
-discussion point.
+where each value has a unique label, and a list such as:
+
+@example
+@{"1","2","4"@}
+@{bp="1",bp="2",bp="4"@}
+@end example
+
+where values are un-labeled or the label is duplicated.
+
+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
@@ -3871,9 +3894,6 @@ the log output is prefixed by the prefix ``&''.
@end itemize
-@end ignore
-
-
@c Local variables:
@c change-log-default-name: "ChangeLog-mi"
@c End: