unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#18005: 24.4.50; In Emacs manual, tell users how to enter debugger for `user-error' errors
@ 2014-07-12 17:59 Drew Adams
  2014-07-13  1:35 ` Glenn Morris
  2016-04-29 21:51 ` Lars Ingebrigtsen
  0 siblings, 2 replies; 6+ messages in thread
From: Drew Adams @ 2014-07-12 17:59 UTC (permalink / raw)
  To: 18005

The only hint about how to make Emacs enter the debugger for errors
deemed `user-error' is this mention, buried in the
`debug-ignored-errors' entry of the Elisp manual:

     The normal value of this variable includes `user-error', as well
     as several errors that happen often during editing but rarely
     result from bugs in Lisp programs.  However, "rarely" is not
     "never"; if your program fails with an error that matches this
     list, you may try changing this list to debug the error.  The
     easiest way is usually to set `debug-ignored-errors' to `nil'.

(FWIW, wrt this text: Is it really necessary to point out that
users can want to enter the debugger for other reasons that
tracking down a Lisp bug?)

It should be made *obvious* to users, in the *Emacs* manual, how to make
the debugger open for so-called "user errors".

In particular, some mention of how to do this should be added to any
descriptions of `debug-on-error' and `toggle-debug-on-error'.  Yes,
*especially* since these have NO effect on this.  Users will try these
and not understand how to get what they want in this regard.  Here
is one proof: http://superuser.com/q/782313/250462.

