From: Noam Postavsky <npostavs@gmail.com>
Date: Sat, 1 Apr 2017 21:54:26 +0000 (-0400)
Subject: * src/xdisp.c (vmessage, message): Clarify commentary.
X-Git-Tag: emacs-25.2~8
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=856ec9ffa1fb4ff7e992b25bb0614ae168d5531e;p=emacs.git

* src/xdisp.c (vmessage, message): Clarify commentary.
---

diff --git a/src/xdisp.c b/src/xdisp.c
index 9ecfb86401d..c6f85665232 100644
--- a/src/xdisp.c
+++ b/src/xdisp.c
@@ -10470,9 +10470,12 @@ message_with_string (const char *m, Lisp_Object string, bool log)
 /* Dump an informative message to the minibuf.  If M is 0, clear out
    any existing message, and let the mini-buffer text show through.
 
-   The message must be safe ASCII and the format must not contain ` or
-   '.  If your message and format do not fit into this category,
-   convert your arguments to Lisp objects and use Fmessage instead.  */
+   The message must be safe ASCII (because when Emacs is
+   non-interactive the message is sent straight to stderr without
+   encoding first) and the format must not contain ` or ' (because
+   this function does not account for `text-quoting-style').  If your
+   message and format do not fit into this category, convert your
+   arguments to Lisp objects and use Fmessage instead.  */
 
 static void ATTRIBUTE_FORMAT_PRINTF (1, 0)
 vmessage (const char *m, va_list ap)
@@ -10530,6 +10533,7 @@ vmessage (const char *m, va_list ap)
     }
 }
 
+/* See vmessage for restrictions on the text of the message.  */
 void
 message (const char *m, ...)
 {