1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-13 01:20:28 -08:00

; * doc/lispref/frames.texi (Child Frames): Improve wording.

This commit is contained in:
Eli Zaretskii 2021-12-19 19:27:41 +02:00
parent f11b996a3c
commit 16ed9fad2c

View file

@ -3343,20 +3343,22 @@ are handy (@pxref{Window Parameters}). These allow to remove an
unwanted mode line (when @code{drag-with-header-line} is chosen) and to unwanted mode line (when @code{drag-with-header-line} is chosen) and to
remove mouse-sensitive areas which might interfere with frame dragging. remove mouse-sensitive areas which might interfere with frame dragging.
When the mouse cursor overshoots, it's easy to drag a frame out of the When the user drags a frame with a mouse and overshoots, it's easy
screen area of its parent. Retrieving such a frame can be hairy once to drag a frame out of the screen area of its parent. Retrieving such
the mouse button has been released. To prevent such a situation, it is a frame can be hairy once the mouse button has been released. To
advisable to set the frame's @code{top-visible} or @code{bottom-visible} prevent such a situation, it is advisable to set the frame's
parameter (@pxref{Mouse Dragging Parameters}). @code{top-visible} or @code{bottom-visible} parameter (@pxref{Mouse
Dragging Parameters}).
Set the @code{top-visible} parameter of a child frame to a number when Set the @code{top-visible} parameter of a child frame to a number
you intend to drag that frame via its header line. This inhibits when you intend to allow the user dragging that frame by its header
dragging the top edge of the child frame above the top edge of its line. Setting @code{top-visible} to a number inhibits dragging the
parent. Set the @code{bottom-visible} parameter to a number when you top edge of the child frame above the top edge of its parent. Set the
intend to drag that frame via its mode line. This inhibits dragging the @code{bottom-visible} parameter to a number when you intend to drag
bottom edge of the child frame beneath the bottom edge of its parent. that frame via its mode line; this inhibits dragging the bottom edge
In either case, that number also specifies width and height (in pixels) of the child frame beneath the bottom edge of its parent. In either
of the area of the child frame that remains visible during dragging. case, that number also specifies width and height (in pixels) of the
area of the child frame that remains visible during dragging.
When a child frame is used for displaying a buffer via When a child frame is used for displaying a buffer via
@code{display-buffer-in-child-frame} (@pxref{Buffer Display Action @code{display-buffer-in-child-frame} (@pxref{Buffer Display Action