2 files changed, 8 insertions, 2 deletions

diff --git a/src/ChangeLog b/src/ChangeLog
index 949ea741e1d..829eb25f4d9 100644
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,7 @@
+2015-01-30  Eli Zaretskii  <eliz@gnu.org>
+
+        * dispextern.h (FACE_FOR_CHAR): Fix the commentary.
+
 2015-01-29  Hans Wennborg  <hwennborg@google.com>  (tiny change)
 
         * emacs.c (decode_env_path): Add parentheses around ternary
diff --git a/src/dispextern.h b/src/dispextern.h
index d6bbb0b4c6c..239c4425646 100644
--- a/src/dispextern.h
+++ b/src/dispextern.h
@@ -1821,8 +1821,10 @@ struct face_cache
   ((FACE) == (FACE)->ascii_face)
 
 /* Return the id of the realized face on frame F that is like the face
-   with id ID but is suitable for displaying character CHAR.
-   This macro is only meaningful for multibyte character CHAR.  */
+   FACE, but is suitable for displaying character CHAR at buffer or
+   string position POS.  OBJECT is the string object, or nil for
+   buffer.  This macro is only meaningful for multibyte character
+   CHAR.  */
 
 #define FACE_FOR_CHAR(F, FACE, CHAR, POS, OBJECT)       \
   face_for_char ((F), (FACE), (CHAR), (POS), (OBJECT))