unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#52537: [DOC] ‘top-visible’ and ‘bottom-visible’ (erroneous indications)
@ 2021-12-16  5:58 Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
  2021-12-16  8:15 ` Eli Zaretskii
  2021-12-16  8:43 ` martin rudalics
  0 siblings, 2 replies; 8+ messages in thread
From: Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2021-12-16  5:58 UTC (permalink / raw)
  To: 52537

In the Emacs Lisp Reference Manual, section 29.14 Child Frames, a
paragraph contains some errors about ‘top-visible’ and ‘bottom-visible’.

#+begin_quote
The ‘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-‘nil’
‘drag-with-header-line’ parameter.  The ‘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-‘nil’ ‘drag-with-mode-line’
parameter.
#+end_quote

The correct description is given in the Emacs Lisp Reference
Manual, section 29.4.3.7 Mouse Dragging Parameters.

#+begin_quote
‘top-visible’
     If this parameter is a number, >>the top edge of the frame never
     appears above the top edge<< of its display or parent frame.
     Moreover, as many pixels of the frame as specified by that number
     will remain visible >>when the frame is moved against any of the
     remaining edges<< of its display or parent frame.  Setting this
     parameter is useful to guard against dragging a child frame with a
     non-‘nil’ ‘drag-with-header-line’ parameter completely out of the
     area of its parent frame.

‘bottom-visible’
     If this parameter is a number, >>the bottom edge of the frame never
     appears below the bottom edge<< of its display or parent frame.
     Moreover, as many pixels of the frame as specified by that number
     will remain visible >>when the frame is moved against any of the
     remaining edges<< of its display or parent frame.  Setting this
     parameter is useful to guard against dragging a child frame with a
     non-‘nil’ ‘drag-with-mode-line’ parameter completely out of the
     area of its parent frame.
#+end_quote

We may move the child frame with the mouse but not above (below) the top
(bottom) edge of the native frame of the parent frame: this is the role
of ‘top-visible’ (‘bottom-visible’) parameter.
-- 
Best regards,
Kevin Vigouroux





^ permalink raw reply	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2021-12-19 17:04 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-12-16  5:58 bug#52537: [DOC] ‘top-visible’ and ‘bottom-visible’ (erroneous indications) Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-12-16  8:15 ` Eli Zaretskii
2021-12-16 11:11   ` Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-12-16 11:20     ` Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-12-16  8:43 ` martin rudalics
2021-12-16 11:35   ` Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-12-19 17:04     ` martin rudalics
2021-12-19 12:11   ` Lars Ingebrigtsen

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).