Re: tooltip-mode = nil only displays first line of multi-line text-properties or overlays

[M Jared Finder]

Richard Stallman wrote:
> I think this is intentional.  Changing the height of the echo area
> as you move the mouse would be rather unpleasant.
>
> It could combine the tooltip string lines, and display as much text as
> will fit in the echo area.  Would that be better?

If this is intentional, the documentation for tooltip-mode should be 
changed (as well as the info page on tooltips).  With it's current 
wording, it sounds like disabling tooltip-mode is the only way to 
display help text in the echo area.

I suggest changing the doc to something that mentions tooltip-use-echo-area:
"When this minor mode is enabled, Emacs displays help text in a pop-up 
window on mouse-over.  When it is disabled, Emacs displays the first 
line of help text in the echo area instead.

See `tooltip-use-echo-area' for displaying multi-line help text."

And chage tooltip-use-echo-area to mention this usage:
"Use the echo area instead of tooltip frames for help and GUD tooltips.

Enabling `tooltip-mode' with this is the *only* way to display 
multi-line help text in the echo area."

I never would have found tooltip-use-echo-area if Nick had not mentioned it.

  -- MJF