From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Robert Weiner Newsgroups: gmane.emacs.devel Subject: Re: Suggestion: Add discussion of input focus handling to select-window; add select-frame-window Date: Wed, 13 Dec 2017 09:37:03 -0500 Message-ID: References: <5A30E9AF.2060105@gmx.at> Reply-To: rswgnu@gmail.com NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="94eb2c057f603da49d056039b54b" X-Trace: blaine.gmane.org 1513175917 21866 195.159.176.226 (13 Dec 2017 14:38:37 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 13 Dec 2017 14:38:37 +0000 (UTC) Cc: emacs-devel To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Dec 13 15:38:34 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eP8B5-0005U3-Vy for ged-emacs-devel@m.gmane.org; Wed, 13 Dec 2017 15:38:32 +0100 Original-Received: from localhost ([::1]:35805 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eP8BD-0003db-2F for ged-emacs-devel@m.gmane.org; Wed, 13 Dec 2017 09:38:39 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56116) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eP8AF-0003bR-Dm for emacs-devel@gnu.org; Wed, 13 Dec 2017 09:37:40 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eP8AA-0007TW-Fr for emacs-devel@gnu.org; Wed, 13 Dec 2017 09:37:39 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:37973) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eP8AA-0007T5-CN for emacs-devel@gnu.org; Wed, 13 Dec 2017 09:37:34 -0500 Original-Received: from mail-qk0-f171.google.com ([209.85.220.171]:47006) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1eP8AA-0003tC-5M for emacs-devel@gnu.org; Wed, 13 Dec 2017 09:37:34 -0500 Original-Received: by mail-qk0-f171.google.com with SMTP id b184so2186109qkc.13 for ; Wed, 13 Dec 2017 06:37:34 -0800 (PST) X-Gm-Message-State: AKGB3mLE1ZmchIw8C6F6Fh1Pjaghiyg0qQywQNCmrevbwMdLbLJihyVh fD7sRLQ4PXSs74BJjUl3OuRDHb2vLZJuZcKU+yM= X-Google-Smtp-Source: ACJfBov9CCM4n94Xm2C8+5H/0q7tnAHrXjxycXBQcg1LpKjjx2uy6F3s37Hs2Mv3ywdRivpCyK4OsMKwvZU7fPFYGsU= X-Received: by 10.55.129.199 with SMTP id c190mr11279384qkd.145.1513175853667; Wed, 13 Dec 2017 06:37:33 -0800 (PST) Original-Received: by 10.200.55.124 with HTTP; Wed, 13 Dec 2017 06:37:03 -0800 (PST) In-Reply-To: X-Gmail-Original-Message-ID: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:220996 Archived-At: --94eb2c057f603da49d056039b54b Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Wed, Dec 13, 2017 at 8:37 AM, Stefan Monnier wrote: > > `select-window' is a function with immediate effect so we can give it a > > self-contained doc-string and description. > [...] > > So I think that people who need information about how to raise a frame > > or giving it input focus should look into the Elisp manual. > > I don't think select-window should explain what > select-frame-set-input-focus does, indeed. But I think it'd be OK for > it to make it clear that it doesn't directly affect focus, with a link > to another function that does. > =E2=80=8BAgreed. It is natural for people to start programming things in E= macs with a single frame and multiple windows. As they expand their knowledge to multiple frames and selecting a window in another frame, they'll want to know the extent of what select-window handles and what it doesn't. Their could be simple explanations and references on input focus like: Although this selects the window's frame, it does not alter the frame's position in the window stack (see `raise-frame') nor does it direct input focus to that frame. To do both of those at once, see `select-frame-set-input-focus'. Bob =E2=80=8B --94eb2c057f603da49d056039b54b Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Wed, Dec 13, 2= 017 at 8:37 AM, Stefan Monnier <monnier@iro.umontreal.ca> wrote:
>= ; `select-window' is a function with immediate effect so we can give it= a
> self-contained doc-string and description.
[...]
> So I think that people who need information about how= to raise a frame
> or giving it input focus should look into the Elisp manual.

I don't think select-window should explain what
select-frame-set-input-focus does, indeed.=C2=A0 But I think it'd be OK= for
it to make it clear that it doesn't directly affect focus, with a link<= br> to another function that does.

=E2=80=8BAgreed.= =C2=A0 It is natural for people to start programming things in Emacs with a= single frame and multiple windows.=C2=A0 As they expand their knowledge to= multiple frames and selecting a window in another frame, they'll want = to know the extent of what select-window handles and what it doesn't.= =C2=A0 Their could be simple explanations and references on input focus lik= e:

Although this selects the window's frame, it does not alter t= he frame's position in the window stack (see `raise-frame') nor doe= s it direct input focus to that frame.
To do both of those at once, see `s= elect-frame-set-input-focus'.

Bob
=E2=80=8B
= --94eb2c057f603da49d056039b54b--