[Emacs-diffs] emacs-26 9089b02: Improve documentation of 'inhibit-message'

[Eli Zaretskii]

branch: emacs-26
commit 9089b0239fbb4d658cc26523685f58e15a4d429a
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve documentation of 'inhibit-message'
    
    * src/xdisp.c (syms_of_xdisp) <inhibit-message>: Warn against
    setting it non-nil globally.  (Bug#31627)
---
 src/xdisp.c | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/xdisp.c b/src/xdisp.c
index d28c114..5bce05c 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 ();