From unknown Sat Jun 14 19:38:35 2025 X-Loop: help-debbugs@gnu.org Subject: bug#15226: 24.3; frame-background-mode docstring on not setq Resent-From: Kevin Ryde Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 31 Aug 2013 00:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 15226 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 15226@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.137790879713572 (code B ref -1); Sat, 31 Aug 2013 00:27:01 +0000 Received: (at submit) by debbugs.gnu.org; 31 Aug 2013 00:26:37 +0000 Received: from localhost ([127.0.0.1]:60234 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VFZ1Q-0003Wp-PA for submit@debbugs.gnu.org; Fri, 30 Aug 2013 20:26:37 -0400 Received: from eggs.gnu.org ([208.118.235.92]:57038) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VFZ1N-0003Wb-Nd for submit@debbugs.gnu.org; Fri, 30 Aug 2013 20:26:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VFZ1A-0003C7-Fq for submit@debbugs.gnu.org; Fri, 30 Aug 2013 20:26:28 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:58047) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFZ1A-0003C3-CZ for submit@debbugs.gnu.org; Fri, 30 Aug 2013 20:26:20 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:58667) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFZ13-00035q-EF for bug-gnu-emacs@gnu.org; Fri, 30 Aug 2013 20:26:20 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VFZ0w-00034s-4r for bug-gnu-emacs@gnu.org; Fri, 30 Aug 2013 20:26:13 -0400 Received: from mailout1-11.pacific.net.au ([125.255.80.130]:55975 helo=mailout3-syd3.pacific.net.au) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFZ0v-000323-JB for bug-gnu-emacs@gnu.org; Fri, 30 Aug 2013 20:26:06 -0400 Received: from mailproxy4-syd3.pacific.net.au (mailproxy4-syd3.pacific.net.au [61.8.2.162]) by mailout3-syd3.pacific.net.au (Postfix) with ESMTP id 5836A394547 for ; Sat, 31 Aug 2013 10:25:50 +1000 (EST) Received: from blah.blah (unknown [203.26.175.75]) by mailproxy4-syd3.pacific.net.au (Postfix) with ESMTP id 558264B4004 for ; Sat, 31 Aug 2013 10:25:49 +1000 (EST) Received: from gg by blah.blah with local (Exim 4.80) (envelope-from ) id 1VFZ0r-0007J8-Ga for bug-gnu-emacs@gnu.org; Sat, 31 Aug 2013 10:26:01 +1000 From: Kevin Ryde Date: Sat, 31 Aug 2013 10:26:01 +1000 Message-ID: <87fvtqzox2.fsf@blah.blah> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -3.4 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.4 (---) --=-=-= Content-Type: text/plain The docstring of frame-background-mode says Don't set this variable with `setq'; this won't have the expected effect. but doesn't say what you should in fact do. Perhaps something like below. Unless frame-set-background-mode is meant to be internals ... 2013-08-31 Kevin Ryde * frame.el (frame-background-mode): Docstring describe frame-set-background-mode after setting and suggest custom-set-variables from .emacs. --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=frame.el.frame-background-mode.diff diff -c /down/emacs-bzr/lisp/frame.el.orig /down/emacs-bzr/lisp/frame.el *** /down/emacs-bzr/lisp/frame.el.orig 2013-08-31 10:01:50.000000000 +1000 --- /down/emacs-bzr/lisp/frame.el 2013-08-31 10:23:16.000000000 +1000 *************** *** 872,879 **** "The brightness of the background. Set this to the symbol `dark' if your background color is dark, `light' if your background is light, or nil (automatic by default) ! if you want Emacs to examine the brightness for you. Don't set this ! variable with `setq'; this won't have the expected effect." :group 'faces :set #'(lambda (var value) (set-default var value) --- 872,886 ---- "The brightness of the background. Set this to the symbol `dark' if your background color is dark, `light' if your background is light, or nil (automatic by default) ! if you want Emacs to examine the brightness for you. ! ! If this variable is changed with `setq' then call ! `frame-set-background-mode' on each frame to update existing ! faces. The customize interface updates after setting and that ! can be used from .emacs or similar with for example ! ! (custom-set-variables '(frame-background-mode 'dark))" ! :group 'faces :set #'(lambda (var value) (set-default var value) Diff finished. Sat Aug 31 10:23:38 2013 --=-=-= Content-Type: text/plain In GNU Emacs 24.3.1 (i486-pc-linux-gnu, X toolkit, Xaw3d scroll bars) of 2013-05-29 on blah.blah, modified by Debian System Description: Debian GNU/Linux unstable (sid) Configured using: `configure '--build' 'i486-linux-gnu' '--build' 'i486-linux-gnu' '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' '--localstatedir=/var/lib' '--infodir=/usr/share/info' '--mandir=/usr/share/man' '--with-pop=yes' '--enable-locallisppath=/etc/emacs24:/etc/emacs:/usr/local/share/emacs/24.3/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/24.3/site-lisp:/usr/share/emacs/site-lisp' '--with-crt-dir=/usr/lib/i386-linux-gnu' '--with-x=yes' '--with-x-toolkit=lucid' '--with-toolkit-scroll-bars' '--without-gconf' 'build_alias=i486-linux-gnu' 'CFLAGS=-g -O2 -fstack-protector --param=ssp-buffer-size=4 -Wformat -Werror=format-security -Wall' 'LDFLAGS=-Wl,-z,relro -Wl,-znocombreloc' 'CPPFLAGS=-D_FORTIFY_SOURCE=2'' Important settings: value of $LANG: en_AU locale-coding-system: iso-latin-1-unix default enable-multibyte-characters: t --=-=-=-- From unknown Sat Jun 14 19:38:35 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Kevin Ryde Subject: bug#15226: closed (Re: bug#15226: 24.3; frame-background-mode docstring on not setq) Message-ID: References: <87fvtqzox2.fsf@blah.blah> X-Gnu-PR-Message: they-closed 15226 X-Gnu-PR-Package: emacs Reply-To: 15226@debbugs.gnu.org Date: Sun, 01 Sep 2013 01:31:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1377999062-22657-1" This is a multi-part message in MIME format... ------------=_1377999062-22657-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #15226: 24.3; frame-background-mode docstring on not setq which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 15226@debbugs.gnu.org. --=20 15226: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D15226 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1377999062-22657-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 15226-done) by debbugs.gnu.org; 1 Sep 2013 01:30:11 +0000 Received: from localhost ([127.0.0.1]:33826 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VFwUU-0005sL-E0 for submit@debbugs.gnu.org; Sat, 31 Aug 2013 21:30:10 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:36073 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VFwUS-0005sB-9z for 15226-done@debbugs.gnu.org; Sat, 31 Aug 2013 21:30:08 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1VFwUQ-0004qc-K3; Sat, 31 Aug 2013 21:30:06 -0400 From: Glenn Morris To: 15226-done@debbugs.gnu.org Subject: Re: bug#15226: 24.3; frame-background-mode docstring on not setq References: <87fvtqzox2.fsf@blah.blah> X-Spook: Cohiba Project Monarch kilo class passwd defense X-Ran: LFB.L1Tiap7*Bxcr!CWhrgnyH9jnFYi;e-.AnI[1/cl'==-q6/tEXD28};O}"sr~dM]?`J X-Hue: black X-Debbugs-No-Ack: yes X-Attribution: GM Date: Sat, 31 Aug 2013 21:30:06 -0400 In-Reply-To: <87fvtqzox2.fsf@blah.blah> (Kevin Ryde's message of "Sat, 31 Aug 2013 10:26:01 +1000") Message-ID: User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -7.5 (-------) X-Debbugs-Envelope-To: 15226-done X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -7.5 (-------) Version: 24.4 Fixed. ------------=_1377999062-22657-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 31 Aug 2013 00:26:37 +0000 Received: from localhost ([127.0.0.1]:60234 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VFZ1Q-0003Wp-PA for submit@debbugs.gnu.org; Fri, 30 Aug 2013 20:26:37 -0400 Received: from eggs.gnu.org ([208.118.235.92]:57038) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VFZ1N-0003Wb-Nd for submit@debbugs.gnu.org; Fri, 30 Aug 2013 20:26:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VFZ1A-0003C7-Fq for submit@debbugs.gnu.org; Fri, 30 Aug 2013 20:26:28 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:58047) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFZ1A-0003C3-CZ for submit@debbugs.gnu.org; Fri, 30 Aug 2013 20:26:20 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:58667) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFZ13-00035q-EF for bug-gnu-emacs@gnu.org; Fri, 30 Aug 2013 20:26:20 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VFZ0w-00034s-4r for bug-gnu-emacs@gnu.org; Fri, 30 Aug 2013 20:26:13 -0400 Received: from mailout1-11.pacific.net.au ([125.255.80.130]:55975 helo=mailout3-syd3.pacific.net.au) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFZ0v-000323-JB for bug-gnu-emacs@gnu.org; Fri, 30 Aug 2013 20:26:06 -0400 Received: from mailproxy4-syd3.pacific.net.au (mailproxy4-syd3.pacific.net.au [61.8.2.162]) by mailout3-syd3.pacific.net.au (Postfix) with ESMTP id 5836A394547 for ; Sat, 31 Aug 2013 10:25:50 +1000 (EST) Received: from blah.blah (unknown [203.26.175.75]) by mailproxy4-syd3.pacific.net.au (Postfix) with ESMTP id 558264B4004 for ; Sat, 31 Aug 2013 10:25:49 +1000 (EST) Received: from gg by blah.blah with local (Exim 4.80) (envelope-from ) id 1VFZ0r-0007J8-Ga for bug-gnu-emacs@gnu.org; Sat, 31 Aug 2013 10:26:01 +1000 From: Kevin Ryde To: bug-gnu-emacs@gnu.org Subject: 24.3; frame-background-mode docstring on not setq Date: Sat, 31 Aug 2013 10:26:01 +1000 Message-ID: <87fvtqzox2.fsf@blah.blah> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -3.4 (---) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.4 (---) --=-=-= Content-Type: text/plain The docstring of frame-background-mode says Don't set this variable with `setq'; this won't have the expected effect. but doesn't say what you should in fact do. Perhaps something like below. Unless frame-set-background-mode is meant to be internals ... 2013-08-31 Kevin Ryde * frame.el (frame-background-mode): Docstring describe frame-set-background-mode after setting and suggest custom-set-variables from .emacs. --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=frame.el.frame-background-mode.diff diff -c /down/emacs-bzr/lisp/frame.el.orig /down/emacs-bzr/lisp/frame.el *** /down/emacs-bzr/lisp/frame.el.orig 2013-08-31 10:01:50.000000000 +1000 --- /down/emacs-bzr/lisp/frame.el 2013-08-31 10:23:16.000000000 +1000 *************** *** 872,879 **** "The brightness of the background. Set this to the symbol `dark' if your background color is dark, `light' if your background is light, or nil (automatic by default) ! if you want Emacs to examine the brightness for you. Don't set this ! variable with `setq'; this won't have the expected effect." :group 'faces :set #'(lambda (var value) (set-default var value) --- 872,886 ---- "The brightness of the background. Set this to the symbol `dark' if your background color is dark, `light' if your background is light, or nil (automatic by default) ! if you want Emacs to examine the brightness for you. ! ! If this variable is changed with `setq' then call ! `frame-set-background-mode' on each frame to update existing ! faces. The customize interface updates after setting and that ! can be used from .emacs or similar with for example ! ! (custom-set-variables '(frame-background-mode 'dark))" ! :group 'faces :set #'(lambda (var value) (set-default var value) Diff finished. Sat Aug 31 10:23:38 2013 --=-=-= Content-Type: text/plain In GNU Emacs 24.3.1 (i486-pc-linux-gnu, X toolkit, Xaw3d scroll bars) of 2013-05-29 on blah.blah, modified by Debian System Description: Debian GNU/Linux unstable (sid) Configured using: `configure '--build' 'i486-linux-gnu' '--build' 'i486-linux-gnu' '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' '--localstatedir=/var/lib' '--infodir=/usr/share/info' '--mandir=/usr/share/man' '--with-pop=yes' '--enable-locallisppath=/etc/emacs24:/etc/emacs:/usr/local/share/emacs/24.3/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/24.3/site-lisp:/usr/share/emacs/site-lisp' '--with-crt-dir=/usr/lib/i386-linux-gnu' '--with-x=yes' '--with-x-toolkit=lucid' '--with-toolkit-scroll-bars' '--without-gconf' 'build_alias=i486-linux-gnu' 'CFLAGS=-g -O2 -fstack-protector --param=ssp-buffer-size=4 -Wformat -Werror=format-security -Wall' 'LDFLAGS=-Wl,-z,relro -Wl,-znocombreloc' 'CPPFLAGS=-D_FORTIFY_SOURCE=2'' Important settings: value of $LANG: en_AU locale-coding-system: iso-latin-1-unix default enable-multibyte-characters: t --=-=-=-- ------------=_1377999062-22657-1--