Subject: bug#44577: 27.1; Missing options in definition of edebug-mode in edebug.el

From: Eli Zaretskii <[email-masked]>
Date: Thu, 12 Nov 2020 15:46:47 +0200

> From: Stefan Kangas <[email-masked]>
> Date: Wed, 11 Nov 2020 10:22:13 -0600
> 
> Mark Harig via "Bug reports for GNU Emacs, the Swiss army knife of text
> editors" <[email-masked]> writes:
> 
> > Emacs Maintainers,
> >    In the documentation string in define-minor-mode edebug-mode in edebug.el:
> >    1. The option `edebug-on-signal' is listed, but it does not exist in the file.
> 
> Indeed, I find no matches grepping in the repository for
> `edebug-on-signal', nor in the git log.
> 
> Perhaps it should just be removed?

Yes, please.

> > 2. The following options, which are described in (elisp) Edebug Options, are missing:      edebug-sit-for-seconds, edebug-sit-on-break, edebug-behavior-alist,      edebug-new-definition-function, edebug-after-instrumentation-function
> 
> Maybe instead of maintaining a list, we should just point users to `M-x
> customize-group RET edebug RET'.  Or just remove the list and say
> nothing.

I think we should remove the list from the doc string, yes.  It is
unusual for a doc string of a mode to include an exhaustive list of
all of its customization options; in general, the feature's group
should be enough to discover all of them.  And the manual documents
the most important ones.

Thanks.