Re: Generality of defvar

[Thibaut Verron]

Le mer. 27 juil. 2022 à 18:29, Christopher Dimech <dimech@gmx.com> a écrit :

>
>
> > Sent: Thursday, July 28, 2022 at 1:47 AM
> > From: "Thibaut Verron" <thibaut.verron@gmail.com>
> > To: carlmarcos@tutanota.com
> > Cc: "Emanuel Berg" <incal@dataswamp.org>, "help-gnu-emacs" <
> help-gnu-emacs@gnu.org>
> > Subject: Re: Generality of defvar
> >
> > Le mer. 27 juil. 2022 à 15:24, <carlmarcos@tutanota.com> a écrit :
> >
> > >
> > > Jul 27, 2022, 13:21 by thibaut.verron@gmail.com:
> > >
> > > > Le mer. 27 juil. 2022 à 14:52, carlmarcos--- via Users list for the
> GNU
> > > Emacs text editor <> help-gnu-emacs@gnu.org> > a écrit :
> > > >
> > > >>
> > > >>
> > > >>  Jul 27, 2022, 12:34 by >> incal@dataswamp.org>> :
> > > >>
> > > >>  > carlmarcos--- via Users list for the GNU Emacs text editor wrote:
> > > >>  >
> > > >>  >> (defun enable-error-diagnostics ()
> > > >>  >>  "Enable error diagnostics with backtrace buffer.
> > > >>  >> One can exit the debugger with the q command."
> > > >>  >>
> > > >>  >
> > > >>  > You can refer to keys in docstrings like this:
> > > >>  >
> > > >>  >  \\[forward-word]
> > > >>  >
> > > >>  > That way, it isn't hardcoded so if later changed/configured
> > > >>  > it'll still show the right key.
> > > >>  >
> > > >>  How can I figure out what key to use in the docstring for exiting
> the
> > > backtrace buffer?
> > > >>
> > > >
> > > > The function bound to 'q' is quit-window. But since this function
> > > doesn't have a global binding, you need to tell the docstring to use
> the
> > > appropriate keymap to look the binding up.
> > > >
> > > > Something like
> > > >
> > > >   "Enable error diagnostics with backtrace buffer.
> > > >
> > > > \\<backtrace-mode-map> (note: this is the part telling emacs where to
> > > look for the key)
> > > > One can exit the debugger with the `quit-window' command (bound to
> > > \\[quit-window])."
> > > >
> > > >
> > > Although quit-window is bound to q, the command \\[quit-window] just
> > > inserts
> > > M-x quit-window, rather than q.
> > >
> >
> > Yes, that's precisely because quit-window doesn't have a global binding.
> > You need to add \\<backtrace-mode-map> somewhere in the docstring to tell
> > emacs to show bindings for the backtrace buffers, rather than global
> > bindings.
> >
> > Best wishes,
> > Thibaut
>
> Sounds good advice, but the result could be
>
> Uses keymap ‘backtrace-mode-map’, which is not currently defined.
>

My bad, it should have been debugger-mode-map.