From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#1375: 23.0.60; Elisp manual node Special Properties Date: Tue, 18 Nov 2008 22:55:37 -0800 Message-ID: <000001c94a13$d4734d10$0200a8c0@us.oracle.com> Reply-To: Drew Adams , 1375@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1227078630 28294 80.91.229.12 (19 Nov 2008 07:10:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 19 Nov 2008 07:10:30 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Nov 19 08:11:31 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1L2hDm-00070a-Rn for geb-bug-gnu-emacs@m.gmane.org; Wed, 19 Nov 2008 08:11:31 +0100 Original-Received: from localhost ([127.0.0.1]:36153 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L2hCe-0007uk-3p for geb-bug-gnu-emacs@m.gmane.org; Wed, 19 Nov 2008 02:10:20 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L2hCZ-0007sE-NK for bug-gnu-emacs@gnu.org; Wed, 19 Nov 2008 02:10:15 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L2hCW-0007os-FF for bug-gnu-emacs@gnu.org; Wed, 19 Nov 2008 02:10:15 -0500 Original-Received: from [199.232.76.173] (port=60688 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L2hCW-0007oV-8s for bug-gnu-emacs@gnu.org; Wed, 19 Nov 2008 02:10:12 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:51977) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L2hCV-0006BX-UA for bug-gnu-emacs@gnu.org; Wed, 19 Nov 2008 02:10:12 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAJ7A9n5003209; Tue, 18 Nov 2008 23:10:09 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id mAJ756ib001480; Tue, 18 Nov 2008 23:05:06 -0800 X-Loop: don@donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Wed, 19 Nov 2008 07:05:06 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 1375 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.122707774731758 (code B ref -1); Wed, 19 Nov 2008 07:05:06 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 19 Nov 2008 06:55:47 +0000 Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAJ6tiwH031750 for ; Tue, 18 Nov 2008 22:55:45 -0800 Original-Received: from mx10.gnu.org ([199.232.76.166]:39124) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1L2gyN-00044i-OG for emacs-pretest-bug@gnu.org; Wed, 19 Nov 2008 01:55:35 -0500 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1L2gyV-0004zi-2S for emacs-pretest-bug@gnu.org; Wed, 19 Nov 2008 01:55:43 -0500 Original-Received: from acsinet12.oracle.com ([141.146.126.234]:22926) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L2gyU-0004z3-Jv for emacs-pretest-bug@gnu.org; Wed, 19 Nov 2008 01:55:42 -0500 Original-Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mAJ6tNuE002785 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 19 Nov 2008 06:55:24 GMT Original-Received: from acsmt704.oracle.com (acsmt704.oracle.com [141.146.40.82]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mAJ6tbk5022713 for ; Wed, 19 Nov 2008 06:55:38 GMT Original-Received: from dradamslap1 (/141.144.52.6) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 19 Nov 2008 06:55:31 +0000 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AclKE9QKj0HuZknsRwOD+TiX/KhRzg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Source-IP: acsmt704.oracle.com [141.146.40.82] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090203.4923B865.013F:SCFSTAT928724,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Wed, 19 Nov 2008 02:10:15 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:22487 gmane.emacs.pretest.bugs:23370 Archived-At: The text says this: 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; * A face name (a symbol or string). * A property list of face attributes. This has the form (KEYWORD VALUE ...), where each KEYWORD is a face attribute name and 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. *Note Face Attributes::. * A cons cell with the form `(foreground-color . COLOR-NAME)' or `(background-color . COLOR-NAME)'. These are older, deprecated equivalents for `(:foreground COLOR-NAME)' and `(:background COLOR-NAME)'. Please convert code that uses them. It works to use the latter two forms directly as the value of the `face' property. The "latter two forms" in the last sentence seems to refer to the last two bullets. Is that right? And the first sentence above seems to refer to the first bullet, no? If so, then the last sentence and the first sentence together say that the `face' property can have any of the bullets as its value, no? If so, then all of this together says that a `face' property value can be any of the bullets or a list of any of the bullets. Isn't that right? If so, then that's what we should say, directly. The current text is a bit confusing. We start off saying it can be a face name or a list of any of the bullets. Then we end by (I think) saying that it can also be either of the last two bullets. But we already said it could be a face name (the first bullet). Unless there is some careful distinction being made here between the statement that it could be a face name (not described) or a face name which is a string or a symbol. I don't think that's the case, however. If it is, then that needs to be explained. Maybe it's just late and I'm misreading this and missing something, but it seems overly complicated for (what I think) it's saying. In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-11-08 on LENNART-69DE564 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include -fno-crossjumping'