summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2019-04-06 10:16:16 +0300
committerEli Zaretskii <eliz@gnu.org>2019-04-06 10:16:16 +0300
commit6dc42c562c5ae3ca5a7d7eb4223cd82554e3cfad (patch)
tree9fc76b2ae152c08e3a678b47cddd8c7da3164b7e
parenta8cffcf27f4d4f7e35462e2ccb011d231f1a61cc (diff)
downloademacs-6dc42c562c5ae3ca5a7d7eb4223cd82554e3cfad.tar.gz
Improve commentary in frame.el
* lisp/frame.el: Improve commentary for display-* functions. (Bug#35058)
-rw-r--r--lisp/frame.el8
1 files changed, 8 insertions, 0 deletions
diff --git a/lisp/frame.el b/lisp/frame.el
index 9438b4a72ed..a0e62e1d69d 100644
--- a/lisp/frame.el
+++ b/lisp/frame.el
@@ -1691,6 +1691,14 @@ for FRAME."
;;;; Frame/display capabilities.
+;; These functions should make the features they test explicit in
+;; their names, so that when capabilities or the corresponding Emacs
+;; features change, it will be easy to find all the tests for such
+;; capabilities by a simple text search. See more about the history
+;; and the intent of these functions in
+;; http://lists.gnu.org/archive/html/bug-gnu-emacs/2019-04/msg00004.html
+;; or in https://debbugs.gnu.org/cgi/bugreport.cgi?bug=35058#17.
+
(declare-function msdos-mouse-p "dosfns.c")
(defun display-mouse-p (&optional display)