comparison man/building.texi @ 60440:c82b8f53ded0

(Starting GUD): Don't explain text vs graphical GDB here. Just mention they exist, and xref. Delete "just one debugger process". (Debugger Operation): Move GUD tooltip info here. (GUD Tooltips): Node deleted. (GDB Graphical Interface): Explain the two GDB modes here.

60439:56ad74aa4129

@menu
* Starting GUD::	How to start a debugger subprocess.
* 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.
* GUD Tooltips::        Showing variable values by pointing with the mouse.
* GDB Graphical Interface::  An enhanced mode that uses GDB features to
                        implement a graphical debugging environment through
                        Emacs.
@end menu

to a particular debugger program.

@table @kbd
@item M-x gdb @key{RET} @var{file} @key{RET}
@findex gdb
Run GDB as a subprocess of Emacs.  By default, GDB starts as for
@kbd{M-x gdba} below.  If you want GDB to start as in Emacs 21.3 and
earlier then edit the string in the minibuffer or set
@code{gud-gdb-command-name} to ``gdb --fullname''.  You need to do
this if you want to run multiple debugging sessions within one Emacs
session.  In this case, the 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.

@item M-x gdba @key{RET} @var{file} @key{RET}
Run GDB as a subprocess of Emacs, providing a graphical interface
to GDB features through Emacs.  @xref{GDB Graphical Interface}.

@item M-x dbx @key{RET} @var{file} @key{RET}
@findex dbx
Similar, but run DBX instead of GDB.

the debugger.  In the simplest case, specify just the name of the
executable file you want to debug.  You may also use options that the
debugger supports.  However, shell wildcards and variables are not
allowed.  GUD assumes that the first argument not starting with a
@samp{-} is the executable file name.

  Emacs can only run one debugger process at a time.

@node Debugger Operation
@subsection Debugger Operation

@cindex fringes, and current execution line in GUD

  If you wish, you can control your debugger process entirely through the
debugger buffer, which uses a variant of Shell mode.  All the usual
commands for your debugger are available, and you can use the Shell mode
history commands to repeat them.  @xref{Shell Mode}.

@node Commands of GUD
@subsection Commands of GUD

  The GUD interaction buffer uses a variant of Shell mode, so the

If you don't use @samp{%p} in the command string, the command you define
ignores any numeric argument.
@end table

@node GUD Tooltips
@subsection GUD Tooltips

@cindex tooltips with GUD
The Tooltip facility (@pxref{Tooltips}) provides support for GUD@.  If
GUD support is activated by customizing the @code{tooltip} group,
variable values can be displayed in tooltips by pointing at them with
the mouse in the GUD buffer or in source buffers with major modes in the
customizable list @code{tooltip-gud-modes}.

@node GDB Graphical Interface
@subsection GDB Graphical Interface

By default, the command @code{gdb} starts GDB using a graphical
interface where you view and control the program's data using Emacs
windows.  You can still interact with GDB through the GUD buffer, but
the point of this mode is that you can do it through menus and clicks,
without needing to know GDB commands.

@findex gdba
If you have customised @code{gud-gdb-command-name}, then start this
mode with the command @code{gdba}.

@menu
* Layout::               Control the number of displayed buffers.
* Breakpoints Buffer::   A breakpoint control panel.
* Stack Buffer::         Select a frame from the call stack.

60440:c82b8f53ded0

@menu
* Starting GUD::	How to start a debugger subprocess.
* 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

to a particular debugger program.

@table @kbd
@item M-x gdb @key{RET} @var{file} @key{RET}
@findex gdb
Run GDB as a subprocess of Emacs.  By default, this operates in
graphical mode; @xref{GDB Graphical Interface}.  Graphical mode
does not support any other debuggers.

@item M-x dbx @key{RET} @var{file} @key{RET}
@findex dbx
Similar, but run DBX instead of GDB.

the debugger.  In the simplest case, specify just the name of the
executable file you want to debug.  You may also use options that the
debugger supports.  However, shell wildcards and variables are not
allowed.  GUD assumes that the first argument not starting with a
@samp{-} is the executable file name.

@node Debugger Operation
@subsection Debugger Operation

@cindex fringes, and current execution line in GUD

  If you wish, you can control your debugger process entirely through the
debugger buffer, which uses a variant of Shell mode.  All the usual
commands for your debugger are available, and you can use the Shell mode
history commands to repeat them.  @xref{Shell Mode}.

@cindex tooltips with GUD
@vindex tooltip-gud-modes
  The Tooltip facility (@pxref{Tooltips}) provides support for GUD@.
You activate this feature by customizing the @code{tooltip} group.
Then you can display a variable's value in a tooltip simply by
pointing at it with the mouse.  This operates in the GUD buffer and in
source buffers with major modes in the list @code{tooltip-gud-modes}.

@node Commands of GUD
@subsection Commands of GUD

  The GUD interaction buffer uses a variant of Shell mode, so the

If you don't use @samp{%p} in the command string, the command you define
ignores any numeric argument.
@end table

@node GDB Graphical Interface
@subsection GDB Graphical Interface

  By default, the command @code{gdb} starts GDB using a graphical
interface where you view and control the program's data using Emacs
windows.  You can still interact with GDB through the GUD buffer, but
the point of this mode is that you can do it through menus and clicks,
without needing to know GDB commands.

@vindex gud-gdb-command-name
@findex gdba
  You can also run GDB in text command mode, which creates a buffer
for input and output to GDB.  To do this, set
@code{gud-gdb-command-name} to @code{"gdb --fullname"} or edit the
startup command in the minibuffer to say that.  You need to do use
text command mode to run multiple debugging sessions within one Emacs
session.  If you have customised @code{gud-gdb-command-name} in that
way, then you can use @kbd{M-x gdba} to invoke GDB in graphical mode.

@menu
* Layout::               Control the number of displayed buffers.
* Breakpoints Buffer::   A breakpoint control panel.
* Stack Buffer::         Select a frame from the call stack.