GNU bug report logs - #14238
[PATCH] Help page for character description forgets the character

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 14238 in the body.
You can then email your comments to 14238 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: Kelly Dean <kellydeanch <at> yahoo.com>
To: bug-gnu-emacs <at> gnu.org
Subject: [PATCH] Help page for character description forgets the character
Date: Sun, 21 Apr 2013 04:38:21 -0700 (PDT)

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

On 24.3, emacs -Q
Type the letters AB, then put point on A. Do describe-char, then put point on B, and do describe-char again.
Change the A to C, the press [back] in *Help*.
The help page is now for C, not for A. It should be for A; you never did describe-char on C.
The attached descharbug.patch fixes it.

[descharbug.patch (text/x-diff, attachment)]

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

From: Stefan Monnier <monnier <at> iro.umontreal.ca>
To: Kelly Dean <kellydeanch <at> yahoo.com>
Cc: 14238 <at> debbugs.gnu.org
Subject: Re: bug#14238: [PATCH] Help page for character description forgets
	the character
Date: Mon, 22 Apr 2013 10:26:15 -0400

> On 24.3, emacs -Q
> Type the letters AB, then put point on A. Do describe-char, then put point
> on B, and do describe-char again.
> Change the A to C, the press [back] in *Help*.
> The help page is now for C, not for A. It should be for A; you never did describe-char on C.

Not sure if it is really a bug: while the name is "describe-char" what
it does is more like "describe-pos" (and indeed it receives a position
rather than a char as argument).

So when you "back" you ask to redisplay the info about the pos where
A used to be (and where C is now instead).

The data stored with `help-setup-xref' is also used for `revert-buffer'
which lets you refresh the description after the buffer was modified.


        Stefan

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

From: Kelly Dean <kellydeanch <at> yahoo.com>
To: 14238 <at> debbugs.gnu.org
Cc: monnier <at> iro.umontreal.ca
Subject: Re: bug#14238: [PATCH] Help page for character description forgets
	the character
Date: Fri, 26 Apr 2013 14:01:42 -0700 (PDT)

--- On Mon, 4/22/13, Stefan Monnier <monnier <at> iro.umontreal.ca> wrote:
> Not sure if it is really a bug: while the name is
> "describe-char" what
> it does is more like "describe-pos" (and indeed it receives
> a position
> rather than a char as argument).
> 
> So when you "back" you ask to redisplay the info about the
> pos where
> A used to be (and where C is now instead).
> 
> The data stored with `help-setup-xref' is also used for
> `revert-buffer'
> which lets you refresh the description after the buffer was
> modified.

Put point on a function name, and do C-h f RET, then again on another function name. Then delete the first function name and type a new one, and do back in the help buffer. The documentation for the original first function name is displayed, not for the new one. Surely Emacs's behavior in this case is correct. Why then is it correct for describe-char to follow changes in the source buffer, if describe-function doesn't? I don't see how it's a useful feature. All it does it cause problems: one, after browsing a series of help pages, you go back to review the character description you looked at, and it's gone; two, there's an unexpected character description in your history, and you're left futilely trying to remember why you looked up the description for that character.

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

From: Stefan Monnier <monnier <at> iro.umontreal.ca>
To: Kelly Dean <kellydeanch <at> yahoo.com>
Cc: 14238 <at> debbugs.gnu.org
Subject: Re: bug#14238: [PATCH] Help page for character description forgets
	the character
Date: Sat, 27 Apr 2013 00:19:47 -0400

> this case is correct. Why then is it correct for describe-char to follow
> changes in the source buffer, if describe-function doesn't?

That's the wrong comparison.  As mentioned `describe-char' is the wrong
name, since what the function does is `describe-pos'.  In contrast
`describe-function' really describes a function and not just "the
function at point" (although the function at point is the one that's
provided as default in the minibuffer).

> I don't see how it's a useful feature.

I've used it to monitor changes to the position's overlays and
text-properties.


        Stefan

Previous Next

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