mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-04 08:47:11 +00:00
Code Issues Releases Activity

Clarify description of two mouse dragging parameters (Bug#52537)

Browse Source 
* doc/lispref/frames.texi (Child Frames): Clarify description of
'top-visible' and 'bottom-visible' parameters (Bug#52537).
This commit is contained in:
Martin Rudalics 2021-12-19 17:59:15 +01:00
parent 5f25852e91
commit f11b996a3c
1 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
doc/lispref/frames.texi
View File

@ -3343,20 +3343,20 @@ are handy (@pxref{Window Parameters}). These allow to remove an
unwanted mode line (when @code{drag-with-header-line} is chosen) and to
remove mouse-sensitive areas which might interfere with frame dragging.
To avoid that dragging moves a frame completely out of its parent's
native frame, something which might happen when the mouse cursor
overshoots and makes the frame difficult to retrieve once the mouse
button has been released, it is advisable to set the frame's
@code{top-visible} or @code{bottom-visible} parameter correspondingly.
When the mouse cursor overshoots, it's easy to drag a frame out of the
screen area of its parent. Retrieving such a frame can be hairy once
the mouse button has been released. To prevent such a situation, it is
advisable to set the frame's @code{top-visible} or @code{bottom-visible}
parameter (@pxref{Mouse Dragging Parameters}).
The @code{top-visible} parameter specifies the number of pixels at the
top of the frame that always remain visible within the parent's native
frame during dragging and should be set when specifying a non-@code{nil}
@code{drag-with-header-line} parameter. The @code{bottom-visible}
parameter specifies the number of pixels at the bottom of the frame that
always remain visible within the parent's native frame during dragging
and should be preferred when specifying a non-@code{nil}
@code{drag-with-mode-line} parameter.
Set the @code{top-visible} parameter of a child frame to a number when
you intend to drag that frame via its header line. This inhibits
dragging the top edge of the child frame above the top edge of its
parent. Set the @code{bottom-visible} parameter to a number when you
intend to drag that frame via its mode line. This inhibits dragging the
bottom edge of the child frame beneath the bottom edge of its parent.
In either 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
@code{display-buffer-in-child-frame} (@pxref{Buffer Display Action