From ea30ce4f232a5b21b14ab5d9338a1f4cf4639b37 Mon Sep 17 00:00:00 2001 From: Chong Yidong Date: Sun, 5 Apr 2009 05:11:48 +0000 Subject: [PATCH] * positions.texi (Screen Lines): Document (cols . lines) argument for vertical-motion. --- doc/lispref/ChangeLog | 5 +++++ doc/lispref/positions.texi | 11 ++++++++--- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 35467cf747a..ebd2f54d07d 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,8 @@ +2009-04-05 Chong Yidong + + * positions.texi (Screen Lines): Document (cols . lines) argument + for vertical-motion. + 2009-04-04 Chong Yidong * frames.texi (Frames): Clean up introduction. Document `ns' diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi index a74a4ab8098..06b696ea3a4 100644 --- a/doc/lispref/positions.texi +++ b/doc/lispref/positions.texi @@ -520,9 +520,14 @@ This function moves point to the start of the screen line @var{count} screen lines down from the screen line containing point. If @var{count} is negative, it moves up instead. -@code{vertical-motion} returns the number of screen lines over which it -moved point. The value may be less in absolute value than @var{count} -if the beginning or end of the buffer was reached. +The @var{count} argument can be a cons cell, @code{(@var{cols} +. @var{lines})}, instead of an integer. Then the function moves by +@var{lines} screen lines, and puts point @var{cols} columns from the +start of that screen line. + +The return value is the number of screen lines over which point was +moved. The value may be less in absolute value than @var{count} if +the beginning or end of the buffer was reached. The window @var{window} is used for obtaining parameters such as the width, the horizontal scrolling, and the display table. But -- 2.39.5