all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#32863: Unsatisfactory "definition" of "vertical scroll position" in Emacs lisp manual and doc string of window-vscroll
@ 2018-09-28 15:28 Alan Mackenzie
  2018-09-28 21:41 ` Eli Zaretskii
  0 siblings, 1 reply; 7+ messages in thread
From: Alan Mackenzie @ 2018-09-28 15:28 UTC (permalink / raw)
  To: 32863

Hello, Emacs.

In the Emacs-26.1 Emacs Lisp manual, on page "Vertical Scrolling" there
is an ostensible definition for "vertical scroll position".

This "definition" says it "is a number, never less than zero.  It
specifies how far to raise the contents of the window."

What should be doing this raising?  When might it do this?  For what
purpose might the contents of the window be raised?

I find this "definition" totally obscure.  I can not make sense of it at
all.  Without understanding what "vertical scroll position" means, the
entire manual page is meaningless.

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

I came to this manual page through not understanding the doc string for
the function window-vscroll.  This says just "Return the amount by which
WINDOW is scrolled vertically.".

_Is_ scrolled vertically.  What on earth does that mean?  What is the
zero point from which this scrolling is measured?  Does this "is" refer
to the current visible scrolling, or the intended scrolling after the
next redisplay?

This doc string needs clarification.

-- 
Alan Mackenzie (Nuremberg, Germany).





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

end of thread, other threads:[~2018-10-15 19:13 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2018-09-28 15:28 bug#32863: Unsatisfactory "definition" of "vertical scroll position" in Emacs lisp manual and doc string of window-vscroll Alan Mackenzie
2018-09-28 21:41 ` Eli Zaretskii
2018-10-15 11:48   ` Alan Mackenzie
2018-10-15 15:32     ` Eli Zaretskii
2018-10-15 18:33       ` Alan Mackenzie
2018-10-15 18:47         ` Eli Zaretskii
2018-10-15 19:13           ` Alan Mackenzie

Code repositories for project(s) associated with this external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.