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 09:44:13 -0700 Message-ID: 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 1248627471 774 80.91.229.12 (26 Jul 2009 16:57:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 26 Jul 2009 16:57:51 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 26 18:57:44 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 1MV72d-0008LE-Cb for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 Jul 2009 18:57:43 +0200 Original-Received: from localhost ([127.0.0.1]:44898 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MV72c-0000fl-Jw for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 Jul 2009 12:57:42 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MV72X-0000e6-L7 for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 12:57:37 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MV72T-0000U2-KR for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 12:57:37 -0400 Original-Received: from [199.232.76.173] (port=36377 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MV72T-0000Tg-GB for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 12:57:33 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:57655) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MV72S-0002pg-S2 for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 12: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 n6QGvUUP007526; Sun, 26 Jul 2009 09:57:30 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n6QGo4kJ006188; Sun, 26 Jul 2009 09:50:04 -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 16:50:04 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 3931 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12486266595285 (code B ref -1); Sun, 26 Jul 2009 16:50:04 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 26 Jul 2009 16:44:19 +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 n6QGiChU005280 for ; Sun, 26 Jul 2009 09:44:14 -0700 Original-Received: from mail.gnu.org ([199.232.76.166]:41969 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1MV6pY-0005Mv-9i for emacs-pretest-bug@gnu.org; Sun, 26 Jul 2009 12:44:12 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1MV6pW-0000JY-Kp for emacs-pretest-bug@gnu.org; Sun, 26 Jul 2009 12:44:12 -0400 Original-Received: from acsinet12.oracle.com ([141.146.126.234]:58670) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MV6pW-0000JK-6J for emacs-pretest-bug@gnu.org; Sun, 26 Jul 2009 12:44:10 -0400 Original-Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n6QGhlut020677 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 26 Jul 2009 16:43:48 GMT Original-Received: from abhmt001.oracle.com (abhmt001.oracle.com [141.146.116.10]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n6QGi5C1018602 for ; Sun, 26 Jul 2009 16:44:05 GMT Original-Received: from dradamslap1 (/141.144.232.119) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 26 Jul 2009 09:44:04 -0700 X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 Thread-Index: AcoOEE5r1CizKRFPT3Oy0o4+un/LUA== X-Source-IP: abhmt001.oracle.com [141.146.116.10] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A010204.4A6C87D5.006B:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Sun, 26 Jul 2009 12:57:37 -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:29634 gmane.emacs.pretest.bugs:24843 Archived-At: Doc string of `select-frame': "If you are using a window system, the previously selected frame may be restored as the selected frame after return to the command loop..." That's grammatically incorrect - "return" should presumably be "returning" (depending on what is intended by the sentence). In any case, this paragraph of the description is not very clear. 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." "Mouse cursor" is incorrect; "pointer" is correct (or "mouse pointer", but, strictly speaking, "mouse" is redundant for the pointer). Why "Otherwise"? I'm guessing that what is really meant is this: * If either `mouse-autoselect-window' or `focus-follows-mouse' is non-nil, then move the mouse pointer to.... * 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. In GNU Emacs 23.0.96.1 (i386-mingw-nt5.1.2600) of 2009-07-09 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4)'