X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/fdbc96cabad658b6299c6dad951f9b4b9b9d5c19..ad8d30b3d83547b1ac056cac3dd6e6721de8554e:/lispref/positions.texi diff --git a/lispref/positions.texi b/lispref/positions.texi index 3c1e642e6b..618886a40f 100644 --- a/lispref/positions.texi +++ b/lispref/positions.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001, +@c 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/positions @node Positions, Markers, Frames, Top @@ -123,6 +123,7 @@ size of @var{buffer}. @node Motion @section Motion +@cindex motion by characters, words, lines, lists Motion functions change the value of point, either relative to the current value of point, relative to the beginning or end of the buffer, @@ -228,7 +229,6 @@ 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 @code{forward-paragraph} ignore field boundaries. @@ -236,6 +236,7 @@ If this variable is non-@code{nil}, certain motion functions including @node Buffer End Motion @subsection Motion to an End of the Buffer +@cindex move to beginning or end of buffer To move point to the beginning of the buffer, write: @@ -345,7 +346,6 @@ is signaled. @end deffn @defun line-beginning-position &optional count -@tindex line-beginning-position Return the position that @code{(beginning-of-line @var{count})} would move to. @end defun @@ -367,7 +367,6 @@ is signaled. @end deffn @defun line-end-position &optional count -@tindex line-end-position Return the position that @code{(end-of-line @var{count})} would move to. @end defun @@ -417,7 +416,7 @@ Here is an example of using @code{count-lines}: @defun line-number-at-pos &optional pos @cindex line number This function returns the line number in the current buffer -corresponding the buffer position @var{pos}. If @var{pos} is @code{nil} +corresponding to the buffer position @var{pos}. If @var{pos} is @code{nil} or omitted, the current buffer position is used. @end defun @@ -636,7 +635,7 @@ the end of the accessible portion of the buffer, and pass @var{line} and When you use @code{compute-motion} for the minibuffer, you need to use @code{minibuffer-prompt-width} to get the horizontal position of the -beginning of the first screen line. @xref{Minibuffer Misc}. +beginning of the first screen line. @xref{Minibuffer Contents}. @end defun @node List Motion @@ -645,6 +644,7 @@ beginning of the first screen line. @xref{Minibuffer Misc}. @cindex sexp motion @cindex Lisp expression motion @cindex list motion +@cindex balanced-parenthesis expressions Here are several functions concerned with balanced-parenthesis expressions (also called @dfn{sexps} in connection with moving across @@ -680,7 +680,7 @@ deeper in parentheses (@minus{}@var{arg} levels). @deffn Command forward-sexp &optional arg This function moves forward across @var{arg} (default 1) balanced expressions. Balanced expressions include both those delimited by parentheses and -other kinds, such as words and string constants +other kinds, such as words and string constants. @xref{Parsing Expressions}. For example, @example @@ -720,11 +720,11 @@ to 1. @end deffn @defopt defun-prompt-regexp -If non-@code{nil}, this variable holds a regular expression that -specifies what text can appear before the open-parenthesis that starts a -defun. That is to say, a defun begins on a line that starts with a -match for this regular expression, followed by a character with -open-parenthesis syntax. +If non-@code{nil}, this buffer-local variable holds a regular +expression that specifies what text can appear before the +open-parenthesis that starts a defun. That is to say, a defun begins +on a line that starts with a match for this regular expression, +followed by a character with open-parenthesis syntax. @end defopt @defopt open-paren-in-column-0-is-defun-start @@ -735,14 +735,12 @@ The default is @code{t}. @end defopt @defvar beginning-of-defun-function -@tindex beginning-of-defun-function If non-@code{nil}, this variable holds a function for finding the beginning of a defun. The function @code{beginning-of-defun} calls this function instead of using its normal method. @end defvar @defvar end-of-defun-function -@tindex end-of-defun-function If non-@code{nil}, this variable holds a function for finding the end of a defun. The function @code{end-of-defun} calls this function instead of using its normal method. @@ -829,13 +827,13 @@ after the completion of the excursion. described elsewhere (see @ref{Window Configurations}, and @pxref{Frame Configurations}). -@defspec save-excursion forms@dots{} +@defspec save-excursion body@dots{} @cindex mark excursion @cindex point excursion @cindex current buffer excursion The @code{save-excursion} special form saves the identity of the current buffer and the values of point and the mark in it, evaluates -@var{forms}, and finally restores the buffer and its saved values of +@var{body}, and finally restores the buffer and its saved values of point and the mark. All three saved values are restored even in case of an abnormal exit via @code{throw} or error (@pxref{Nonlocal Exits}). @@ -855,8 +853,8 @@ One way to restore these correspondences, and the selected window, is to use @code{save-window-excursion} inside @code{save-excursion} (@pxref{Window Configurations}). -The value returned by @code{save-excursion} is the result of the last of -@var{forms}, or @code{nil} if no @var{forms} are given. +The value returned by @code{save-excursion} is the result of the last +form in @var{body}, or @code{nil} if no body forms were given. @example @group