From: Alan Mackenzie <acm@muc.de>
Date: Mon, 22 Jul 2019 14:57:41 +0000 (+0000)
Subject: * doc/lispref/display.texi (Defining Faces): Say a face can't be undefined.
X-Git-Tag: emacs-26.3~38
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=0592467;p=emacs.git

* doc/lispref/display.texi (Defining Faces): Say a face can't be undefined.
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 276d60b21a7..9eb406b3c6a 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2476,6 +2476,11 @@ face name.  In the vast majority of cases, this is not necessary; the
 usual procedure is to define a face with @code{defface}, and then use
 its name directly.
 
+@cindex face (non-removability of)
+Note that once you have defined a face (usually with @code{defface}),
+you cannot later undefine this face safely, except by restarting
+Emacs.
+
 @defmac defface face spec doc [keyword value]@dots{}
 This macro declares @var{face} as a named face whose default face spec
 is given by @var{spec}.  You should not quote the symbol @var{face},