# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1152119141 0
# Node ID e712aec3ce09fcbea915d5433a30f639a656b0ac
# Parent  fa9d190c602e477e9e09a4b0c16305a653d81ebb
(Attribute Functions): Add examples for face-attribute-relative-p.

diff -r fa9d190c602e -r e712aec3ce09 lispref/display.texi
--- a/lispref/display.texi	Wed Jul 05 17:04:09 2006 +0000
+++ b/lispref/display.texi	Wed Jul 05 17:05:41 2006 +0000
@@ -2116,9 +2116,22 @@
 
 @tindex face-attribute-relative-p
 @defun face-attribute-relative-p attribute value
-This function returns non-@code{nil} if @var{value}, when used as
-the value of the face attribute @var{attribute}, is relative (that is,
-if it modifies an underlying or inherited value of @var{attribute}).
+This function returns non-@code{nil} if @var{value}, when used as the
+value of the face attribute @var{attribute}, is relative.  This means
+it would modify, rather than completely override, any value that comes
+from a subsequent face in the face list or that is inherited from
+another face.
+
+@code{unspecified} is a relative value for all attributes.
+For @code{:height}, floating point values are also relative.
+
+For example:
+
+@example
+(read-face-name "Describe face" "= `default' face" t)
+@end example
+
+prompts with @samp{Describe face (default = `default' face): }.
 @end defun
 
 @tindex merge-face-attribute