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#19682: 25.0.50; `other-window' doc string should say that by default it selects win in same frame Date: Mon, 26 Jan 2015 08:30:18 +0200 Message-ID: <837fwaqcjp.fsf@gnu.org> References: <83iofur7aj.fsf@gnu.org> <1c4fcb28-17c3-48a6-81c2-c21376e5ac11@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1422253873 14095 80.91.229.3 (26 Jan 2015 06:31:13 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 26 Jan 2015 06:31:13 +0000 (UTC) Cc: 19682@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 26 07:31:12 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 1YFdCZ-000359-T6 for geb-bug-gnu-emacs@m.gmane.org; Mon, 26 Jan 2015 07:31:12 +0100 Original-Received: from localhost ([::1]:40151 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YFdCZ-0000Oi-AB for geb-bug-gnu-emacs@m.gmane.org; Mon, 26 Jan 2015 01:31:11 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48880) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YFdCV-0000O0-Pz for bug-gnu-emacs@gnu.org; Mon, 26 Jan 2015 01:31:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YFdCQ-0008Ks-Pq for bug-gnu-emacs@gnu.org; Mon, 26 Jan 2015 01:31:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:37797) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YFdCQ-0008Km-Mo for bug-gnu-emacs@gnu.org; Mon, 26 Jan 2015 01:31:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YFdCQ-0000TJ-1j for bug-gnu-emacs@gnu.org; Mon, 26 Jan 2015 01:31:02 -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, 26 Jan 2015 06:31: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.14222538421789 (code B ref 19682); Mon, 26 Jan 2015 06:31:01 +0000 Original-Received: (at 19682) by debbugs.gnu.org; 26 Jan 2015 06:30:42 +0000 Original-Received: from localhost ([127.0.0.1]:56489 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YFdC6-0000Sm-7D for submit@debbugs.gnu.org; Mon, 26 Jan 2015 01:30:42 -0500 Original-Received: from mtaout25.012.net.il ([80.179.55.181]:54325) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YFdC3-0000Qk-8S for 19682@debbugs.gnu.org; Mon, 26 Jan 2015 01:30:40 -0500 Original-Received: from conversion-daemon.mtaout25.012.net.il by mtaout25.012.net.il (HyperSendmail v2007.08) id <0NIR00300TUTNI00@mtaout25.012.net.il> for 19682@debbugs.gnu.org; Mon, 26 Jan 2015 08:25:46 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout25.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NIR00G1DTUYCYB0@mtaout25.012.net.il>; Mon, 26 Jan 2015 08:25:46 +0200 (IST) In-reply-to: <1c4fcb28-17c3-48a6-81c2-c21376e5ac11@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: 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:98746 Archived-At: > Date: Sun, 25 Jan 2015 15:40:08 -0800 (PST) > From: Drew Adams > Cc: 19682@debbugs.gnu.org > > > I don't see why this single details matters more than the others. > > That is apparently, the problem here - you don't see it. > > The answer to "Why?" is that this information is very useful and > yet not obvious. It's not obvious, I agree. But I don't think it's very useful, except in very specific and IMO quite rare situations. > A user looking for a command that cycles among all windows in > the same frame will not necessarily understand, immediately upon > reading `C-h f other-window', that that is what this command does. If she doesn't care, she doesn't need to understand. If she does, there are enough hints in the doc string to suggest that reading the doc string of next-window will explain those details. > After trying to understand all of that, our poor reader finally > gets to a reference to function `next-window' and its possible > arguments. Nothing wrong with that. And possibly, an inquisitive enough reader will discover that even earlier, perhaps much earlier.