From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: master c19dd8e9d6c 2/2: Add more documentation for TTY child frames Date: Thu, 19 Dec 2024 12:23:52 -0500 Message-ID: References: <173462216748.592529.1858458594667473357@vcs3.savannah.gnu.org> <20241219152929.A6F4FC09079@vcs3.savannah.gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39820"; mail-complaints-to="usenet@ciao.gmane.io" To: Robert Pluim , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Dec 19 18:24:49 2024 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1tOKGW-000AGj-Mu for ged-emacs-devel@m.gmane-mx.org; Thu, 19 Dec 2024 18:24:48 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tOKFh-0007Ho-Kr; Thu, 19 Dec 2024 12:23:57 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tOKFg-0007HK-N5 for emacs-devel@gnu.org; Thu, 19 Dec 2024 12:23:56 -0500 Original-Received: from mail-ed1-x535.google.com ([2a00:1450:4864:20::535]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tOKFf-0007jf-7w for emacs-devel@gnu.org; Thu, 19 Dec 2024 12:23:56 -0500 Original-Received: by mail-ed1-x535.google.com with SMTP id 4fb4d7f45d1cf-5cedf5fe237so1576338a12.3 for ; Thu, 19 Dec 2024 09:23:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1734629033; x=1735233833; darn=gnu.org; h=to:subject:message-id:date:mime-version:references:in-reply-to:from :from:to:cc:subject:date:message-id:reply-to; bh=ZmlR5+m8j5ct2SZ1W3IulTyas1PTA4mF/HdJnEPtCEg=; b=OsAMzii8iyl6e9bOhK9dnAKBE3pUxxQ3hZyBszafp6oY/kLSXvzrZovvbpZlM9qw7V yAv+dDrtNI07VDBd4IUHxGyJbmhkAwogmN4G+xKbH4EAfklPxJ/kXLAUlXpuydqgf/ks GbvlZXn4V45+UyU1lAka5dmEFJ89tNObU12A/YtPv2ysoenSqTeWPE7Mf0gSJCVPkCgy GOUdF6tF5zpypYmIv2rnHTZ3q2qnrGoQlrZRsaFRXtMTkJwLkEjxBou/M+mWS73Jmw9M Vwbk3eoZhHz4jf9gJDszylj9ohRHK9GZPnNF+YIZWVtV4q3y8z/LbTWaUnaDEC583MPO QyCQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1734629033; x=1735233833; h=to:subject:message-id:date:mime-version:references:in-reply-to:from :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=ZmlR5+m8j5ct2SZ1W3IulTyas1PTA4mF/HdJnEPtCEg=; b=t/am6DIxhjaArSJoyJB5WoiKG5quriUyRsAhdBp8bnjwqdkyXNSJKm1CnQVrJZQe0w 3qY3F3ZqTpvIwSO64Eo/2SMvCFgh9X1qkL5zt5pt1W4Eo0xLDiGyqyp1PjZKdwSocEXn YWf/q/bEbyh2d612l7YZVPJmSRC8DsQCQjRXKwqpC/YmiiMen7mlaRv+wT+EH5kIp1PE Hj0xmPg9rcZancmHgM9KPn5biKtqNFGBkEH6RgxRvyjxBHXZV/zwLj/PhQ+69GD7fvfm BAvUcMZAQGp9EI09dEtql84aS/A2wCKOTLuCBmLshEh0TV5pP40ZCj5nj8URPTntldmE 1Ynw== X-Forwarded-Encrypted: i=1; AJvYcCWbpLLr9QJIk/lua/g7bCj7MG9QJv77aKcRf8AV2BsLXeid5LBR00ju3fPgm5wiw0zorUnAOsT2J0OfCQ==@gnu.org X-Gm-Message-State: AOJu0Yx0QkT3y/Kc1+OYEs3YqOZa9mENV+uH/nx4Emd3CyS4qMdiqhoT aagP2mCNJSTRyXAiKclf25bEVCZ0g7vMiEjV+Jd9/RHuTO4JY3wt9wGG3fzPY4nIDo/Z5RC2CQM 3iNbvmQqaoyoUMFY/M/mnaSHGMss= X-Gm-Gg: ASbGncvJ7mIKmLJpKZP4vD7fBfLqDX3oRghshhTDuH3dOxK+LEGjhtpLKvsjqqWHuKg 3S7P4aUA06+zzMB4HJ0kbTIat1kg/ZqA9lP1sRA== X-Google-Smtp-Source: AGHT+IElxL+E8d+EcUGKNkrFM+va2e3Au19fd24a5kFZj3R1b85PQV0lWKXtMpWtSomeS8gA8+dhyE/HGTSZfHHl6ks= X-Received: by 2002:a05:6402:51d1:b0:5d0:fe7d:41cf with SMTP id 4fb4d7f45d1cf-5d8025af4f5mr3596720a12.5.1734629033122; Thu, 19 Dec 2024 09:23:53 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 19 Dec 2024 12:23:52 -0500 In-Reply-To: <20241219152929.A6F4FC09079@vcs3.savannah.gnu.org> Received-SPF: pass client-ip=2a00:1450:4864:20::535; envelope-from=stefankangas@gmail.com; helo=mail-ed1-x535.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:326751 Archived-At: Robert Pluim writes: > branch: master > commit c19dd8e9d6c54080426623129a824e5bb2fcf7be > Author: Robert Pluim > Commit: Robert Pluim > > Add more documentation for TTY child frames > > * doc/lispref/frames.texi (Child Frames): Document that TTY > child frames are now supported. > * etc/NEWS: Document another limitation of TTY child frames. > --- > doc/lispref/frames.texi | 4 ++-- > etc/NEWS | 7 +++++-- > 2 files changed, 7 insertions(+), 4 deletions(-) > > diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi > index bf4d5c05f3a..cc7d3f79a7f 100644 > --- a/doc/lispref/frames.texi > +++ b/doc/lispref/frames.texi > @@ -3393,8 +3393,8 @@ of its sibling child frames. > > By design, operations to make or modify child frames are implemented > with the help of frame parameters (@pxref{Frame Parameters}) without any > -specialized functions or customizable variables. Note that child frames > -are meaningful on graphical terminals only. > +specialized functions or customizable variables. Child frames > +are meaningful on graphical and text terminals. Thanks, this is an improvement. Two comments: 1. s/meaningful/supported/ ? 2. Should we explain the limitations of child frames on text terminals here as well? > To create a new child frame or to convert a normal frame into a child > frame, set that frame's @code{parent-frame} parameter (@pxref{Frame > diff --git a/etc/NEWS b/etc/NEWS > index 7e5a73818ff..9a7b320acdb 100644 > --- a/etc/NEWS > +++ b/etc/NEWS > @@ -47,8 +47,11 @@ enabled, you can disable mouse tracking by putting '(xterm-mouse-mode > ** Child frames are now supported on TTY frames. > This supports use-cases like Posframe, Corfu, and child frames acting > like tooltips. Other use-cases of child frames are not supported yet. > -In particular, trying to create minibuffer-only child frames on a TTY > -frame will signal an error. > +In particular: > + > +- trying to create minibuffer-only child frames on a TTY frame will > + signal an error. > +- a TTY child frame cannot be converted to a root frame or vice-versa. > > To enable tooltips on TTY frames, call 'tty-tip-mode'. I note that we use the terminology "TTY frame" in NEWS, and "text terminal" in the manual above. In other places, we talk about "text frames". Which terminology do we prefer, and does it help avoid any confusion if we are consistent?