comparison man/lispref/positions.texi @ 290:c9fe270a4101 r21-0b43

Import from CVS: tag r21-0b43
author cvs
date Mon, 13 Aug 2007 10:36:47 +0200
parents 7df0dd720c89
children 6cb5e14cd98e
comparison
equal deleted inserted replaced
289:6e6992ccc4b6 290:c9fe270a4101
470 use them heavily, Emacs provides caches which may improve the 470 use them heavily, Emacs provides caches which may improve the
471 performance of your code. @xref{Text Lines, cache-long-line-scans}. 471 performance of your code. @xref{Text Lines, cache-long-line-scans}.
472 472
473 473
474 @defun vertical-motion count &optional window 474 @defun vertical-motion count &optional window
475 This function moves point to the start of the screen line @var{count} 475 This function moves point to the start of the frame line @var{count}
476 screen lines down from the screen line containing point. If @var{count} 476 frame lines down from the frame line containing point. If @var{count}
477 is negative, it moves up instead. 477 is negative, it moves up instead.
478 478
479 @code{vertical-motion} returns the number of lines moved. The value may 479 @code{vertical-motion} returns the number of lines moved. The value may
480 be less in absolute value than @var{count} if the beginning or end of 480 be less in absolute value than @var{count} if the beginning or end of
481 the buffer was reached. 481 the buffer was reached.
482 482
483 The window @var{window} is used for obtaining parameters such as the 483 Note that @code{vertical-motion} sets @var{window}'s buffer's point, not
484 width, the horizontal scrolling, and the display table. But 484 @var{window}'s point. (This differs from FSF Emacs, which buggily always
485 @code{vertical-motion} always operates on the current buffer, even if 485 sets current buffer's point, regardless of @var{window}.)
486 @var{window} currently displays some other buffer. 486 @end defun
487
488 @defun vertical-motion-pixels count &optional window
489 This function is identical to @code{vertical-motion}, except that it
490 returns the vertical pixel height of the motino which took place,
491 instead of the actual number of lines moved. A motion of zero lines
492 returns the height of the current line.
487 @end defun 493 @end defun
488 494
489 @deffn Command move-to-window-line count &optional window 495 @deffn Command move-to-window-line count &optional window
490 This function moves point with respect to the text currently displayed 496 This function moves point with respect to the text currently displayed
491 in @var{window}, which defaults to the selected window. It moves point 497 in @var{window}, which defaults to the selected window. It moves point