* src/syntax.c (char-syntax): Warn about ignoring text properties (Bug#22765).

1 files changed, 6 insertions, 1 deletions

diff --git a/src/syntax.c b/src/syntax.c
index 63866796188..e6a21e5433e 100644
--- a/src/syntax.c
+++ b/src/syntax.c
@@ -1087,7 +1087,12 @@ DEFUN ("char-syntax", Fchar_syntax, Schar_syntax, 1, 1, 0,
 For example, if CHARACTER is a word constituent, the
 character `w' (119) is returned.
 The characters that correspond to various syntax codes
-are listed in the documentation of `modify-syntax-entry'.  */)
+are listed in the documentation of `modify-syntax-entry'.
+
+If you're trying to determine the syntax of characters in the buffer,
+this is probably the wrong function to use, because it can't take
+`syntax-table' text properties into account.  Consider using
+`syntax-after' instead.  */)
   (Lisp_Object character)
 {
   int char_int;