From fd1fe1e1ecb6c68bbdea4bf071166779388174d0 Mon Sep 17 00:00:00 2001 From: Alan Mackenzie Date: Sat, 19 Sep 2020 16:50:27 +0000 Subject: Add doc to syntax-propertize-function saying it must do a 100% job and cannot be combined with other ways of applying syntax-table text properties. * lisp/emacs-lisp/syntax.el (syntax-propertize-function): Amend doc string. * doc/lispref/syntax.texi (Syntax Properties): Amend the description of the variable. --- lisp/emacs-lisp/syntax.el | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'lisp/emacs-lisp/syntax.el') diff --git a/lisp/emacs-lisp/syntax.el b/lisp/emacs-lisp/syntax.el index 11cc1988b1f..f4f077264be 100644 --- a/lisp/emacs-lisp/syntax.el +++ b/lisp/emacs-lisp/syntax.el @@ -65,7 +65,12 @@ cannot be handled just by the buffer's syntax-table. The specified function may call `syntax-ppss' on any position before END, but it should not call `syntax-ppss-flush-cache', which means that it should not call `syntax-ppss' on some -position and later modify the buffer on some earlier position.") +position and later modify the buffer on some earlier position. + +Note: When this variable is a function, it must apply _all_ the +`syntax-table' properties needed in the given text interval. +Using both this function and other means to apply these +properties won't work properly.") (defvar syntax-propertize-chunk-size 500) -- cgit v1.2.3