(Fface_attribute_relative_p): Doc fix.

1 files changed, 8 insertions, 1 deletions

diff --git a/src/xfaces.c b/src/xfaces.c
index df303e401fd..30e1c7aa5dc 100644
--- a/src/xfaces.c
+++ b/src/xfaces.c
@@ -4799,7 +4799,14 @@ x_update_menu_appearance (f)
 DEFUN ("face-attribute-relative-p", Fface_attribute_relative_p,
        Sface_attribute_relative_p,
        2, 2, 0,
-       doc: /* Return non-nil if face ATTRIBUTE VALUE is relative.  */)
+       doc: /* Check whether a face attribute value is relative.
+Specifically, this function returns t if the attribute ATTRIBUTE
+with the value VALUE is relative.
+
+A relative value is one that doesn't entirely override whatever is
+inherited from another face.  For most possible attributes,
+the only relative value that users see is `unspecified'.
+However, for :height, floating point values are also relative.  */)
      (attribute, value)
      Lisp_Object attribute, value;
 {