(Hard to believe that something presumably designed with end users in
mind would not be documented wrt how to access the debugger.  Of
course, `user-error' has NOTHING to do with user errors anyway...)

In GNU Emacs 24.4.50.1 (i686-pc-mingw32)
 of 2014-06-28 on ODIEONE
Bzr revision: 117431 rgm@gnu.org-20140628015517-eku6hj8mpgcvfnso
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/snapshot/trunk
 --enable-checking=yes,glyphs 'CFLAGS=-O0 -g3'
 LDFLAGS=-Lc:/Devel/emacs/lib 'CPPFLAGS=-DGC_MCHECK=1
 -Ic:/Devel/emacs/include''





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#18005: 24.4.50; In Emacs manual, tell users how to enter debugger for `user-error' errors
  2014-07-12 17:59 bug#18005: 24.4.50; In Emacs manual, tell users how to enter debugger for `user-error' errors Drew Adams
@ 2014-07-13  1:35 ` Glenn Morris
  2014-07-13  2:41   ` Drew Adams
  2016-04-29 21:51 ` Lars Ingebrigtsen
  1 sibling, 1 reply; 6+ messages in thread
From: Glenn Morris @ 2014-07-13  1:35 UTC (permalink / raw)
  To: 18005


The whole point of introducing user-error was so that uninteresting
errors will not trigger the debugger. I see no need to mention in the
*Emacs* manual how to get round this.

(I am not going to get into a big debate about this.)





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#18005: 24.4.50; In Emacs manual, tell users how to enter debugger for `user-error' errors
  2014-07-13  1:35 ` Glenn Morris
@ 2014-07-13  2:41   ` Drew Adams
  2014-07-13 21:54     ` Richard Stallman
  0 siblings, 1 reply; 6+ messages in thread
From: Drew Adams @ 2014-07-13  2:41 UTC (permalink / raw)
  To: Glenn Morris, 18005

> The whole point of introducing user-error was so that uninteresting
> errors will not trigger the debugger. I see no need to mention in the
> *Emacs* manual how to get round this.

"The whole point" should be to _let_ users not be bothered entering
the debugger for uninteresting errors.  That's reasonable behavior.
*Enabling* that behavior is positive.  Forcing it would be
counterproductive, as is not making clear what it is that controls it.

Not to mention the fact that what constitutes an "uninteresting
error" is not something fixed once and for all for everyone.  It
can change, depending on the context.  A user might well want to
take a look under the covers using the debugger in some context.
(The user who just now asked how to do it, for instance.)

> (I am not going to get into a big debate about this.)

No one asked you to.





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#18005: 24.4.50; In Emacs manual, tell users how to enter debugger for `user-error' errors
  2014-07-13  2:41   ` Drew Adams
@ 2014-07-13 21:54     ` Richard Stallman
  0 siblings, 0 replies; 6+ messages in thread
From: Richard Stallman @ 2014-07-13 21:54 UTC (permalink / raw)
  To: Drew Adams; +Cc: 18005

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

    "The whole point" should be to _let_ users not be bothered entering
    the debugger for uninteresting errors.  That's reasonable behavior.
    *Enabling* that behavior is positive.  Forcing it would be
    counterproductive, as is not making clear what it is that controls it.

I agree.

    Not to mention the fact that what constitutes an "uninteresting
    error" is not something fixed once and for all for everyone.  It
    can change, depending on the context.  A user might well want to
    take a look under the covers using the debugger in some context.
    (The user who just now asked how to do it, for instance.)

I have several times wanted to enter the debugger because a
program triggered one of these errors which usually is caused by
bad user input.  So I used the feature to enable that.

There should continue to be a convenient feature to enable that.

-- 
Dr Richard Stallman
President, Free Software Foundation
51 Franklin St
Boston MA 02110
USA
www.fsf.org  www.gnu.org
Skype: No way! That's nonfree (freedom-denying) software.
  Use Ekiga or an ordinary phone call.






^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#18005: 24.4.50; In Emacs manual, tell users how to enter debugger for `user-error' errors
  2014-07-12 17:59 bug#18005: 24.4.50; In Emacs manual, tell users how to enter debugger for `user-error' errors Drew Adams
  2014-07-13  1:35 ` Glenn Morris
@ 2016-04-29 21:51 ` Lars Ingebrigtsen
  2016-04-29 22:53   ` Drew Adams
  1 sibling, 1 reply; 6+ messages in thread
From: Lars Ingebrigtsen @ 2016-04-29 21:51 UTC (permalink / raw)
  To: Drew Adams; +Cc: 18005

Drew Adams <drew.adams@oracle.com> writes:

> The only hint about how to make Emacs enter the debugger for errors
> deemed `user-error' is this mention, buried in the
> `debug-ignored-errors' entry of the Elisp manual:
>
>      The normal value of this variable includes `user-error', as well
>      as several errors that happen often during editing but rarely
>      result from bugs in Lisp programs.  However, "rarely" is not
>      "never"; if your program fails with an error that matches this
>      list, you may try changing this list to debug the error.  The
>      easiest way is usually to set `debug-ignored-errors' to `nil'.
>
> (FWIW, wrt this text: Is it really necessary to point out that
> users can want to enter the debugger for other reasons that
> tracking down a Lisp bug?)
>
> It should be made *obvious* to users, in the *Emacs* manual, how to make
> the debugger open for so-called "user errors".

I think this belongs in the elisp manual, and the explanation there is
fine.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





^ permalink raw reply	[flat|nested] 6+ messages in thread

* bug#18005: 24.4.50; In Emacs manual, tell users how to enter debugger for `user-error' errors
  2016-04-29 21:51 ` Lars Ingebrigtsen
@ 2016-04-29 22:53   ` Drew Adams
  0 siblings, 0 replies; 6+ messages in thread
From: Drew Adams @ 2016-04-29 22:53 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 18005

> > The only hint about how to make Emacs enter the debugger for errors
> > deemed `user-error' is this mention, buried in the
> > `debug-ignored-errors' entry of the Elisp manual:
> >
> >      The normal value of this variable includes `user-error', as well
> >      as several errors that happen often during editing but rarely
> >      result from bugs in Lisp programs.  However, "rarely" is not
> >      "never"; if your program fails with an error that matches this
> >      list, you may try changing this list to debug the error.  The
> >      easiest way is usually to set `debug-ignored-errors' to `nil'.
> >
> > (FWIW, wrt this text: Is it really necessary to point out that
> > users can want to enter the debugger for other reasons that
> > tracking down a Lisp bug?)
> >
> > It should be made *obvious* to users, in the *Emacs* manual, how to make
> > the debugger open for so-called "user errors".
> 
> I think this belongs in the elisp manual, and the explanation there is
> fine.

I disagree (like RMS).  How to enter the debugger, including for
"user" errors, is not information we should bury.  It should be
mentioned in the Emacs manual, with a link to the Elisp manual
for more info.





^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2016-04-29 22:53 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-07-12 17:59 bug#18005: 24.4.50; In Emacs manual, tell users how to enter debugger for `user-error' errors Drew Adams
2014-07-13  1:35 ` Glenn Morris
2014-07-13  2:41   ` Drew Adams
2014-07-13 21:54     ` Richard Stallman
2016-04-29 21:51 ` Lars Ingebrigtsen
2016-04-29 22:53   ` Drew Adams

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).