From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7774: 24.0.50; `frame-background-mode' Date: Sun, 2 Jan 2011 23:25:13 -0800 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1294041245 22234 80.91.229.12 (3 Jan 2011 07:54:05 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 3 Jan 2011 07:54:05 +0000 (UTC) To: 7774@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 03 08:53:55 2011 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.69) (envelope-from ) id 1PZfEo-00004u-Ox for geb-bug-gnu-emacs@m.gmane.org; Mon, 03 Jan 2011 08:53:55 +0100 Original-Received: from localhost ([127.0.0.1]:35079 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PZfEo-0005Kc-28 for geb-bug-gnu-emacs@m.gmane.org; Mon, 03 Jan 2011 02:53:54 -0500 Original-Received: from [140.186.70.92] (port=49897 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PZfEf-0005Hb-PR for bug-gnu-emacs@gnu.org; Mon, 03 Jan 2011 02:53:47 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PZfEe-0002Nv-CG for bug-gnu-emacs@gnu.org; Mon, 03 Jan 2011 02:53:45 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:57357) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PZfEe-0002Nr-9I for bug-gnu-emacs@gnu.org; Mon, 03 Jan 2011 02:53:44 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PZeh3-0003vI-Om; Mon, 03 Jan 2011 02:19:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 03 Jan 2011 07:19:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7774 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.129403911315042 (code B ref -1); Mon, 03 Jan 2011 07:19:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 3 Jan 2011 07:18:33 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PZega-0003uZ-Ta for submit@debbugs.gnu.org; Mon, 03 Jan 2011 02:18:33 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PZegZ-0003uO-Ak for submit@debbugs.gnu.org; Mon, 03 Jan 2011 02:18:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PZenQ-0007FC-Ax for submit@debbugs.gnu.org; Mon, 03 Jan 2011 02:25:37 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:35613) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PZenQ-0007F8-34 for submit@debbugs.gnu.org; Mon, 03 Jan 2011 02:25:36 -0500 Original-Received: from [140.186.70.92] (port=36745 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PZenO-0006x9-Qu for bug-gnu-emacs@gnu.org; Mon, 03 Jan 2011 02:25:35 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PZenN-0007EK-1u for bug-gnu-emacs@gnu.org; Mon, 03 Jan 2011 02:25:34 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:18137) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PZenM-0007Dx-Sz for bug-gnu-emacs@gnu.org; Mon, 03 Jan 2011 02:25:33 -0500 Original-Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p037PRnI012891 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 3 Jan 2011 07:25:29 GMT Original-Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153]) by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p0371xi0018883 for ; Mon, 3 Jan 2011 07:25:27 GMT Original-Received: from abhmt021.oracle.com by acsmt355.oracle.com with ESMTP id 923121421294039526; Sun, 02 Jan 2011 23:25:26 -0800 Original-Received: from dradamslap1 (/10.159.216.63) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 02 Jan 2011 23:25:25 -0800 X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 Thread-Index: AcurF1xNFSTfu8wxSmuhEPlcKpdwRA== X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Mon, 03 Jan 2011 02:19:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org 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:43032 Archived-At: emacs -Q There needs to be some explanation of `frame-background-mode' for users and for Emacs-Lisp programmers. First, the option is described briefly in the Elisp manual, but not in the Emacs manual. It is a _user_ option, and should be in the latter. Second, the (elisp) entry does not say what happens if the value is nil. The doc string does say that if it is nil then Emacs will "examine the brightness for you". That explanation of nil is incomprehensible and pretty useless for users, but it is especially useless for programmers. I had some code that tried to DTRT for a given color based on the `frame-background-mode'. I was incorrectly assuming that the value was set to `light' or `dark' automatically by Emacs ("examine the brightness for you") if it was not already set (customized) by the user. Now I guess I will need to call `frame-set-background-mode' if the value is nil, to determine the proper value. The doc should have helped here. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2010-12-20 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/imagesupport/include'