From c19dd8e9d6c54080426623129a824e5bb2fcf7be Mon Sep 17 00:00:00 2001 From: Robert Pluim Date: Thu, 19 Dec 2024 16:17:16 +0100 Subject: [PATCH] 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. 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'.