bug#981: 23.0.60; doc of debug-on-error

bug#981: 23.0.60; doc of debug-on-error

[Drew Adams]

`debug-on-error' does not control what happens during Lisp rexpression
evaluation. But you cannot know this by looking at only the doc of
`debug-on-error'.  For example, evaluate this using either `C-x C-e'
in buffer *scratch or via `M-:':
(unwind-protect jjjjjjj (message "XXXX"))
 
`eval-expression-debug-on-error' is what controls this behavior. In
the Elisp manual, the doc for `debug-on-error' is on the same page as
the doc for `eval-expression-debug-on-error', but even so, a reader
might read only the `debug-on-error' part if that's what s?he is
looking up.
 
The `debug-on-error' description in the manual needs a "see below"
mention of `eval-expression-debug-on-error' and of the fact that
`debug-on-error' alone does not control what happens during such sexp
evaluation.
 
The `debug-on-error' doc string, likewise, needs to mention this and
cross-reference the doc string for `eval-expression-debug-on-error'.
 
I think what happened was that when `eval-expression-debug-on-error'
was introduced in Emacs 21 this doc dependency was overlooked - the
doc for `eval-expression-debug-on-error' was added but the doc for
`debug-on-error' was not updated accordingly. In Emacs 20,
`debug-on-error' is all there is, so its doc is complete and
sufficient.
 

In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600)
 of 2008-09-03 on LENNART-69DE564
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include
-fno-crossjumping'
 

bug#981: marked as done (23.0.60; doc of debug-on-error)

[Emacs bug Tracking System]

[-- Attachment #1: Type: text/plain, Size: 802 bytes --]


Your message dated Thu, 11 Dec 2008 22:55:27 -0500
with message-id <usabb2hwsw.fsf@fencepost.gnu.org>
and subject line Re: Bug#981
has caused the Emacs bug report #981,
regarding 23.0.60; doc of debug-on-error
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact don@donarmstrong.com
immediately.)


-- 
981: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=981
Emacs Bug Tracking System
Contact don@donarmstrong.com with problems

[-- Attachment #2: Type: message/rfc822, Size: 4053 bytes --]

From: "Drew Adams" <drew.adams@oracle.com>
To: <emacs-pretest-bug@gnu.org>
Subject: 23.0.60; doc of debug-on-error
Date: Sun, 14 Sep 2008 14:59:11 -0700
Message-ID: <006001c916b5$1eec3ce0$0200a8c0@us.oracle.com>

`debug-on-error' does not control what happens during Lisp rexpression
evaluation. But you cannot know this by looking at only the doc of
`debug-on-error'.  For example, evaluate this using either `C-x C-e'
in buffer *scratch or via `M-:':
(unwind-protect jjjjjjj (message "XXXX"))
 
`eval-expression-debug-on-error' is what controls this behavior. In
the Elisp manual, the doc for `debug-on-error' is on the same page as
the doc for `eval-expression-debug-on-error', but even so, a reader
might read only the `debug-on-error' part if that's what s?he is
looking up.
 
The `debug-on-error' description in the manual needs a "see below"
mention of `eval-expression-debug-on-error' and of the fact that
`debug-on-error' alone does not control what happens during such sexp
evaluation.
 
The `debug-on-error' doc string, likewise, needs to mention this and
cross-reference the doc string for `eval-expression-debug-on-error'.
 
I think what happened was that when `eval-expression-debug-on-error'
was introduced in Emacs 21 this doc dependency was overlooked - the
doc for `eval-expression-debug-on-error' was added but the doc for
`debug-on-error' was not updated accordingly. In Emacs 20,
`debug-on-error' is all there is, so its doc is complete and
sufficient.
 

In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600)
 of 2008-09-03 on LENNART-69DE564
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include
-fno-crossjumping'
 




[-- Attachment #3: Type: message/rfc822, Size: 1508 bytes --]

From: Glenn Morris <rgm@gnu.org>
To: 981-done@emacsbugs.donarmstrong.com
Subject: Re: Bug#981
Date: Thu, 11 Dec 2008 22:55:27 -0500
Message-ID: <usabb2hwsw.fsf@fencepost.gnu.org>


e-e-d-o-e now mentioned in both places.