[Emacs-diffs] /srv/bzr/emacs/trunk r109721: Document recent changes for select-window, window-point and set-window-point.

[martin rudalics]

------------------------------------------------------------
revno: 109721
committer: martin rudalics <address@hidden>
branch nick: trunk
timestamp: Tue 2012-08-21 11:50:58 +0200
message:
  Document recent changes for select-window, window-point and set-window-point.
  
  * windows.texi (Window Point): Document recent changes in
  window-point and set-window-point.
  (Selecting Windows): Document recent change in select-window.
modified:
  doc/lispref/ChangeLog
  doc/lispref/windows.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-08-10 07:00:40 +0000
+++ b/doc/lispref/ChangeLog     2012-08-21 09:50:58 +0000
@@ -1,3 +1,9 @@
+2012-08-21  Martin Rudalics  <address@hidden>
+
+       * windows.texi (Window Point): Document recent changes in
+       window-point and set-window-point.
+       (Selecting Windows): Document recent change in select-window.
+
 2012-08-06  Eli Zaretskii  <address@hidden>
 
        * functions.texi (Closures): Put the main index entry for

=== modified file 'doc/lispref/windows.texi'
--- a/doc/lispref/windows.texi  2012-06-17 05:13:40 +0000
+++ b/doc/lispref/windows.texi  2012-08-21 09:50:58 +0000
@@ -1129,16 +1129,15 @@
 
 @defun select-window window &optional norecord
 This function makes @var{window} the selected window, as well as the
-window selected within its frame (@pxref{Basic Windows}).
address@hidden must be a live window.  Unless @var{window} already is the
-selected window, its buffer becomes the current buffer (@pxref{Buffers
-and Windows}).  The return value is @var{window}.
+window selected within its frame (@pxref{Basic Windows}).  @var{window}
+must be a live window.  This function makes also @var{window}'s buffer
+current (@pxref{Buffers and Windows}).  The return value is
address@hidden
 
-By default, this function also moves @var{window}'s selected buffer to
-the front of the buffer list (@pxref{The Buffer List}), and makes
address@hidden the most recently selected window.  However, if the
-optional argument @var{norecord} is address@hidden, these additional
-actions are omitted.
+By default, this function also moves @var{window}'s buffer to the front
+of the buffer list (@pxref{The Buffer List}), and makes @var{window} the
+most recently selected window.  However, if the optional argument
address@hidden is address@hidden, these additional actions are omitted.
 @end defun
 
 @cindex most recently selected windows
@@ -2276,19 +2275,18 @@
 window's buffer) if that window were selected.  The default for
 @var{window} is the selected window.
 
-When @var{window} is the selected window and its buffer is also the
-current buffer, the value returned is the same as point in that buffer.
-Strictly speaking, it would be more correct to return the ``top-level''
-value of point, outside of any @code{save-excursion} forms.  But that
-value is hard to find.
+When @var{window} is the selected window, the value returned is the
+value of point in that window's buffer.  Strictly speaking, it would be
+more correct to return the ``top-level'' value of point, outside of any
address@hidden forms.  But that value is hard to find.
 @end defun
 
 @defun set-window-point window position
 This function positions point in @var{window} at position
 @var{position} in @var{window}'s buffer.  It returns @var{position}.
 
-If @var{window} is selected, and its buffer is current,
-this simply does @code{goto-char}.
+If @var{window} is selected, this simply does @code{goto-char} in
address@hidden's buffer.
 @end defun
 
 @defvar window-point-insertion-type