comparison etc/DEBUG @ 59613:1c3d052ef4bf

Suggest separate terminal for debug session.

59612:69ffba6567d6

makes Control-] (decimal code 29) the stop character.
Typing Control-] will cause immediate stop.  You cannot
use the set command until the inferior process has been started.
Put a breakpoint early in `main', or suspend the Emacs,
to get an opportunity to do the set command.

** Examining Lisp object values.

When you have a live process to debug, and it has not encountered a
fatal error, you can use the GDB command `pr'.  First print the value

    cd src
    gdb emacs
    b set_frame_buffer_list
    r -q

Then when Emacs it hits the breakpoint:

    (gdb) p frame
    $1 = 139854428
    (gdb) xtype
    Lisp_Vectorlike

59613:1c3d052ef4bf

makes Control-] (decimal code 29) the stop character.
Typing Control-] will cause immediate stop.  You cannot
use the set command until the inferior process has been started.
Put a breakpoint early in `main', or suspend the Emacs,
to get an opportunity to do the set command.

When Emacs is running in a terminal, it is useful to use a separate terminal
for the debug session.  This can be done by starting Emacs as usual, then
attaching to it from gdb with the `attach' command which is explained in the
node "Attach" of the GDB manual.

** Examining Lisp object values.

When you have a live process to debug, and it has not encountered a
fatal error, you can use the GDB command `pr'.  First print the value

    cd src
    gdb emacs
    b set_frame_buffer_list
    r -q

Then Emacs hits the breakpoint:

    (gdb) p frame
    $1 = 139854428
    (gdb) xtype
    Lisp_Vectorlike