Subject: RE: [External] : bug#29805: 27.0; doc of `tooltip-resize-echo-area'

From: Drew Adams <[email-masked]>
Date: Sat, 23 Oct 2021 18:51:29 +0000

> What is unclear about it?  Drew thinks the doc string should say
> something about stand-alone minibuffer frames, but only Drew can
> explain why.  The doc string talks specifically about the echo-area,
> and about the situation where tooltips are shown in the echo-area; it
> says nothing about minibuffers or minibuffer-only frames.

Yes, it's about the echo area - only; not minibuffers.

As both I and Martin pointed out, resizing the echo area
means resizing the minibuffer area - same real estate.

The doc says that the echo area gets resized.  That
effect doesn't occur with a "minibuffer-only" frame.
The doc would be clearer if it said so.

Such a frame is as much "echo-area-only" as it is
"minibuffer-only".  A standalone "minibuffer" frame
also manifests the echo area - it's a frame for the
minibuffer AND the echo area.

Doc that tells you the echo area gets resized to show
all of the message text should also tell you that this
doesn't apply - the ECHO AREA is not resized - if the
echo area is the only thing in its frame (a so-called
minibuffer-only, or standalone-minibuffer, frame).

Saying that the doc shouldn't be fixed because it's
about the echo area and not about the minibuffer is
a deflection.  No one is saying that it's about the
minibuffer.

It's a minor bug.  But it should at least be obvious
what the (doc) problem is.