From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#3931: 23.0.96; doc of select-frame-set-input-focus and select-frame Date: Sun, 26 Jul 2009 12:33:38 -0700 Message-ID: References: <874osz9rlr.fsf@bzg.ath.cx> Reply-To: Drew Adams , 3931@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1248638288 31359 80.91.229.12 (26 Jul 2009 19:58:08 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 26 Jul 2009 19:58:08 +0000 (UTC) Cc: emacs-pretest-bug@gnu.org, 3931@emacsbugs.donarmstrong.com To: "'Bastien'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 26 21:58:01 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MV9r5-0001c2-Ja for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 Jul 2009 21:57:59 +0200 Original-Received: from localhost ([127.0.0.1]:52455 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MV9r5-00077S-61 for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 Jul 2009 15:57:59 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MV9ql-000714-28 for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 15:57:39 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MV9qg-0006zf-2t for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 15:57:38 -0400 Original-Received: from [199.232.76.173] (port=41900 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MV9qf-0006zU-Pp for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 15:57:33 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:52267) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MV9qf-0008MV-47 for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 15:57:33 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n6QJvUov006723; Sun, 26 Jul 2009 12:57:31 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n6QJe5Zs003771; Sun, 26 Jul 2009 12:40:05 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sun, 26 Jul 2009 19:40:05 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 3931 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12486368472607 (code B ref -1); Sun, 26 Jul 2009 19:40:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 26 Jul 2009 19:34:07 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n6QJY2Rr002596 for ; Sun, 26 Jul 2009 12:34:04 -0700 Original-Received: from mail.gnu.org ([199.232.76.166]:35169 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1MV9Tu-0002gg-1X for emacs-pretest-bug@gnu.org; Sun, 26 Jul 2009 15:34:02 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1MV9Tp-0001P4-PB for emacs-pretest-bug@gnu.org; Sun, 26 Jul 2009 15:34:01 -0400 Original-Received: from mx20.gnu.org ([199.232.41.8]:38485) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MV9Tp-0001Nj-Bp for emacs-pretest-bug@gnu.org; Sun, 26 Jul 2009 15:33:57 -0400 Original-Received: from acsinet12.oracle.com ([141.146.126.234]) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1MV9Tn-00046f-IS for emacs-pretest-bug@gnu.org; Sun, 26 Jul 2009 15:33:55 -0400 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by acsinet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n6QJX9VQ026889 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 26 Jul 2009 19:33:11 GMT Original-Received: from abhmt010.oracle.com (abhmt010.oracle.com [141.146.116.19]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n6QJXceU004766; Sun, 26 Jul 2009 19:33:38 GMT Original-Received: from dradamslap1 (/141.144.232.119) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 26 Jul 2009 12:33:27 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <874osz9rlr.fsf@bzg.ath.cx> X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 Thread-Index: AcoOJrO0PQKtIeNOSFmARGEN984QuwAAFlKA X-Source-IP: abhmt010.oracle.com [141.146.116.19] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A010206.4A6CAF88.002F:SCFSTAT5015188,ss=1,fgs=0 X-Detected-Operating-System: by mx20.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Sun, 26 Jul 2009 15:57:38 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:29639 gmane.emacs.pretest.bugs:24847 Archived-At: > > Doc string of `select-frame-set-input-focus': > > "If `mouse-autoselect-window' is non-nil, also move mouse cursor to > > FRAME's selected window. Otherwise, if `focus-follows-mouse' is > > non-nil, move mouse cursor to FRAME." > > > > Why "Otherwise"? > > Because the value of `focus-follows-mouse' is only checked if > `mouse-autoselect-window' is nil. OK, in that case the text is correct. But it could easily be misread by some users. It would be clearer to state this explicitly: "If `mouse-autoselect-window' is nil and `mouse-autoselect-window' is non-nil, then move the mouse pointer to FRAME." And it wouldn't hurt to state this explicitly also: "Otherwise, do not move the mouse pointer." > > Similar problems exist for the description in the Elisp manual (the > > text is almost the same). In addition, the manual should say > > something more about the differences between these two > functions, and > > mention when you might use one or the other. > > I don't know how to fix the Elisp manual. Hopefully, someone else does. ;-) Thx.