(Text Lines): Describe behavior of

`beginning-of-line'/`end-of-line' in the presence of field properties.

diff --git a/lispref/positions.texi b/lispref/positions.texi
index 67e33cb2cbe50be32650ff702bef13bbc24c3b92..fe056f7d6243c23005d02fd0c7bf873c5fd8705f 100644 (file)
--- 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,15 @@ 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,
+either bind @code{inhibit-field-text-motion} to @code{t}, or 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 +352,12 @@ 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.  To ignore field boundaries,
+bind @code{inhibit-field-text-motion} to @code{t}.
+
 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.