From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Bastien 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: Mon, 27 Jul 2009 03:22:40 +0800 Message-ID: <874osz9rlr.fsf@bzg.ath.cx> References: Reply-To: Bastien , 3931@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1248637822 30273 80.91.229.12 (26 Jul 2009 19:50:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 26 Jul 2009 19:50:22 +0000 (UTC) Cc: emacs-pretest-bug@gnu.org, 3931@emacsbugs.donarmstrong.com To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 26 21:50:14 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 1MV9ja-0007Wk-5h for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 Jul 2009 21:50:14 +0200 Original-Received: from localhost ([127.0.0.1]:45633 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MV9jZ-0008FI-CN for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 Jul 2009 15:50:13 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MV9jU-0008Cs-RL for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 15:50:08 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MV9jP-000894-Lq for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 15:50:07 -0400 Original-Received: from [199.232.76.173] (port=34164 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MV9jP-000891-Hw for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 15:50:03 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:34011) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MV9jO-0006mV-QD for bug-gnu-emacs@gnu.org; Sun, 26 Jul 2009 15:50:03 -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 n6QJbUYc003540; Sun, 26 Jul 2009 12:37:31 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n6QJU7ZA001838; Sun, 26 Jul 2009 12:30:07 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Bastien Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sun, 26 Jul 2009 19:30:07 +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 3931-submit@emacsbugs.donarmstrong.com id=B3931.1248636173853 (code B ref 3931); Sun, 26 Jul 2009 19:30:07 +0000 Original-Received: (at 3931) by emacsbugs.donarmstrong.com; 26 Jul 2009 19:22:53 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from rv-out-0506.google.com (rv-out-0506.google.com [209.85.198.233]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n6QJMmib000845 for <3931@emacsbugs.donarmstrong.com>; Sun, 26 Jul 2009 12:22:49 -0700 Original-Received: by rv-out-0506.google.com with SMTP id f6so747439rvb.1 for <3931@emacsbugs.donarmstrong.com>; Sun, 26 Jul 2009 12:22:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:from:to:cc:subject :in-reply-to:references:user-agent:date:message-id:mime-version :content-type; bh=OLWiSve3BvFZxc9EcwCAAArNZg31U0BgNb+tDWb5uOQ=; b=EhJy4q5aQxnSaCSq5wQi/pTcpQOJoPVz+RlnTLaarLh+WybwQLzoE7VVwCyGu61Ums dOEk+kOJXYRWX06tm1Ryb82oYRNM+hhvAFZS2hIZfZ4zUOLEWlevZQ4YM9nRE/m0RvUO zWxTfhwkctO/gjMR9rqcMEpwCSufcXF3M2VDc= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type; b=TDcBiNZfzfgDb2hF95LwYMRoFHkk77iZB49RwPoFEqdjl0d22yWtOxu+QxPZapZi4q 7Pz+j0Y1Jm7r1bc8peHwchEwfoJNAZ1zxHnRUlutUbMpZDYLpER4kp5Lyt5CMB2ZzHvF DimVxZ8D8WbZo/TEGJEeOfu7WM04qU6KZJDg4= Original-Received: by 10.140.143.13 with SMTP id q13mr3204113rvd.69.1248636168217; Sun, 26 Jul 2009 12:22:48 -0700 (PDT) Original-Received: from bzg.ath.cx ([222.29.50.13]) by mx.google.com with ESMTPS id f42sm27665664rvb.25.2009.07.26.12.22.45 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sun, 26 Jul 2009 12:22:47 -0700 (PDT) In-Reply-To: (Drew Adams's message of "Sun, 26 Jul 2009 09:44:13 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.50 (gnu/linux) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Sun, 26 Jul 2009 15:50:07 -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:29638 gmane.emacs.pretest.bugs:24846 Archived-At: "Drew Adams" writes: > "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. I have changed it to this: "If you are using a window system, the previously selected frame may be restored as the selected frame when returning to the command loop, because it still may have the window system's input focus." > 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). Right, I changed this. > Why "Otherwise"? Because the value of `focus-follows-mouse' is only checked if `mouse-autoselect-window' is nil. > 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. -- Bastien