From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 2 Jun 2018 11:09:11 +0000 (+0300)
Subject: Improve documentation of 'inhibit-message'
X-Git-Tag: emacs-26.1.90~403
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9089b0239fbb4d658cc26523685f58e15a4d429a;p=emacs.git

Improve documentation of 'inhibit-message'

* src/xdisp.c (syms_of_xdisp) <inhibit-message>: Warn against
setting it non-nil globally.  (Bug#31627)
---

diff --git a/src/xdisp.c b/src/xdisp.c
index d28c1140678..5bce05c219e 100644
--- a/src/xdisp.c
+++ b/src/xdisp.c
@@ -32424,7 +32424,12 @@ syms_of_xdisp (void)
 
   DEFVAR_BOOL("inhibit-message", inhibit_message,
               doc:  /* Non-nil means calls to `message' are not displayed.
-They are still logged to the *Messages* buffer.  */);
+They are still logged to the *Messages* buffer.
+
+Do NOT set this globally to a non-nil value, as doing that will
+disable messages everywhere, including in I-search and other
+places where they are necessary.  This variable is intended to
+be let-bound around code that needs to disable messages temporarily. */);
   inhibit_message = 0;
 
   message_dolog_marker1 = Fmake_marker ();