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#19682: 25.0.50; `other-window' doc string should say that by default it selects win in same frame Date: Sun, 25 Jan 2015 09:12:23 -0800 (PST) Message-ID: References: <<733fcda9-19ad-4096-aa8a-7f0f47062ac2@default>> <<83y4oqrgkv.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 1422205991 29644 80.91.229.3 (25 Jan 2015 17:13:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 25 Jan 2015 17:13:11 +0000 (UTC) Cc: 19682@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jan 25 18:13:11 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 1YFQkI-0001N1-Bm for geb-bug-gnu-emacs@m.gmane.org; Sun, 25 Jan 2015 18:13:10 +0100 Original-Received: from localhost ([::1]:38375 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YFQkH-0000Wp-KT for geb-bug-gnu-emacs@m.gmane.org; Sun, 25 Jan 2015 12:13:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37046) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YFQkF-0000Wf-5J for bug-gnu-emacs@gnu.org; Sun, 25 Jan 2015 12:13:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YFQkA-0002zH-Ht for bug-gnu-emacs@gnu.org; Sun, 25 Jan 2015 12:13:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:37432) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YFQkA-0002zD-E4 for bug-gnu-emacs@gnu.org; Sun, 25 Jan 2015 12:13:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YFQk9-00041Q-WD for bug-gnu-emacs@gnu.org; Sun, 25 Jan 2015 12:13:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 25 Jan 2015 17:13:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19682 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 19682-submit@debbugs.gnu.org id=B19682.142220595215380 (code B ref 19682); Sun, 25 Jan 2015 17:13:01 +0000 Original-Received: (at 19682) by debbugs.gnu.org; 25 Jan 2015 17:12:32 +0000 Original-Received: from localhost ([127.0.0.1]:56124 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YFQjf-0003zy-BV for submit@debbugs.gnu.org; Sun, 25 Jan 2015 12:12:31 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:30669) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YFQjd-0003zZ-2y for 19682@debbugs.gnu.org; Sun, 25 Jan 2015 12:12:29 -0500 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t0PHCMdW009683 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 25 Jan 2015 17:12:23 GMT Original-Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id t0PHCL6P005431 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sun, 25 Jan 2015 17:12:22 GMT Original-Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t0PHCLVD029537; Sun, 25 Jan 2015 17:12:21 GMT In-Reply-To: <<83y4oqrgkv.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] X-Source-IP: ucsinet22.oracle.com [156.151.31.94] 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: 140.186.70.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:98713 Archived-At: > > The doc string does not describe the default behavior: select another > > window in the same frame, if there is one. > > > > The doc string refers to the doc for `next-window', for the reader to > > find out what ALL-FRAMES does - even for the default, nil, case. > > > > It is fine to refer to `next-window' for ALL-FRAMES (e.g. for full > > understanding and for non-interactive use). But surely the default > > interactive behavior should be described. >=20 > The doc string says: >=20 > This function uses `next-window' for finding the window to > select. The argument ALL-FRAMES has the same meaning as in > `next-window', but the MINIBUF argument of `next-window' is > always effectively nil. >=20 > This is a very clear invitation to read the documentation of > 'next-window', if the reader cares about which window will be > selected. If the reader indeed goes there, she will find there the > details of what you wanted her to know. >=20 > OTOH, many uses of 'other-window' don't really care about the order > and the candidates, in which case that argument is of no importance > for them. >=20 > So I see no reason to think this doc strings lacks something > important. The default interactive behavior should be described clearly, as the first thing in the doc string. Users, especially Lisp users, can read further to discover more information about possible argument values and behavior. But the first thing that needs to be said, very clearly, and preferably without any reference to arguments or other doc strings, is what the default behavior is. It is simple to make this immediately clear to users, and we should do so.