[Emacs-diffs] Changes to emacs/lispref/display.texi,v

[Richard M. Stallman]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Richard M. Stallman <rms>       06/07/05 17:05:41

Index: display.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/display.texi,v
retrieving revision 1.224
retrieving revision 1.225
diff -u -b -r1.224 -r1.225
--- display.texi        5 Jul 2006 14:13:23 -0000       1.224
+++ display.texi        5 Jul 2006 17:05:41 -0000       1.225
@@ -2116,9 +2116,22 @@
 
 @tindex face-attribute-relative-p
 @defun face-attribute-relative-p attribute value
-This function returns address@hidden 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 address@hidden 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.
+
address@hidden is a relative value for all attributes.
+For @code{:height}, floating point values are also relative.
+
+For example:
+
address@hidden
+(read-face-name "Describe face" "= `default' face" t)
address@hidden example
+
+prompts with @samp{Describe face (default = `default' face): }.
 @end defun
 
 @tindex merge-face-attribute