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#22104: 25.1.50; doc string of `modify-frame-parameters' Date: Mon, 7 Dec 2015 10:07:49 -0800 (PST) Message-ID: <61eaf86f-4a08-480e-bf3d-8f32b40152d7@default> References: <> <<831taydvql.fsf@gnu.org>> <<95bedfbe-5686-4a79-9fd3-561d927986d3@default>> <<83wpsqcfma.fsf@gnu.org>> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1449511703 14866 80.91.229.3 (7 Dec 2015 18:08:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 7 Dec 2015 18:08:23 +0000 (UTC) Cc: 22104@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Dec 07 19:08:10 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 1a60Co-0000Zz-9u for geb-bug-gnu-emacs@m.gmane.org; Mon, 07 Dec 2015 19:08:10 +0100 Original-Received: from localhost ([::1]:55876 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a60Cn-00006a-KF for geb-bug-gnu-emacs@m.gmane.org; Mon, 07 Dec 2015 13:08:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54543) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a60Ch-0008Se-8R for bug-gnu-emacs@gnu.org; Mon, 07 Dec 2015 13:08:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a60Cg-0008MF-67 for bug-gnu-emacs@gnu.org; Mon, 07 Dec 2015 13:08:03 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:52259) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a60Cg-0008MB-2z for bug-gnu-emacs@gnu.org; Mon, 07 Dec 2015 13:08:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1a60Cf-0005nW-Pg for bug-gnu-emacs@gnu.org; Mon, 07 Dec 2015 13:08:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 07 Dec 2015 18:08: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.144951167622275 (code B ref 22104); Mon, 07 Dec 2015 18:08:01 +0000 Original-Received: (at 22104) by debbugs.gnu.org; 7 Dec 2015 18:07:56 +0000 Original-Received: from localhost ([127.0.0.1]:41967 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a60CZ-0005nD-F4 for submit@debbugs.gnu.org; Mon, 07 Dec 2015 13:07:55 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:21780) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a60CX-0005n4-5x for 22104@debbugs.gnu.org; Mon, 07 Dec 2015 13:07:53 -0500 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id tB7I7p08024658 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 7 Dec 2015 18:07:52 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id tB7I7pn4009602 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Mon, 7 Dec 2015 18:07:51 GMT Original-Received: from abhmp0002.oracle.com (abhmp0002.oracle.com [141.146.116.8]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id tB7I7oEv008947; Mon, 7 Dec 2015 18:07:50 GMT In-Reply-To: <<83wpsqcfma.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] 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:109720 Archived-At: > > > > 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? >=20 > 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? >=20 > 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. >=20 > Yes, "modify the frame parameters" is ambiguous. OK, so I guess the point is that unrecognized (perhaps a better term than "= undefined", here) parameters are simply stored in the frame's parameter list. No extra handling is done. I think that statement can just be removed. No one would guess that any special, additional action would be undertaken for a parameter that Emacs does not recognize. Talking about this just confuses readers. Users should know that they can add any parameters they want, which are unknown to Emacs. But because Emacs knows nothing about them it is up to a user to provide any expected behavior for them. It is important to say that users can add their own parameters. And I guess it is helpful to add that Emacs does not do anything with them (unless the user programs it to do so). But if we can't do that without confusing readers more, then this addition should be dropped, IMO.