From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#22104: 25.1.50; doc string of `modify-frame-parameters' Date: Mon, 07 Dec 2015 19:50:37 +0200 Message-ID: <83wpsqcfma.fsf@gnu.org> References: <831taydvql.fsf@gnu.org> <95bedfbe-5686-4a79-9fd3-561d927986d3@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1449510763 31800 80.91.229.3 (7 Dec 2015 17:52:43 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 7 Dec 2015 17:52:43 +0000 (UTC) Cc: 22104@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Dec 07 18:52:32 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1a5zxL-0003It-DE for geb-bug-gnu-emacs@m.gmane.org; Mon, 07 Dec 2015 18:52:11 +0100 Original-Received: from localhost ([::1]:55809 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a5zxK-0000AL-Pe for geb-bug-gnu-emacs@m.gmane.org; Mon, 07 Dec 2015 12:52:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50133) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a5zxF-00007E-My for bug-gnu-emacs@gnu.org; Mon, 07 Dec 2015 12:52:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a5zxC-0003gR-8e for bug-gnu-emacs@gnu.org; Mon, 07 Dec 2015 12:52:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:52248) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a5zxC-0003fo-5P for bug-gnu-emacs@gnu.org; Mon, 07 Dec 2015 12:52:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1a5zxB-0003mc-TF for bug-gnu-emacs@gnu.org; Mon, 07 Dec 2015 12:52:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 07 Dec 2015 17:52:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22104 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 22104-submit@debbugs.gnu.org id=B22104.144951068414499 (code B ref 22104); Mon, 07 Dec 2015 17:52:01 +0000 Original-Received: (at 22104) by debbugs.gnu.org; 7 Dec 2015 17:51:24 +0000 Original-Received: from localhost ([127.0.0.1]:41956 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5zwZ-0003ln-FX for submit@debbugs.gnu.org; Mon, 07 Dec 2015 12:51:23 -0500 Original-Received: from mtaout26.012.net.il ([80.179.55.182]:45921) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a5zwW-0003lc-WB for 22104@debbugs.gnu.org; Mon, 07 Dec 2015 12:51:21 -0500 Original-Received: from conversion-daemon.mtaout26.012.net.il by mtaout26.012.net.il (HyperSendmail v2007.08) id <0NZ000O001M3LS00@mtaout26.012.net.il> for 22104@debbugs.gnu.org; Mon, 07 Dec 2015 19:53:15 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([84.94.185.246]) by mtaout26.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NZ000NZ71OQRT00@mtaout26.012.net.il>; Mon, 07 Dec 2015 19:53:15 +0200 (IST) In-reply-to: <95bedfbe-5686-4a79-9fd3-561d927986d3@default> X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 208.118.235.43 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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:109718 Archived-At: > Date: Mon, 7 Dec 2015 09:34:28 -0800 (PST) > From: Drew Adams > Cc: 22104@debbugs.gnu.org > > > > This part of the doc string is unclear: > > > > > > Undefined PARMs are ignored, but stored in the frame's parameter list > > > so that 'frame-parameters' will return them. > > > > > > What does "ignored" mean here? It can only mean (?) ignored by > > > `modify-parameters', but what does that mean, operationally? > > > > It means they have no effect beyond being stored in the parameter > > list. I will clarify that. > > But I still don't understand, from that description. What else > does `modify-frame-parameters' ever do, besides store them in the > parameter list? Quite a few parameters require modify-frame-parameters to call some API in order to put the parameter in effect. For example, background-color -- just storing the new value won't magically change the color, would it? IOW, modify-frame-parameters is not just for altering the params alist, it is primarily for changing the frame according to the changed parameters; it records the parameters in effect in the alist mostly as a side effect. Yes, "modify the frame parameters" is ambiguous.