Document `inhibit-message' and fix the NEWS entryscratch/inhibit-message3

2 files changed, 11 insertions, 5 deletions

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index b39c3193074..f86149d613c 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -257,8 +257,8 @@ text properties (@pxref{Logging Messages}).
 In batch mode, the message is printed to the standard error stream,
 followed by a newline.
 
-When @code{inhibit-message} is @code{t}, no message will be displayed
-in the echo area, it will only be logged to @file{*Messages*}.
+When @code{inhibit-message} is non-nil, no message will be displayed
+in the echo area, it will only be logged to @samp{*Messages*}.
 
 If @var{format-string} is @code{nil} or the empty string,
 @code{message} clears the echo area; if the echo area has been
@@ -285,6 +285,11 @@ To automatically display a message in the echo area or in a pop-buffer,
 depending on its size, use @code{display-message-or-buffer} (see below).
 @end defun
 
+@defvar inhibit-message
+When this variable is non-nil, @code{message} and related functions
+will not use the Echo Area to display messages.
+@end defvar
+
 @defmac with-temp-message message &rest body
 This construct displays a message in the echo area temporarily, during
 the execution of @var{body}.  It displays @var{message}, executes
diff --git a/etc/NEWS b/etc/NEWS
index c5c128097a4..e2b6b11b103 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -200,9 +200,10 @@ font, and (iii) the specified window.
 
 ** New possible value for `system-type': nacl.
 
-** New variable `inhibit-message', when bound to t, inhibits the
-   message3 C function from using the Echo Area. The output is still
-   logged to the *Messages* buffer.
++++
+** New variable `inhibit-message', when bound to non-nil, inhibits
+   `message' and related functions from displaying messages the Echo
+   Area.  The output is still logged to the *Messages* buffer.
 
 
 * Editing Changes in Emacs 25.1