Mercurial > emacs
changeset 71643:e712aec3ce09
(Attribute Functions): Add examples for face-attribute-relative-p.
| author | Richard M. Stallman <rms@gnu.org> |
|---|---|
| date | Wed, 05 Jul 2006 17:05:41 +0000 |
| parents | fa9d190c602e |
| children | ac52c6d8a154 |
| files | lispref/display.texi |
| diffstat | 1 files changed, 16 insertions(+), 3 deletions(-) [+] |
line wrap: on
line diff
--- 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