From: Gerd Moellmann <gerd@gnu.org>
Date: Fri, 19 Oct 2001 09:29:16 +0000 (+0000)
Subject: (Text Lines): Describe behavior of
X-Git-Tag: emacs-21.1~19
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e5f3aa904cc5947ce14d01c04636723789dda013;p=emacs.git

(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 67e33cb2cbe..fe056f7d624 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,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.