[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).
- Elisp manual: Note that created faces cannot be removed.,
Alan Mackenzie <=
- Re: Elisp manual: Note that created faces cannot be removed., Eli Zaretskii, 2019/07/20
- Re: Elisp manual: Note that created faces cannot be removed., Eli Zaretskii, 2019/07/20
- Re: Elisp manual: Note that created faces cannot be removed., Alan Mackenzie, 2019/07/20
- Re: Elisp manual: Note that created faces cannot be removed., Eli Zaretskii, 2019/07/20
- Re: Elisp manual: Note that created faces cannot be removed., Alan Mackenzie, 2019/07/22
- Re: Elisp manual: Note that created faces cannot be removed., Eli Zaretskii, 2019/07/22
- Re: Elisp manual: Note that created faces cannot be removed., Alan Mackenzie, 2019/07/22