(font-lock-extend-jit-lock-region-after-change): Better comment.

diff --git a/lisp/font-lock.el b/lisp/font-lock.el
index ab80316ae6a3f4dc60386532f47e777e9980d10e..b662a6735b0f68f59cd77ec74556585e5ed816d9 100644 (file)
--- a/lisp/font-lock.el
+++ b/lisp/font-lock.el
@@ -1196,6 +1196,10 @@ This function does 2 things:
       ;; it anyway.  Here OTOH we have no guarantee that
       ;; font-lock-default-fontify-region will be executed on this region
       ;; any time soon.
+      ;; Note: contrary to font-lock-default-fontify-region, we do not do
+      ;; any loop here because we are not looking for a safe spot: we just
+      ;; mark the text whose appearance may need to change as a result of
+      ;; the buffer modification.
       (when (and (> beg (point-min))
                  (get-text-property (1- beg) 'font-lock-multiline))
         (setq beg (or (previous-single-property-change