From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "John S. Yates, Jr." Newsgroups: gmane.emacs.devel Subject: Re: doc string for face-attribute-relative-p doesn't help Date: Mon, 26 Jun 2006 07:13:37 -0400 Message-ID: References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: sea.gmane.org 1151319016 20968 80.91.229.2 (26 Jun 2006 10:50:16 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 26 Jun 2006 10:50:16 +0000 (UTC) Cc: rms@gnu.org, Drew Adams , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jun 26 12:50:11 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FuofM-0000gJ-Ut for ged-emacs-devel@m.gmane.org; Mon, 26 Jun 2006 12:50:05 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FuofM-0002JJ-CE for ged-emacs-devel@m.gmane.org; Mon, 26 Jun 2006 06:50:04 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Fuoem-00023o-WB for emacs-devel@gnu.org; Mon, 26 Jun 2006 06:49:29 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Fuoek-00022w-QO for emacs-devel@gnu.org; Mon, 26 Jun 2006 06:49:28 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Fuoek-00022q-9J for emacs-devel@gnu.org; Mon, 26 Jun 2006 06:49:26 -0400 Original-Received: from [63.240.77.85] (helo=sccrmhc15.comcast.net) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FuoqY-0007UD-NQ; Mon, 26 Jun 2006 07:01:38 -0400 Original-Received: from mail.yates-sheets.org ([24.218.47.219]) by comcast.net (sccrmhc15) with SMTP id <20060626104920015009314be>; Mon, 26 Jun 2006 10:49:20 +0000 Original-Received: from 10.1.1.12 ([10.1.1.12]) by mail.yates-sheets.org (WinRoute Pro 4.2.5) with SMTP; Mon, 26 Jun 2006 07:13:37 -0400 Original-To: Miles Bader In-Reply-To: X-Mailer: Forte Agent 3.3/32.846 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:56190 Archived-At: Miles Bader writes: >Richard Stallman writes: >> Return non-nil if face ATTRIBUTE VALUE is relative. >> >> What does that mean? How is ATTRIBUTE VALUE a face? This is >> incomprehensible to me. >> >> I don't understand it either. Can someone explain? > >It returns non-nil if the face attribute ATTRIBUTE is relative when it >has value VALUE. "Relative" means that the value doesn't _override_ >that attribute of an underlying face during face merging, but rather >_modifies_ it. > >For most attributes the only value with that property is `unspecified'; >some attributes have other relative values (for instance, with :height, >floating-point numbers are relative, as they specify a scale value >rather than an absolute size). Might "Return non-nil if face ATTRIBUTE VALUE is derived from the inherited face." be clearer? /john