GNU bug report logs - #13339
24.3.50; doc of `next-frame'

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Severity: minor; Reported by: "Drew Adams" <drew.adams@HIDDEN>; dated Wed, 2 Jan 2013 18:59:02 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at 13339 <at> debbugs.gnu.org:


Received: (at 13339) by debbugs.gnu.org; 10 Feb 2014 23:54:38 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Feb 10 18:54:38 2014
Received: from localhost ([127.0.0.1]:42141 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1WD0gP-00033V-Iw
	for submit <at> debbugs.gnu.org; Mon, 10 Feb 2014 18:54:37 -0500
Received: from userp1040.oracle.com ([156.151.31.81]:41519)
 by debbugs.gnu.org with esmtp (Exim 4.80)
 (envelope-from <drew.adams@HIDDEN>) id 1WD0gN-00033F-B8
 for 13339 <at> debbugs.gnu.org; Mon, 10 Feb 2014 18:54:35 -0500
Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238])
 by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id
 s1ANsR2W024914
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK);
 Mon, 10 Feb 2014 23:54:28 GMT
Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85])
 by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s1ANsPKr017146
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL);
 Mon, 10 Feb 2014 23:54:26 GMT
Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21])
 by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s1ANsPLB001160;
 Mon, 10 Feb 2014 23:54:25 GMT
MIME-Version: 1.0
Message-ID: <6f911aff-4f74-40f1-85cf-646cbc3b42b2@default>
Date: Mon, 10 Feb 2014 15:54:24 -0800 (PST)
From: Drew Adams <drew.adams@HIDDEN>
To: Lars Ingebrigtsen <larsi@HIDDEN>
Subject: RE: bug#13339: 24.3.50; doc of `next-frame'
References: <79C6D147824B47049C223D2476CEE799@HIDDEN>
 <87lhxlpwqi.fsf@HIDDEN>
In-Reply-To: <87lhxlpwqi.fsf@HIDDEN>
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8  (707110) [OL
 12.0.6680.5000 (x86)]
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Source-IP: acsinet22.oracle.com [141.146.126.238]
X-Spam-Score: -2.9 (--)
X-Debbugs-Envelope-To: 13339
Cc: 13339 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.9 (--)

> Do you have a suggestion as to what the nil case should say?

It seems like the frames included then would be all frames on the
same terminal, other than FRAME and any minibuffer-only frames.

But see my followup message, which points out that the doc of
`other-frame' seems to suggest something quite different: only
_visible_ frames (on the same terminal...).

Probably someone more knowledgable should check the behavior
and make the fix.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#13339; Package emacs. Full text available.

Message received at 13339 <at> debbugs.gnu.org:


Received: (at 13339) by debbugs.gnu.org; 8 Feb 2014 13:21:32 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Feb 08 08:21:32 2014
Received: from localhost ([127.0.0.1]:56732 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1WC7qd-0003xu-Mq
	for submit <at> debbugs.gnu.org; Sat, 08 Feb 2014 08:21:32 -0500
Received: from hermes.netfonds.no ([80.91.224.195]:34298)
 by debbugs.gnu.org with esmtp (Exim 4.80)
 (envelope-from <larsi@HIDDEN>) id 1WC7qb-0003xl-4N
 for 13339 <at> debbugs.gnu.org; Sat, 08 Feb 2014 08:21:29 -0500
Received: from [204.14.154.233] (helo=building.gnus.org)
 by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.72) (envelope-from <larsi@HIDDEN>)
 id 1WC7qM-00034d-3a; Sat, 08 Feb 2014 14:21:14 +0100
From: Lars Ingebrigtsen <larsi@HIDDEN>
To: "Drew Adams" <drew.adams@HIDDEN>
Subject: Re: bug#13339: 24.3.50; doc of `next-frame'
References: <79C6D147824B47049C223D2476CEE799@HIDDEN>
Date: Sat, 08 Feb 2014 05:20:05 -0800
In-Reply-To: <79C6D147824B47049C223D2476CEE799@HIDDEN> (Drew Adams's
 message of "Wed, 2 Jan 2013 10:56:41 -0800")
