GNU bug report logs - #79144
[PATCH] New debugger-trap function to break to GDB

Previous Next

Full log

Message #29 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Jeremy Bryant <jb <at> jeremybryant.net>
To: Paul Eggert <eggert <at> cs.ucla.edu>
Cc: Jim Porter <jporterbugs <at> gmail.com>, bug-gnu-emacs <at> gnu.org,
 Eli Zaretskii <eliz <at> gnu.org>
Subject: Re: [PATCH] New debugger-trap function to break to GDB
Date: Sun, 03 Aug 2025 22:41:18 +0100

[Message part 1 (text/plain, inline)]

Paul Eggert <eggert <at> cs.ucla.edu> writes:

> On 2025-08-02 13:10, Jeremy Bryant wrote:
>> Would the following clarification be clearer from your perspective?
>>         doc: /* Trap execution flow and hand over control to GDB.
>> To use, set up a breakpoint in GDB with
>> break Fdebugger_trap
>> This is done in the Emacs source distribution in src/.gdbinit.
>> The function itself is a do-nothing primitive.  It is reserved for
>> debugging purposes, and not called by Emacs otherwise.  */)
>
> Yes, thanks. Some minor wording tweaks, which make it easier for me to
> understand:
>
> Trap execution flow and hand over control to GDB. The Emacs source
> file src/.gdbinit uses this via the GDB command "break Fdebugger
> trap".
>
> This function has no effect.  It is reserved for debugging, and is not
> called by Emacs otherwise.

OK, revised patch attached for consideration.

The change is in the docstring, incorporating your suggestion, Paul, as
well as the addition proposed by Jim, at the end.

What do people think of this change now?



Extract of patch for the docstring:-

DEFUN ("debugger-trap", Fdebugger_trap, Sdebugger_trap, 0, 0, "",
       doc: /* Trap execution flow and hand over control to GDB.
The Emacs source file src/.gdbinit uses this via the GDB command
"break Fdebugger_trap".

This function has no effect.  It is reserved for debugging, and is not
called by Emacs otherwise.

For Lisp debugging see debug, as well as edebug, in the manual:
"(elisp) Debugging".  */)
  (void)
{
  return Qnil;
}

[0001-New-debugger-trap-function-to-break-to-GDB.patch (text/x-diff, attachment)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.