(Text Lines): Describe behavior of `beginning-of-line'/`end-of-line' in

the presence of field properties.

1 files changed, 14 insertions, 1 deletions

diff --git a/lispref/positions.texi b/lispref/positions.texi
index 7d46f2cff1d..de83c86489a 100644
--- a/lispref/positions.texi
+++ b/lispref/positions.texi
@@ -1,6 +1,6 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000
+@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001
 @c  Free Software Foundation, Inc. 
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/positions
@@ -327,6 +327,14 @@ This function moves point to the beginning of the current line.  With an
 argument @var{count} not @code{nil} or 1, it moves forward
 @var{count}@minus{}1 lines and then to the beginning of the line.
 
+This command does not move point across a field boundary
+(@pxref{Fields}) unless doing so would move beyond there to a
+different line; if @var{count} is @code{nil} or 1, and point starts at
+a field boundary, point does not move.  To ignore field boundaries,
+use the @code{forward-line} function instead.  For instance,
+@code{(forward-line 0)} does the same thing as
+@code{(beginning-of-line)}, except that it ignores field boundaries.
+
 If this function reaches the end of the buffer (or of the accessible
 portion, if narrowing is in effect), it positions point there.  No error
 is signaled.
@@ -343,6 +351,11 @@ This function moves point to the end of the current line.  With an
 argument @var{count} not @code{nil} or 1, it moves forward
 @var{count}@minus{}1 lines and then to the end of the line.
 
+This command does not move point across a field boundary
+(@pxref{Fields}) unless doing so would move beyond there to a
+different line; if @var{count} is @code{nil} or 1, and point starts at
+a field boundary, point does not move.
+
 If this function reaches the end of the buffer (or of the accessible
 portion, if narrowing is in effect), it positions point there.  No error
 is signaled.