summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKeith Seitz <keiths@redhat.com>2002-08-29 22:56:19 +0000
committerKeith Seitz <keiths@redhat.com>2002-08-29 22:56:19 +0000
commitce5279b7b89515fb4a4b46e01ef2da9b386663c8 (patch)
treed8cbef2cf9f6a3c0cab0482159bfa199b564cb74
parent0a5f440418e4b92d4184d28bcc9252dd2c6f54f8 (diff)
downloadgdb-ce5279b7b89515fb4a4b46e01ef2da9b386663c8.tar.gz
* gdb.texinfo: Update interpreter chapters with indexing
information. Recommended by Eli Zaretskii <eliz@is.elta.co.il>.
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdb.texinfo11
2 files changed, 15 insertions, 1 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index a74863fffbb..05825684d3e 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2002-08-29 Keith Seitz <keiths@redhat.com>
+
+ * gdb.texinfo: Update interpreter chapters with indexing
+ information. Recommended by Eli Zaretskii <eliz@is.elta.co.il>.
+
2002-08-28 Keith Seitz <keiths@redhat.com>
* gdb.texinfo: Add chapter on interpreters. Refer the
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 99bf767d195..1072ed480fe 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -13077,6 +13077,7 @@ letter.
@node Interpreters
@chapter Command Interpreters
+@cindex command interpreters
@value{GDBN} supports multiple command interpreters, and some command
infrastructure to allow users or user interface writers to switch between
@@ -13089,35 +13090,43 @@ both of these interfaces in great detail.
By default, @value{GDBN} will start with the console interpreter. However,
the user may choose to start @value{GDBN} with another interpreter by specifying
-the "-i" or "--interpreter" startup options. Defined interpreters include:
+the @option{-i} or @option{--interpreter} startup options. Defined interpreters
+include:
@table @code
@item console
+@cindex console interpreter
The traditional console or command-line interpreter. This is the most often
used interpreter with @value{GDBN}. With no interpreter specified at runtime,
@value{GDBN} will use this interpreter.
@item mi
+@cindex mi interpreter
The newest @sc{gdb/mi} interface, used primarily by programs wishing to use
@value{GDBN} as a backend for a debugger GUI or an IDE. For more information,
see @ref{GDB/MI, ,The @sc{gdb/mi} Interface}.
@item mi2
+@cindex mi2 interpreter
The latest version of the @sc{gdb/mi} interface.
@item mi1
+@cindex mi1 interpreter
The @sc{gdb/mi} version included in @value{GDBN} version 5.1.
@item mi0
+@cindex mi0 interpreter
The @sc{gdb/mi} version included in @value{GDBN} version 5.0.
@end table
+@cindex invoke another interpreter
The interpreter being used by @value{GDBN} may not be dynamically switched at
runtime. Although possible, this could lead to a very precarious situation.
Consider an IDE using @sc{gdb/mi}. If a user enters the command
"interpreter-set console" in a console view, @value{GDBN} would switch
to using the console interpreter, rendering the IDE inoperable!
+@kindex interpreter-exec
Although you may only choose a single interpreter at startup, you may execute
commands in any interpreter from the current interpreter using the appropriate
command. If you are running the console interpreter, simply use the