The `face-attribute-relative-p' Example?

The `face-attribute-relative-p' Example?

[Herbert Euler]

In the "Face Attribute Functions" section of Emacs Lisp Reference
Manual (info "(elisp) Attribute Functions"), `read-face-name' is used
as an example for `face-attribute-relative-p':

- Function: face-attribute-relative-p attribute value
     This function returns non-`nil' if VALUE, when used as the value
     of the face attribute 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.

     `unspecified' is a relative value for all attributes.  For
     `:height', floating point values are also relative.

     For example:

          (read-face-name "Describe face" "= `default' face" t)

     prompts with `Describe face (default = `default' face): '.

What is the relation between the example and the function?
If this example is correct, there should be a rationale at least,
i.m.o.

Regards,
Guanpeng Xu

_________________________________________________________________
Express yourself instantly with MSN Messenger! Download today it's FREE! 
http://messenger.msn.click-url.com/go/onm00200471ave/direct/01/

Re: The `face-attribute-relative-p' Example?

[Richard Stallman]

This text was garbled in editing.  I will fix it up.

Thanks.