comparison lispref/positions.texi @ 27093:4b1a67a46d8c

*** empty log message ***

27092:60f5b0f50db9

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 specified by the numeric prefix
argument.
@end deffn

@deffn Command backward-word count

@c Emacs 19 feature
This variable affects the behavior of @code{forward-word} and everything
that uses it.  If it is non-@code{nil}, then characters in the
``escape'' and ``character quote'' syntax classes count as part of
words.  Otherwise, they do not.
@end defvar

@node Buffer End Motion
@subsection Motion to an End of the Buffer

@var{count}@minus{}1 lines and then to the beginning of the line.

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 (@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
@tindex line-beginning-position
Return the position that @code{(beginning-of-line @var{count})}

@var{count}@minus{}1 lines and then to the end of the line.

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
@tindex line-end-position
Return the position that @code{(end-of-line @var{count})}

27093:4b1a67a46d8c

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.

If @code{inhibit-field-text-motion} is non-@code{nil},
this function ignores field boundaries.

In an interactive call, @var{count} is specified by the numeric prefix
argument.
@end deffn

@deffn Command backward-word count

@c Emacs 19 feature
This variable affects the behavior of @code{forward-word} and everything
that uses it.  If it is non-@code{nil}, then characters in the
``escape'' and ``character quote'' syntax classes count as part of
words.  Otherwise, they do not.
@end defvar

@defvar inhibit-field-text-motion
@tindex inhibit-field-text-motion
If this variable is non-@code{nil}, certain motion functions including
@code{forward-word}, @code{forward-sentence}, and
@codef{forward-paragraph} ignore field boundaries.
@end defvar

@node Buffer End Motion
@subsection Motion to an End of the Buffer

@var{count}@minus{}1 lines and then to the beginning of the line.

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.
@end deffn

@defun line-beginning-position &optional count
@tindex line-beginning-position
Return the position that @code{(beginning-of-line @var{count})}

@var{count}@minus{}1 lines and then to the end of the line.

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.
@end deffn

@defun line-end-position &optional count
@tindex line-end-position
Return the position that @code{(end-of-line @var{count})}