Re: show_help_echo truncates unconditionally

[Stephan Stahl]

Hi Richard.

Richard Stallman said:
> Could someone please clarify the comment based on this?
> The existing comment was not written with a view to making
> it clear to people who don't already know.

Would this change be clear enough?

diff -c "keyboard.c" "/tmp/buffer-content-86723hP"
*** keyboard.c Fri Apr  1 09:28:54 2005
--- /tmp/buffer-content-86723hP Fri Apr  1 09:29:59 2005
***************
*** 2258,2264 ****
    return c;
  }

! /* Display help echo in the echo area.

     HELP a string means display that string, HELP nil means clear the
     help echo.  If HELP is a function, call it with OBJECT and POS as
--- 2258,2266 ----
    return c;
  }

! /* Display help-echo property under the mouse pointer.  Either show it
!    in the echo area or when non-nil call show-help-function to display
!    it by other means (maybe in tooltips).

     HELP a string means display that string, HELP nil means clear the
     help echo.  If HELP is a function, call it with OBJECT and POS as

Diff finished.  Fri Apr 01 09:30:00 2005

PS: Some lines down this comment it says:
   and POS is the position in the overlay's buffer under the mouse.
Is "under the mouse" correct?  I'm no native english speaker so i'm not
sure..  Just in case it is wrong:

diff -c "keyboard.c" "/tmp/buffer-content-8672eTM"
*** keyboard.c Fri Apr  1 09:28:54 2005
--- /tmp/buffer-content-8672eTM Fri Apr  1 09:36:37 2005
***************
*** 2272,2282 ****
     `help-echo' text property was found.

     If OBJECT is an overlay, that overlay has a `help-echo' property,
!    and POS is the position in the overlay's buffer under the mouse.

     If OBJECT is a string (an overlay string or a string displayed with
     the `display' property).  POS is the position in that string under
!    the mouse.

     OK_TO_OVERWRITE_KEYSTROKE_ECHO non-zero means it's okay if the help
     echo overwrites a keystroke echo currently displayed in the echo
--- 2272,2283 ----
     `help-echo' text property was found.

     If OBJECT is an overlay, that overlay has a `help-echo' property,
!    and POS is the position in the overlay's buffer under the mouse
!    pointer.

     If OBJECT is a string (an overlay string or a string displayed with
     the `display' property).  POS is the position in that string under
!    the mouse pointer.

     OK_TO_OVERWRITE_KEYSTROKE_ECHO non-zero means it's okay if the help
     echo overwrites a keystroke echo currently displayed in the echo

Diff finished.  Fri Apr 01 09:36:37 2005
-- 
Stephan Stahl