* positions.texi (Screen Lines): Document (cols . lines) argument

for vertical-motion.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 35467cf747adfe469c352dfd614377c131d8a3db..ebd2f54d07d7a965d2b5de102d2d515c1c4d1e0e 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2009-04-05  Chong Yidong  <cyd@stupidchicken.com>
+
+       * positions.texi (Screen Lines): Document (cols . lines) argument
+       for vertical-motion.
+
 2009-04-04  Chong Yidong  <cyd@stupidchicken.com>
 
        * frames.texi (Frames): Clean up introduction.  Document `ns'

diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi
index a74a4ab8098c94d0b266b2b0538d8defe4b53249..06b696ea3a42bb760028e82cb62ba73c0f11907e 100644 (file)
--- 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