Message-ID: <87lhxlpwqi.fsf@HIDDEN>
User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-MailScanner-ID: 1WC7qM-00034d-3a
X-Netfonds-MailScanner: Found to be clean
X-Netfonds-MailScanner-From: larsi@HIDDEN
MailScanner-NULL-Check: 1392470475.10573@p/yUU1ix4UkWFmOvCnd4gA
X-Spam-Status: No
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 13339
Cc: 13339 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.0 (/)

"Drew Adams" <drew.adams@HIDDEN> writes:

> The doc (both doc string and Elisp manual) is unclear for the default
> case where argument MINIFRAME/MINIBUF is nil.  (BTW, the same parameter
> name should be used here for the doc string and the manual.)
>
> What is unclear is which frames are _included_ in this case.  The only
> thing we are told is that minibuffer-only frames are _excluded_.  Does
> that mean that all other frames are included?  Or only visible frames?
> Or only visible or iconified frames?
>
> Other values of this argument make clear which frames are included, but
> the doc for a nil value of the argument is incomplete.

Uhm...  yeah...  clear.  >"?

Do you have a suggestion as to what the nil case should say?

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#13339; Package emacs. Full text available.

Message received at 13339 <at> debbugs.gnu.org:


Received: (at 13339) by debbugs.gnu.org; 2 Jan 2013 19:03:35 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jan 02 14:03:35 2013
Received: from localhost ([127.0.0.1]:40386 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1TqTbC-0002xx-Jp
	for submit <at> debbugs.gnu.org; Wed, 02 Jan 2013 14:03:34 -0500
Received: from userp1040.oracle.com ([156.151.31.81]:31872)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <drew.adams@HIDDEN>) id 1TqTbA-0002xp-Au
	for 13339 <at> debbugs.gnu.org; Wed, 02 Jan 2013 14:03:33 -0500
Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93])
	by userp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with
	ESMTP id r02J28ni031299
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK)
	for <13339 <at> debbugs.gnu.org>; Wed, 2 Jan 2013 19:02:09 GMT
Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158])
	by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id
	r02J275O005845
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO)
	for <13339 <at> debbugs.gnu.org>; Wed, 2 Jan 2013 19:02:08 GMT
Received: from abhmt118.oracle.com (abhmt118.oracle.com [141.146.116.70])
	by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id
	r02J279l010404
	for <13339 <at> debbugs.gnu.org>; Wed, 2 Jan 2013 13:02:07 -0600
Received: from dradamslap1 (/130.35.178.8)
	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Wed, 02 Jan 2013 11:02:07 -0800
From: "Drew Adams" <drew.adams@HIDDEN>
To: <13339 <at> debbugs.gnu.org>
References: <79C6D147824B47049C223D2476CEE799@HIDDEN>
Subject: RE: bug#13339: 24.3.50; doc of `next-frame'
Date: Wed, 2 Jan 2013 11:02:06 -0800
Message-ID: <83B7D1E5A4B541899542C604D1A47005@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="US-ASCII"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Office Outlook 11
In-Reply-To: <79C6D147824B47049C223D2476CEE799@HIDDEN>
Thread-Index: Ac3pGubPcLY1iQDWR+y8vka0JDGxIgAADynQ
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157
X-Source-IP: ucsinet21.oracle.com [156.151.31.93]
X-Spam-Score: -1.5 (-)
X-Debbugs-Envelope-To: 13339
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
X-Spam-Score: -1.5 (-)

BTW, the doc of `other-frame' says that it includes _visible_ frames.  And its
code calls `next-frame' with a nil value for argument MINIFRAME.  So if the doc
of `other-frame' is correct then the `next-frame' with nil MINIFRAME must
include only visible frames, not all frames except minibuffer-only frames and
not all visible or iconified frames except minibuffer-only frames.

If that is not correct then there is thus also a doc bug for `other-frame'.  If
it is correct then that should help you correct the doc for `next-frame'.





