From 06b35b2f922150a11d6b4b5c68a40e9957a69e52 Mon Sep 17 00:00:00 2001
From: Noam Postavsky <npostavs@gmail.com>
Date: Tue, 25 Jun 2019 18:57:30 -0400
Subject: [PATCH] ; * lisp/frame.el: Enhance add-variable-watcher commentary.

---
 lisp/frame.el | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lisp/frame.el b/lisp/frame.el
index 30f6ca91ba6..6dc72669685 100644
--- a/lisp/frame.el
+++ b/lisp/frame.el
@@ -2489,7 +2489,9 @@ See also `toggle-frame-maximized'."
 (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.
+        ;; avoiding a potential GC.  This isn't strictly necessary,
+        ;; but it's a nice way to exercise the direct subr-calling
+        ;; machinery.
         (add-variable-watcher var (symbol-function 'set-buffer-redisplay)))
       '(line-spacing
         overline-margin
-- 
2.39.5