[Emacs-diffs] emacs-26 0592467: * doc/lispref/display.texi (Defining Faces): Say a face can't be undefined.

[Alan Mackenzie]

branch: emacs-26
commit 05924677f065c019bdbceeced995ae806f2e243c
Author: Alan Mackenzie <address@hidden>
Commit: Alan Mackenzie <address@hidden>

    * doc/lispref/display.texi (Defining Faces): Say a face can't be undefined.
---
 doc/lispref/display.texi | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 276d60b..9eb406b 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},