Add commentary for subtle aspect of frame.el

* lisp/frame.el: Explain why we use symbol-function when adding
watchers for certain variables that need to trigger redisplay.

diff --git a/lisp/frame.el b/lisp/frame.el
index 447413b325612e6fa0328f804f29c12ade31d0ff..29c31f41cb11cb63652b174ce1c71d2751ee2bf4 100644 (file)
--- a/lisp/frame.el
+++ b/lisp/frame.el
@@ -2475,6 +2475,9 @@ See also `toggle-frame-maximized'."
 ;; F5 then produces the correct effect, the variable doesn't need
 ;; to be in this list; otherwise, it does.
 (mapc (lambda (var)
+        ;; Using symbol-function here tells the watcher machinery to
+        ;; call the C function set-buffer-redisplay directly, thus
+        ;; avoiding a potential GC.
         (add-variable-watcher var (symbol-function 'set-buffer-redisplay)))
       '(line-spacing
         overline-margin