/[emacs]/emacs/lispref/positions.texi
ViewVC logotype

Diff of /emacs/lispref/positions.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.48 by teirllm, Sun Nov 21 14:37:29 2004 UTC revision 1.49 by rms, Sun Feb 6 10:54:05 2005 UTC
# Line 165  minibuffer. Line 165  minibuffer.
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
# Line 192  whether a given character is part of a w Line 189  whether a given character is part of a w
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
# Line 258  they set the mark and display messages i Line 258  they set the mark and display messages i
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}.
# Line 373  This function moves point forward @var{c Line 375  This function moves point forward @var{c
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
# Line 703  This function moves backward across @var Line 705  This function moves backward across @var
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
# Line 761  then advances point if the character mat Line 765  then advances point if the character mat
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

Legend:
Removed from v.1.48  
changed lines
  Added in v.1.49

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26