bug#38737: 26.3; Doc string of `files--message'

bug#38737: 26.3; Doc string of `files--message'

[Drew Adams]

Doc string:

"Like `message', except sometimes don't print to minibuffer.
If the variable `save-silently' is non-nil, the message is not
displayed on the minibuffer."

`message' does not "print to" the minibuffer or "display on" the
minibuffer.  It shows a message in the echo area.

Plus, it's not true that it sometimes does not show the message.  What
really happens is that the message is sometimes shown and then
immediately cleared - it is still logged in `*Messages*', for example.

The doc string should just say that if `save-silently' is non-nil then,
after showing the message in the echo area, it is cleared.



In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.17763
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

bug#38737: 26.3; Doc string of `files--message'

[Eli Zaretskii]

> Date: Tue, 24 Dec 2019 13:42:34 -0800 (PST)
> From: Drew Adams <drew.adams@oracle.com>
> 
> `message' does not "print to" the minibuffer or "display on" the
> minibuffer.  It shows a message in the echo area.

Thanks, I fixed the wording.

> Plus, it's not true that it sometimes does not show the message.  What
> really happens is that the message is sometimes shown and then
> immediately cleared - it is still logged in `*Messages*', for example.

"Don't show" doesn't imply "do nothing", so I see no problem here.

> The doc string should just say that if `save-silently' is non-nil then,
> after showing the message in the echo area, it is cleared.

That's a description of the implementation, so not useful: the source
is always available.  From the user POV I think the message is not
shown, because redisplay doesn't have an opportunity to kick in.