(Attribute Functions): Document `face-all-attributes'.

doc/lispref/ChangeLog

@@ -1,5 +1,7 @@
 2008-10-21  Eli Zaretskii  <eliz@gnu.org>
 
+	* display.texi (Attribute Functions): Document `face-all-attributes'.
+
 	* frames.texi (Color Names): Add an xref to `read-color'.
 
 	* minibuf.texi (High-Level Completion): Document `read-color'.

doc/lispref/display.texi

@@ -2217,6 +2217,15 @@ For example:
 @end example
 @end defun
 
+@defun face-all-attributes face &optional frame
+This function returns an alist of attributes of @var{face}.  The
+elements of the result are name-value pairs of the form
+@w{@code{(@var{attr-name} . @var{attr-value})}}.  Optional argument
+@var{frame} specifies the frame whose definition of @var{face} to
+return; if omitted or @code{nil}, the returned value describes the
+default attributes of @var{face} for newly created frames.
+@end defun
+
 @defun merge-face-attribute attribute value1 value2
 If @var{value1} is a relative value for the face attribute
 @var{attribute}, returns it merged with the underlying value

etc/NEWS

@@ -1595,9 +1595,11 @@ useful for modes such as tar-mode, archive-mode, RMAIL.
 +++
 *** `read-color' reads a color name using the minibuffer.
 
++++
 *** `face-all-attributes' returns an alist describing all the basic
 attributes of a given face.
 
++++
 *** `window-full-width-p' returns t if a window is as wide as its
 frame.