mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-14 18:10:32 -08:00
Code Issues Projects Releases Wiki 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
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 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.
To avoid that dragging moves a frame completely out of its parent's When the mouse cursor overshoots, it's easy to drag a frame out of the
native frame, something which might happen when the mouse cursor screen area of its parent. Retrieving such a frame can be hairy once
overshoots and makes the frame difficult to retrieve once the mouse the mouse button has been released. To prevent such a situation, it is
button has been released, it is advisable to set the frame's advisable to set the frame's @code{top-visible} or @code{bottom-visible}
@code{top-visible} or @code{bottom-visible} parameter correspondingly. parameter (@pxref{Mouse Dragging Parameters}).
The @code{top-visible} parameter specifies the number of pixels at the Set the @code{top-visible} parameter of a child frame to a number when
top of the frame that always remain visible within the parent's native you intend to drag that frame via its header line. This inhibits
frame during dragging and should be set when specifying a non-@code{nil} dragging the top edge of the child frame above the top edge of its
@code{drag-with-header-line} parameter. The @code{bottom-visible} parent. Set the @code{bottom-visible} parameter to a number when you
parameter specifies the number of pixels at the bottom of the frame that intend to drag that frame via its mode line. This inhibits dragging the
always remain visible within the parent's native frame during dragging bottom edge of the child frame beneath the bottom edge of its parent.
and should be preferred when specifying a non-@code{nil} In either case, that number also specifies width and height (in pixels)
@code{drag-with-mode-line} parameter. 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