summaryrefslogtreecommitdiff
path: root/lisp/emacs-lisp/syntax.el
diff options
context:
space:
mode:
authorAlan Mackenzie <acm@muc.de>2020-09-19 16:50:27 +0000
committerAlan Mackenzie <acm@muc.de>2020-09-19 16:50:27 +0000
commitfd1fe1e1ecb6c68bbdea4bf071166779388174d0 (patch)
tree09a3fd5aeba4b410a528b8e74ccd82175aaa1e38 /lisp/emacs-lisp/syntax.el
parentfcd599bbeaac84113379dedbff4e59910e10e171 (diff)
downloademacs-fd1fe1e1ecb6c68bbdea4bf071166779388174d0.tar.gz
emacs-fd1fe1e1ecb6c68bbdea4bf071166779388174d0.tar.bz2
emacs-fd1fe1e1ecb6c68bbdea4bf071166779388174d0.zip
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.
Diffstat (limited to 'lisp/emacs-lisp/syntax.el')
-rw-r--r--lisp/emacs-lisp/syntax.el7
1 files changed, 6 insertions, 1 deletions
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)