165 |
@c @kindex end-of-buffer |
@c @kindex end-of-buffer |
166 |
This function moves point @var{count} characters forward, towards the |
This function moves point @var{count} characters forward, towards the |
167 |
end of the buffer (or backward, towards the beginning of the buffer, if |
end of the buffer (or backward, towards the beginning of the buffer, if |
168 |
@var{count} is negative). If the function attempts to move point past |
@var{count} is negative). If @var{count} is @code{nil}, the default |
169 |
the beginning or end of the buffer (or the limits of the accessible |
is 1. |
170 |
portion, when narrowing is in effect), an error is signaled with error |
|
171 |
code @code{beginning-of-buffer} or @code{end-of-buffer}. |
If this attempts to move past the beginning or end of the buffer (or |
172 |
|
the limits of the accessible portion, when narrowing is in effect), it |
173 |
|
signals an error with error symbol @code{beginning-of-buffer} or |
174 |
|
@code{end-of-buffer}. |
175 |
|
|
176 |
In an interactive call, @var{count} is the numeric prefix argument. |
In an interactive call, @var{count} is the numeric prefix argument. |
177 |
@end deffn |
@end deffn |
178 |
|
|
179 |
@deffn Command backward-char &optional count |
@deffn Command backward-char &optional count |
180 |
This function moves point @var{count} characters backward, towards the |
This is just like @code{forward-char} except that it moves |
181 |
beginning of the buffer (or forward, towards the end of the buffer, if |
in the opposite direction. |
|
@var{count} is negative). If the function attempts to move point past |
|
|
the beginning or end of the buffer (or the limits of the accessible |
|
|
portion, when narrowing is in effect), an error is signaled with error |
|
|
code @code{beginning-of-buffer} or @code{end-of-buffer}. |
|
|
|
|
|
In an interactive call, @var{count} is the numeric prefix argument. |
|
182 |
@end deffn |
@end deffn |
183 |
|
|
184 |
@node Word Motion |
@node Word Motion |
189 |
|
|
190 |
@deffn Command forward-word &optional count |
@deffn Command forward-word &optional count |
191 |
This function moves point forward @var{count} words (or backward if |
This function moves point forward @var{count} words (or backward if |
192 |
@var{count} is negative). ``Moving one word'' means moving until point |
@var{count} is negative). If @var{count} is @code{nil}, it moves |
193 |
crosses a word-constituent character and then encounters a |
forward one word. |
194 |
word-separator character. However, this function cannot move point past |
|
195 |
the boundary of the accessible portion of the buffer, or across a field |
``Moving one word'' means moving until point crosses a |
196 |
boundary (@pxref{Fields}). The most common case of a field boundary is |
word-constituent character and then encounters a word-separator |
197 |
the end of the prompt in the minibuffer. |
character. However, this function cannot move point past the boundary |
198 |
|
of the accessible portion of the buffer, or across a field boundary |
199 |
|
(@pxref{Fields}). The most common case of a field boundary is the end |
200 |
|
of the prompt in the minibuffer. |
201 |
|
|
202 |
If it is possible to move @var{count} words, without being stopped |
If it is possible to move @var{count} words, without being stopped |
203 |
prematurely by the buffer boundary or a field boundary, the value is |
prematurely by the buffer boundary or a field boundary, the value is |
258 |
@deffn Command beginning-of-buffer &optional n |
@deffn Command beginning-of-buffer &optional n |
259 |
This function moves point to the beginning of the buffer (or the limits |
This function moves point to the beginning of the buffer (or the limits |
260 |
of the accessible portion, when narrowing is in effect), setting the |
of the accessible portion, when narrowing is in effect), setting the |
261 |
mark at the previous position. If @var{n} is non-@code{nil}, then it |
mark at the previous position (except in Transient Mark mode, if |
262 |
puts point @var{n} tenths of the way from the beginning of the |
the mark is already active, it does not set the mark.) |
|
accessible portion of the buffer. |
|
263 |
|
|
264 |
In an interactive call, @var{n} is the numeric prefix argument, |
If @var{n} is non-@code{nil}, then it puts point @var{n} tenths of the |
265 |
if provided; otherwise @var{n} defaults to @code{nil}. |
way from the beginning of the accessible portion of the buffer. In an |
266 |
|
interactive call, @var{n} is the numeric prefix argument, if provided; |
267 |
|
otherwise @var{n} defaults to @code{nil}. |
268 |
|
|
269 |
@strong{Warning:} Don't use this function in Lisp programs! |
@strong{Warning:} Don't use this function in Lisp programs! |
270 |
@end deffn |
@end deffn |
271 |
|
|
272 |
@deffn Command end-of-buffer &optional n |
@deffn Command end-of-buffer &optional n |
273 |
This function moves point to the end of the buffer (or the limits of the |
This function moves point to the end of the buffer (or the limits of |
274 |
accessible portion, when narrowing is in effect), setting the mark at |
the accessible portion, when narrowing is in effect), setting the mark |
275 |
the previous position. If @var{n} is non-@code{nil}, then it puts point |
at the previous position (except in Transient Mark mode when the mark |
276 |
@var{n} tenths of the way from the end of the accessible portion of the |
is already active). If @var{n} is non-@code{nil}, then it puts point |
277 |
buffer. |
@var{n} tenths of the way from the end of the accessible portion of |
278 |
|
the buffer. |
279 |
|
|
280 |
In an interactive call, @var{n} is the numeric prefix argument, |
In an interactive call, @var{n} is the numeric prefix argument, |
281 |
if provided; otherwise @var{n} defaults to @code{nil}. |
if provided; otherwise @var{n} defaults to @code{nil}. |
375 |
the line. If @var{count} is negative, it moves point |
the line. If @var{count} is negative, it moves point |
376 |
@minus{}@var{count} lines backward, to the beginning of a line. If |
@minus{}@var{count} lines backward, to the beginning of a line. If |
377 |
@var{count} is zero, it moves point to the beginning of the current |
@var{count} is zero, it moves point to the beginning of the current |
378 |
line. |
line. If @var{count} is @code{nil}, that means 1. |
379 |
|
|
380 |
If @code{forward-line} encounters the beginning or end of the buffer (or |
If @code{forward-line} encounters the beginning or end of the buffer (or |
381 |
of the accessible portion) before finding that many lines, it sets point |
of the accessible portion) before finding that many lines, it sets point |
705 |
@deffn Command beginning-of-defun &optional arg |
@deffn Command beginning-of-defun &optional arg |
706 |
This function moves back to the @var{arg}th beginning of a defun. If |
This function moves back to the @var{arg}th beginning of a defun. If |
707 |
@var{arg} is negative, this actually moves forward, but it still moves |
@var{arg} is negative, this actually moves forward, but it still moves |
708 |
to the beginning of a defun, not to the end of one. |
to the beginning of a defun, not to the end of one. @var{arg} defaults |
709 |
|
to 1. |
710 |
@end deffn |
@end deffn |
711 |
|
|
712 |
@deffn Command end-of-defun &optional arg |
@deffn Command end-of-defun &optional arg |
713 |
This function moves forward to the @var{arg}th end of a defun. If |
This function moves forward to the @var{arg}th end of a defun. If |
714 |
@var{arg} is negative, this actually moves backward, but it still moves |
@var{arg} is negative, this actually moves backward, but it still moves |
715 |
to the end of a defun, not to the beginning of one. |
to the end of a defun, not to the beginning of one. @var{arg} defaults |
716 |
|
to 1. |
717 |
@end deffn |
@end deffn |
718 |
|
|
719 |
@defopt defun-prompt-regexp |
@defopt defun-prompt-regexp |
765 |
continues until it reaches a character that does not match. The |
continues until it reaches a character that does not match. The |
766 |
function returns the number of characters moved over. |
function returns the number of characters moved over. |
767 |
|
|
768 |
The argument @var{character-set} is like the inside of a |
The argument @var{character-set} is a string, like the inside of a |
769 |
@samp{[@dots{}]} in a regular expression except that @samp{]} is never |
@samp{[@dots{}]} in a regular expression except that @samp{]} does not |
770 |
special and @samp{\} quotes @samp{^}, @samp{-} or @samp{\}. Thus, |
terminate it, and @samp{\} quotes @samp{^}, @samp{-} or @samp{\}. |
771 |
@code{"a-zA-Z"} skips over all letters, stopping before the first |
Thus, @code{"a-zA-Z"} skips over all letters, stopping before the |
772 |
nonletter, and @code{"^a-zA-Z"} skips nonletters stopping before the |
first nonletter, and @code{"^a-zA-Z"} skips nonletters stopping before |
773 |
first letter. @xref{Regular Expressions}. |
the first letter. @xref{Regular Expressions}. |
774 |
|
|
775 |
If @var{limit} is supplied (it must be a number or a marker), it |
If @var{limit} is supplied (it must be a number or a marker), it |
776 |
specifies the maximum position in the buffer that point can be skipped |
specifies the maximum position in the buffer that point can be skipped |