Information forwarded to bug-gnu-emacs@HIDDEN:
bug#13339; Package emacs. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 2 Jan 2013 18:58:14 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jan 02 13:58:14 2013
Received: from localhost ([127.0.0.1]:40380 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1TqTW1-0002p4-GO
	for submit <at> debbugs.gnu.org; Wed, 02 Jan 2013 13:58:14 -0500
Received: from eggs.gnu.org ([208.118.235.92]:39558)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <drew.adams@HIDDEN>) id 1TqTVz-0002ox-Dv
	for submit <at> debbugs.gnu.org; Wed, 02 Jan 2013 13:58:12 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1TqTUe-0005tb-4R
	for submit <at> debbugs.gnu.org; Wed, 02 Jan 2013 13:56:49 -0500
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-104.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED,
	T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY,
	USER_IN_WHITELIST autolearn=unavailable version=3.3.2
Received: from lists.gnu.org ([208.118.235.17]:57127)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1TqTUe-0005tW-24
	for submit <at> debbugs.gnu.org; Wed, 02 Jan 2013 13:56:48 -0500
Received: from eggs.gnu.org ([208.118.235.92]:50918)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1TqTUc-0006Gx-WB
	for bug-gnu-emacs@HIDDEN; Wed, 02 Jan 2013 13:56:47 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1TqTUb-0005t2-Ud
	for bug-gnu-emacs@HIDDEN; Wed, 02 Jan 2013 13:56:46 -0500
Received: from aserp1040.oracle.com ([141.146.126.69]:27993)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1TqTUb-0005s5-Nj
	for bug-gnu-emacs@HIDDEN; Wed, 02 Jan 2013 13:56:45 -0500
Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94])
	by aserp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with
	ESMTP id r02Iuhwa017031
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK)
	for <bug-gnu-emacs@HIDDEN>; Wed, 2 Jan 2013 18:56:44 GMT
Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158])
	by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id
	r02Iugvl021893
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO)
	for <bug-gnu-emacs@HIDDEN>; Wed, 2 Jan 2013 18:56:43 GMT
Received: from abhmt115.oracle.com (abhmt115.oracle.com [141.146.116.67])
	by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id
	r02IugDN006479
	for <bug-gnu-emacs@HIDDEN>; Wed, 2 Jan 2013 12:56:42 -0600
Received: from dradamslap1 (/130.35.178.8)
	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Wed, 02 Jan 2013 10:56:42 -0800
From: "Drew Adams" <drew.adams@HIDDEN>
To: <bug-gnu-emacs@HIDDEN>
Subject: 24.3.50; doc of `next-frame'
Date: Wed, 2 Jan 2013 10:56:41 -0800
Message-ID: <79C6D147824B47049C223D2476CEE799@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="US-ASCII"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Office Outlook 11
Thread-Index: Ac3pGubPcLY1iQDWR+y8vka0JDGxIg==
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157
X-Source-IP: ucsinet22.oracle.com [156.151.31.94]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 208.118.235.17
X-Spam-Score: -3.4 (---)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
X-Spam-Score: -4.2 (----)

The doc (both doc string and Elisp manual) is unclear for the default
case where argument MINIFRAME/MINIBUF is nil.  (BTW, the same parameter
name should be used here for the doc string and the manual.)
 
What is unclear is which frames are _included_ in this case.  The only
thing we are told is that minibuffer-only frames are _excluded_.  Does
that mean that all other frames are included?  Or only visible frames?
Or only visible or iconified frames?
 
Other values of this argument make clear which frames are included, but
the doc for a nil value of the argument is incomplete.
 
In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600)
 of 2012-12-31 on ODIEONE
Bzr revision: 111388 rudalics@HIDDEN
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
 `configure --with-gcc (4.7) --no-opt --enable-checking --cflags
 -IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib'
 





Acknowledgement sent to "Drew Adams" <drew.adams@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#13339; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Fri, 31 Oct 2014 17:00:04 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.