unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* Elisp manual: Note that created faces cannot be removed.
@ 2019-07-20 18:37 Alan Mackenzie
  2019-07-20 18:39 ` Eli Zaretskii
  0 siblings, 1 reply; 8+ messages in thread
From: Alan Mackenzie @ 2019-07-20 18:37 UTC (permalink / raw)
  To: emacs-devel

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



^ permalink raw reply related	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2019-07-22 15:18 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2019-07-20 18:37 Elisp manual: Note that created faces cannot be removed Alan Mackenzie
2019-07-20 18:39 ` Eli Zaretskii
2019-07-20 18:41   ` Eli Zaretskii
2019-07-20 20:26     ` Alan Mackenzie
2019-07-21  2:28       ` Eli Zaretskii
2019-07-22 10:02         ` Alan Mackenzie
2019-07-22 14:33           ` Eli Zaretskii
2019-07-22 15:18             ` Alan Mackenzie

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).