Current version from /gd/gnu/elisp.

1 files changed, 21 insertions, 12 deletions

diff --git a/lispref/positions.texi b/lispref/positions.texi
index 49c42bc1d3c..54d6ed543e4 100644
--- a/lispref/positions.texi
+++ b/lispref/positions.texi
@@ -19,6 +19,9 @@ also be represented as @dfn{markers}---special objects that relocate
 automatically when text is inserted or deleted so they stay with the
 surrounding characters.  @xref{Markers}.
 
+  See also the ``field'' feature (@pxref{Fields}), which provides
+functions that are used by many cursur-motion commands.
+
 @menu
 * Point::         The special position where editing takes place.
 * Motion::        Changing point.
@@ -185,18 +188,17 @@ whether a given character is part of a word.  @xref{Syntax Tables}.
 This function moves point forward @var{count} words (or backward if
 @var{count} is negative).  ``Moving one word'' means moving until point
 crosses a word-constituent character and then encounters a
-word-separator character (or the boundary of the accessible part of the
-buffer).
-
-If it is possible to move @var{count} words, without being stopped by
-the buffer boundary (except perhaps after the last word), the value is
-@code{t}.  Otherwise, the return value is @code{nil} and point stops
-at the buffer boundary.
+word-separator character.  However, this function cannot move point past
+the boundary of the accessible part of the buffer, or across a field
+boundary (@pxref{Fields}).  The most common case of a field boundary is
+the end of the prompt in the minibuffer.
 
-In the minibuffer, the end of the prompt always acts as a word boundary,
-regardless of what characters appear before and after it.
+If it is possible to move @var{count} words, without being stopped
+prematurely by the buffer boundary or a field boundary, the value is
+@code{t}.  Otherwise, the return value is @code{nil} and point stops at
+the buffer boundary or field boundary.
 
-In an interactive call, @var{count} is set to the numeric prefix
+In an interactive call, @var{count} is specified by the numeric prefix
 argument.
 @end deffn
 
@@ -317,8 +319,10 @@ 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.
 
-As a special feature, in the minibuffer, this command will not
-move back into the prompt, if it starts from after the prompt.
+This function does not move across a field boundary (@pxref{Fields}),
+unless it moves to another line beyond the one that contains the field
+boundary.  If @var{count} is zero, and point starts at a field boundary,
+then point does not move.
 @end deffn
 
 @defun line-beginning-position &optional count
@@ -335,6 +339,11 @@ argument @var{count} not @code{nil} or 1, it moves forward
 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.
+
+This function does not move across a field boundary, unless it moves to
+another line beyond the one that contains the field boundary.  If
+@var{count} is zero, and point starts at a field boundary, then point
+does not move.
 @end deffn
 
 @defun line-end-position &optional count