[Emacs-diffs] emacs/doc/emacs building.texi

[Nick Roberts]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Nick Roberts <nickrob>  09/01/20 05:20:41

Modified files:
        doc/emacs      : building.texi 

Log message:
        (Debuggers): Revert some of 2008-10-31 change  to
        raise GUD subsections.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/building.texi?cvsroot=emacs&r1=1.14&r2=1.15

Patches:
Index: building.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/building.texi,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- building.texi       8 Jan 2009 05:28:47 -0000       1.14
+++ building.texi       20 Jan 2009 05:20:40 -0000      1.15
@@ -449,36 +449,6 @@
 @cindex debuggers
 @cindex GUD library
 @cindex GDB
-
-Emacs provides two separate facilities for using external symbolic
-debuggers, which are programs for testing and debugging other
-programs:
address@hidden @bullet
address@hidden
-The Grand Unified Debugger (GUD) provides a simple, text-based
-interface for a wide variety of symbolic debuggers, including the GNU
-Debugger (GDB), the Perl debugger, the Python debugger, and the Java
-Debugger.
-
address@hidden
-The GDB Graphical Interface is an Emacs package that interacts with
-GDB to turn Emacs into a graphical ``integrated development
-environment'', or IDE.
address@hidden itemize
-
-  In addition, Emacs contains a built-in system for debugging Emacs
-Lisp programs.  @xref{Debugging,, The Lisp Debugger, elisp, the Emacs
-Lisp Reference Manual}, for information on the Emacs Lisp debugger.
-
address@hidden
-* GUD::                             The Grand Unified Debugger.
-* GDB Graphical Interface::  A mode that uses GDB features to implement
-                             a graphical Emacs debugging environment.
address@hidden menu
-
address@hidden GUD
address@hidden GUD
address@hidden GUD library
 @cindex DBX
 @cindex SDB
 @cindex XDB
@@ -498,25 +468,36 @@
 * Debugger Operation:: Connection between the debugger and source buffers.
 * Commands of GUD::    Key bindings for common commands.
 * GUD Customization::  Defining your own commands for GUD.
+* GDB Graphical Interface::  An enhanced mode that uses GDB features to
+                        implement a graphical debugging environment through
+                        Emacs.
 @end menu
 
 @node Starting GUD
address@hidden Starting GUD
address@hidden Starting GUD
 
   There are several commands for starting a debugger under GUD, each
 corresponding to a particular debugger program.
 
 @table @kbd
address@hidden M-x gdb @key{RET} @var{file} @key{RET}
address@hidden gdb
+Run GDB as a subprocess of Emacs.  This uses an IDE-like graphical
+interface; see @ref{GDB Graphical Interface}.  Only GDB works with the
+graphical interface.
+
 @item M-x gud-gdb @key{RET} @var{file} @key{RET}
 @findex gud-gdb
 Run GDB as a subprocess of Emacs.  This command creates a buffer for
 input and output to GDB, and switches to it.  If a GDB buffer already
-exists, it just switches to that buffer.  (To run GDB in an IDE-like
-graphical interface instead, see @ref{GDB Graphical Interface}.)
+exists, it just switches to that buffer.
 
 @item M-x dbx @key{RET} @var{file} @key{RET}
 @findex dbx
-Run DBX as a subprocess of Emacs.
+Run DBX as a subprocess of Emacs.  Since Emacs does not implement a
+graphical interface for DBX, communication with DBX works by typing
+commands in the GUD interaction buffer.  The same is true for all
+the other supported debuggers.
 
 @item M-x xdb @key{RET} @var{file} @key{RET}
 @findex xdb
@@ -568,7 +549,7 @@
 Debugging Remote Programs, gdb, The GNU debugger}).
 
 @node Debugger Operation
address@hidden Debugger Operation
address@hidden Debugger Operation
 
 @cindex fringes, and current execution line in GUD
   Generally when you run a debugger with GUD, the debugger uses an Emacs
@@ -615,7 +596,7 @@
 effects.
 
 @node Commands of GUD
address@hidden Commands of GUD
address@hidden Commands of GUD
 
   The GUD interaction buffer uses a variant of Shell mode, so the
 Emacs commands of Shell mode are available (@pxref{Shell Mode}).  All
@@ -772,7 +753,7 @@
 Instead, type @kbd{C-q @key{TAB}} to enter a tab.
 
 @node GUD Customization
address@hidden GUD Customization
address@hidden GUD Customization
 
 @vindex gdb-mode-hook
 @vindex dbx-mode-hook