[Emacs-diffs] emacs-26 6dc42c5: Improve commentary in frame.el

[Eli Zaretskii]

branch: emacs-26
commit 6dc42c562c5ae3ca5a7d7eb4223cd82554e3cfad
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    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 9438b4a..a0e62e1 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)