# HG changeset patch
# User Glenn Morris <rgm@gnu.org>
# Date 1251773656 0
# Node ID b5e40c2f5b4df5d7fc368ac30c8561718c3d9744
# Parent  a1561ebb9019756d8cec11aaf1916a63c2754f90
(Face Functions): Mention define-obsolete-face-alias.

diff -r a1561ebb9019 -r b5e40c2f5b4d doc/lispref/ChangeLog
--- a/doc/lispref/ChangeLog	Mon Aug 31 18:11:43 2009 +0000
+++ b/doc/lispref/ChangeLog	Tue Sep 01 02:54:16 2009 +0000
@@ -1,3 +1,7 @@
+2009-09-01  Glenn Morris  <rgm@gnu.org>
+
+	* display.texi (Face Functions): Mention define-obsolete-face-alias.
+
 2009-08-26  Ulrich Mueller  <ulm@gentoo.org>
 
 	* nonascii.texi (Character Codes): Fix typos.
diff -r a1561ebb9019 -r b5e40c2f5b4d doc/lispref/display.texi
--- a/doc/lispref/display.texi	Mon Aug 31 18:11:43 2009 +0000
+++ b/doc/lispref/display.texi	Tue Sep 01 02:54:16 2009 +0000
@@ -2629,6 +2629,12 @@
 (put 'modeline 'face-alias 'mode-line)
 @end example
 
+@defun define-obsolete-face-alias obsolete-face current-face &optional when
+This function defines a face alias and marks it as obsolete, indicating
+that it may be removed in future.  The optional string @var{when}
+indicates when the face was made obsolete (for example, a release number).
+@end defun
+
 @node Auto Faces
 @subsection Automatic Face Assignment
 @cindex automatic face assignment