From 6dc42c562c5ae3ca5a7d7eb4223cd82554e3cfad Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 6 Apr 2019 10:16:16 +0300 Subject: [PATCH] Improve commentary in frame.el * lisp/frame.el: Improve commentary for display-* functions. (Bug#35058) --- lisp/frame.el | 8 ++++++++ 1 file changed, 8 insertions(+) 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) -- 2.39.2