Comment.

diff --git a/lisp/font-lock.el b/lisp/font-lock.el
index 3f81de0b144d23162f1167f78bff93905a20ff59..dc1af6c61d713f804668cc275d455c43b56552dd 100644 (file)
--- a/lisp/font-lock.el
+++ b/lisp/font-lock.el
@@ -288,6 +288,11 @@ If a number, only buffers greater than this size have fontification messages."
 ;; We now allow a FACENAME in `font-lock-keywords' to be any expression that
 ;; returns a face.  So the easiest thing is to continue using these variables,
 ;; rather than sometimes evaling FACENAME and sometimes not.  sm.
+
+;; Note that in new code, in the vast majority of cases there is no
+;; need to create variables that specify face names.  Simply using
+;; faces directly is enough.  Font-lock is not a template to be
+;; followed in this area.
 (defvar font-lock-comment-face         'font-lock-comment-face
   "Face name to use for comments.")