From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: valid forms of face property: documentation bug, font-lock-{prepend, append}-text-property bug Date: Sat, 29 Dec 2007 20:36:21 -0500 Message-ID: References: <861wbezmpl.fsf@macs.hw.ac.uk> <86myruvvpo.fsf@macs.hw.ac.uk> Reply-To: rms@gnu.org NNTP-Posting-Host: lo.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: ger.gmane.org 1198978655 4429 80.91.229.12 (30 Dec 2007 01:37:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 30 Dec 2007 01:37:35 +0000 (UTC) Cc: emacs-devel@gnu.org To: Joe Wells Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 30 02:37:49 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1J8n7Z-0000Si-3F for ged-emacs-devel@m.gmane.org; Sun, 30 Dec 2007 02:37:45 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J8n7D-0005J4-QS for ged-emacs-devel@m.gmane.org; Sat, 29 Dec 2007 20:37:23 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1J8n6G-0004mV-Lv for emacs-devel@gnu.org; Sat, 29 Dec 2007 20:36:24 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1J8n6F-0004lM-3a for emacs-devel@gnu.org; Sat, 29 Dec 2007 20:36:24 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J8n6E-0004lH-On for emacs-devel@gnu.org; Sat, 29 Dec 2007 20:36:22 -0500 Original-Received: from fencepost.gnu.org ([140.186.70.10]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1J8n6E-0003p0-KF for emacs-devel@gnu.org; Sat, 29 Dec 2007 20:36:22 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.60) (envelope-from ) id 1J8n6D-0003io-PC; Sat, 29 Dec 2007 20:36:21 -0500 In-reply-to: <86myruvvpo.fsf@macs.hw.ac.uk> (message from Joe Wells on Sat, 29 Dec 2007 06:52:35 +0000) X-detected-kernel: by monty-python.gnu.org: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:85651 Archived-At: Your proposal seems pretty good to me. I've written text to document it; what do you think? Meanwhile, I fixed the code in facemenu and startup that generated other formats. In the simplest case, the value is a face name. It can also be a list; then each element can be any of these possibilities; @itemize @bullet @item A face name (a symbol or string). @item A property list of face attributes. This has the form (@var{keyword} @var{value} @dots{}), where each @var{keyword} is a face attribute name and @var{value} is a meaningful value for that attribute. With this feature, you do not need to create a face each time you want to specify a particular attribute for certain text. @xref{Face Attributes}. @item A cons cell with the form @code{(foreground-color . @var{color-name})} or @code{(background-color . @var{color-name})}. These are older, deprecated equivalents for @code{(:foreground @var{color-name})} and @code{(:background @var{color-name})}. Please convert code that uses them. @end itemize It works to use the latter two forms directly as the value of the @code{face} property.