Elisp manual: Note that created faces cannot be removed.

[Alan Mackenzie <acm@muc.de>]

Hello, Emacs.

It transpires that once a face has been created by defface, it cannot
then be removed.  This is not mentioned in the Elisp manual, despite this
non removeability being exceptionally rare in Emacs.

So I propose the following patch, which is surely(?) uncontroversial:


diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 276d60b21a..22b7eb0bd1 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2476,6 +2476,9 @@ Defining Faces
 usual procedure is to define a face with @code{defface}, and then use
 its name directly.
 
+Note that once you have defined a face with @code{defface}, you cannot
+later remove this face 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},


.  Is it too late to push this patch to Emacs 26, or does the rule about
documentation changes being OK still hold?

-- 
Alan Mackenzie (Nuremberg, Germany).