From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: Elisp manual: Note that created faces cannot be removed. Date: Sat, 20 Jul 2019 20:26:08 +0000 Message-ID: <20190720202608.GD27030@ACM> References: <20190720183715.GC27030@ACM> <83a7d8sg7w.fsf@gnu.org> <838ssssg4v.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="263021"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mutt/1.10.1 (2018-07-13) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jul 20 22:26:22 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hovvx-0016Iu-GW for ged-emacs-devel@m.gmane.org; Sat, 20 Jul 2019 22:26:21 +0200 Original-Received: from localhost ([::1]:53546 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hovvw-0005QK-2u for ged-emacs-devel@m.gmane.org; Sat, 20 Jul 2019 16:26:20 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51138) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hovvo-0005Pj-If for emacs-devel@gnu.org; Sat, 20 Jul 2019 16:26:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hovvn-0007DB-HB for emacs-devel@gnu.org; Sat, 20 Jul 2019 16:26:12 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:32014 helo=mail.muc.de) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1hovvn-0007CV-5a for emacs-devel@gnu.org; Sat, 20 Jul 2019 16:26:11 -0400 Original-Received: (qmail 60365 invoked by uid 3782); 20 Jul 2019 19:33:45 -0000 Original-Received: from acm.muc.de (p2E5D5FE3.dip0.t-ipconnect.de [46.93.95.227]) by colin.muc.de (tmda-ofmipd) with ESMTP; Sat, 20 Jul 2019 21:33:44 +0200 Original-Received: (qmail 30763 invoked by uid 1000); 20 Jul 2019 20:26:08 -0000 Content-Disposition: inline In-Reply-To: <838ssssg4v.fsf@gnu.org> X-Delivery-Agent: TMDA/1.1.12 (Macallan) X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 9.x [fuzzy] X-Received-From: 193.149.48.1 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:238754 Archived-At: Hello, Eli. On Sat, Jul 20, 2019 at 21:41:20 +0300, Eli Zaretskii wrote: > > Date: Sat, 20 Jul 2019 21:39:31 +0300 > > From: Eli Zaretskii > > Cc: emacs-devel@gnu.org > > > +Note that once you have defined a face with @code{defface}, you cannot > > > +later remove this face except by restarting Emacs. > > I think without some index entries leading to it, this sentence will > > be lost in the ocean of the information in the manual. Well, this page was the first one I scanned whilst seeking a remove-face function. > Also, defface is not the only way of defining a face, unlike what the > proposed text seems to imply. OK. How about this slightly amended patch? diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 276d60b21a..4ae0bba723 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -2476,6 +2476,10 @@ Defining Faces 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 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}, -- Alan Mackenzie (Nuremberg, Germany).