[Emacs-diffs] master 385fa75: Improve documentation of 'window-use-time'

[Eli Zaretskii]

branch: master
commit 385fa75721d6d1aa1d82b9e4f05f7a76a4f79845
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve documentation of 'window-use-time'
    
    * doc/lispref/windows.texi (Selecting Windows): Improve
    documentation and indexing of 'window-use-time'.
---
 doc/lispref/windows.texi |   10 +++++++---
 1 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index e53edb3..4656938 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -1727,11 +1727,15 @@ nor the buffer list.
 
 @cindex window use time
 @cindex use time of window
address@hidden window order by time of last use
 @defun window-use-time &optional window
-This functions returns the @dfn{use time} of window @var{window}.
+This functions returns the ``use time'' of window @var{window}.
 @var{window} must be a live window and defaults to the selected one.
-The window with the lowest use time is the least recently selected one.
-The window with the highest use time is the most recently selected one.
+The @dfn{use time} of a window is not really a time value, but it does
+increase monotonically with each window selection, so the window with
+the lowest ``use time'' is the least recently selected one, and the
+window with the highest ``use time'' is the most recently selected
+one.
 @end defun