[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Elisp manual: Note that created faces cannot be removed.

From: Alan Mackenzie
Subject: Elisp manual: Note that created faces cannot be removed.
Date: Sat, 20 Jul 2019 18:37:15 +0000
User-agent: Mutt/1.10.1 (2018-07-13)

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).

reply via email to

[Prev in Thread] Current Thread [Next in Thread]