Mercurial > hg > xemacs-beta

comparison man/lispref/positions.texi @ 446:1ccc32a20af4 r21-2-38

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r21-2-38
author cvs
date Mon, 13 Aug 2007 11:37:21 +0200
parents 576fb035e263
children 0ac5faff7095
comparison
equal deleted inserted replaced
445:34f3776fcf0e 446:1ccc32a20af4
191 @subsection Motion by Words 191 @subsection Motion by Words
192 192
193 These functions for parsing words use the syntax table to decide 193 These functions for parsing words use the syntax table to decide
194 whether a given character is part of a word. @xref{Syntax Tables}. 194 whether a given character is part of a word. @xref{Syntax Tables}.
195 195
196 @deffn Command forward-word count &optional buffer 196 @deffn Command forward-word &optional count buffer
197 This function moves point forward @var{count} words (or backward if 197 This function moves point forward @var{count} words (or backward if
198 @var{count} is negative). Normally it returns @code{t}. If this motion 198 @var{count} is negative). Normally it returns @code{t}. If this motion
199 encounters the beginning or end of the buffer, or the limits of the 199 encounters the beginning or end of the buffer, or the limits of the
200 accessible portion when narrowing is in effect, point stops there and 200 accessible portion when narrowing is in effect, point stops there and
201 the value is @code{nil}. @var{buffer} defaults to the current buffer if 201 the value is @code{nil}.
202 omitted. 202
203 @var{count} defaults to @code{1} and @var{buffer} defaults to the
204 current buffer.
203 205
204 In an interactive call, @var{count} is set to the numeric prefix 206 In an interactive call, @var{count} is set to the numeric prefix
205 argument. 207 argument.
206 @end deffn 208 @end deffn
207 209
208 @deffn Command backward-word count &optional buffer 210 @deffn Command backward-word &optional count buffer
209 This function is just like @code{forward-word}, except that it moves 211 This function is just like @code{forward-word}, except that it moves
210 backward until encountering the front of a word, rather than forward. 212 backward until encountering the front of a word, rather than forward.
211 @var{buffer} defaults to the current buffer if omitted. 213 @var{buffer} defaults to the current buffer if omitted.
212 214
213 In an interactive call, @var{count} is set to the numeric prefix 215 In an interactive call, @var{count} is set to the numeric prefix
214 argument. 216 argument.
215
216 This function is rarely used in programs, as it is more efficient to
217 call @code{forward-word} with a negative argument.
218 @end deffn 217 @end deffn
219 218
220 @defvar words-include-escapes 219 @defvar words-include-escapes
221 @c Emacs 19 feature 220 @c Emacs 19 feature
222 This variable affects the behavior of @code{forward-word} and everything 221 This variable affects the behavior of @code{forward-word} and everything
610 Here are several functions concerned with balanced-parenthesis 609 Here are several functions concerned with balanced-parenthesis
611 expressions (also called @dfn{sexps} in connection with moving across 610 expressions (also called @dfn{sexps} in connection with moving across
612 them in XEmacs). The syntax table controls how these functions interpret 611 them in XEmacs). The syntax table controls how these functions interpret
613 various characters; see @ref{Syntax Tables}. @xref{Parsing 612 various characters; see @ref{Syntax Tables}. @xref{Parsing
614 Expressions}, for lower-level primitives for scanning sexps or parts of 613 Expressions}, for lower-level primitives for scanning sexps or parts of
615 sexps. For user-level commands, see @ref{Lists and Sexps,,, emacs, XEmacs 614 sexps. For user-level commands, see @ref{Lists and Sexps,,, xemacs, XEmacs
616 Reference Manual}. 615 Reference Manual}.
617 616
618 @deffn Command forward-list &optional arg 617 @deffn Command forward-list &optional arg
619 This function moves forward across @var{arg} balanced groups of 618 This function moves forward across @var{arg} balanced groups of
620 parentheses. (Other syntactic entities such as words or paired string 619 parentheses. (Other syntactic entities such as words or paired string