Mercurial > emacs
diff lispref/positions.texi @ 26696:ef5e7bbe6f19
Current version from /gd/gnu/elisp.
author | Dave Love <fx@gnu.org> |
---|---|
date | Fri, 03 Dec 1999 19:11:12 +0000 |
parents | 467b88fab665 |
children | 4b1a67a46d8c |
line wrap: on
line diff
--- a/lispref/positions.texi Fri Dec 03 19:08:52 1999 +0000 +++ b/lispref/positions.texi Fri Dec 03 19:11:12 1999 +0000 @@ -19,6 +19,9 @@ 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 @@ 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). +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. -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. +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 the minibuffer, the end of the prompt always acts as a word boundary, -regardless of what characters appear before and after it. - -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 @@ 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 @@ 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