From: Glenn Morris <rgm@gnu.org>
Date: Tue, 1 Sep 2009 02:54:16 +0000 (+0000)
Subject: (Face Functions): Mention define-obsolete-face-alias.
X-Git-Tag: emacs-pretest-23.1.90~1551
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e7e2f529e489cd4939e86012cfeed6b27ba77d99;p=emacs.git

(Face Functions): Mention define-obsolete-face-alias.
---

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index eb6012d102d..61ec1e9ee30 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -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 --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index b2282b456b8..d1f44352a99 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2629,6 +2629,12 @@ makes @code{modeline} an alias for the @code{mode-line} face.
 (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