diff options
Diffstat (limited to 'doc/lispref/positions.texi')
-rw-r--r-- | doc/lispref/positions.texi | 60 |
1 files changed, 12 insertions, 48 deletions
diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi index 1d748b87529..b88e76e8230 100644 --- a/doc/lispref/positions.texi +++ b/doc/lispref/positions.texi @@ -191,25 +191,18 @@ in the opposite direction. @node Word Motion @subsection Motion by Words - The functions for parsing words described below use the syntax table -to decide whether a given character is part of a word. @xref{Syntax -Tables}. + These functions for parsing words use the syntax table to decide +whether a given character is part of a word. @xref{Syntax Tables}. @deffn Command forward-word &optional count This function moves point forward @var{count} words (or backward if @var{count} is negative). If @var{count} is omitted or @code{nil}, it -defaults to 1. In an interactive call, @var{count} is specified by -the numeric prefix argument. +defaults to 1. ``Moving one word'' means moving until point crosses a -word-constituent character, which indicates the beginning of a word, -and then continue moving until the word ends. By default, characters -that begin and end words, known as @dfn{word boundaries}, are defined -by the current buffer's syntax table (@pxref{Syntax Class Table}), but -modes can override that by setting up a suitable -@code{find-word-boundary-function-table}, described below. In any -case, this function cannot move point past the boundary of the -accessible portion of the buffer, or across a field boundary +word-constituent character and then encounters a word-separator +character. However, this function cannot move point past the boundary +of the accessible portion 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. @@ -221,6 +214,8 @@ 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 &optional count @@ -230,10 +225,10 @@ backward until encountering the front of a word, rather than forward. @defopt words-include-escapes @c Emacs 19 feature -This variable affects the behavior of @code{forward-word} and -@code{backward-word}, and everything that uses them. 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. +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 defopt @defvar inhibit-field-text-motion @@ -242,37 +237,6 @@ If this variable is non-@code{nil}, certain motion functions including @code{forward-paragraph} ignore field boundaries. @end defvar -@defvar find-word-boundary-function-table -This variable affects the behavior of @code{forward-word} and -@code{backward-word}, and everything that uses them. Its value is a -char-table (@pxref{Char-Tables}) of functions to search for word -boundaries. If a character has a non-@code{nil} entry in this table, -then when a word starts or ends with that character, the corresponding -function will be called with 2 arguments: @var{pos} and @var{limit}. -The function should return the position of the other word boundary. -Specifically, if @var{pos} is smaller than @var{limit}, then @var{pos} -is at the beginning of a word, and the function should return the -position after the last character of the word; otherwise, @var{pos} is -at the last character of a word, and the function should return the -position of that word's first character. -@end defvar - -@defun forward-word-strictly &optional count -This function is like @code{forward-word}, but it is not affected by -@code{find-word-boundary-function-table}. Lisp programs that should -not change behavior when word movement is modified by modes which set -that table, such as @code{subword-mode}, should use this function -instead of @code{forward-word}. -@end defun - -@defun backward-word-strictly &optional count -This function is like @code{backward-word}, but it is not affected by -@code{find-word-boundary-function-table}. Like with -@code{forward-word-strictly}, use this function instead of -@code{backward-word} when movement by words should only consider -syntax tables. -@end defun - @node Buffer End Motion @subsection Motion to an End of the Buffer @cindex move to beginning or end of buffer |