master bb72949: * lisp/window.el (display-buffer): Extend doc with body-function (bug#39822)

[Juri Linkov]

branch: master
commit bb729496f9b699896fed8d65bf499a193a7c4886
Author: Juri Linkov <address@hidden>
Commit: Juri Linkov <address@hidden>

    * lisp/window.el (display-buffer): Extend doc with body-function (bug#39822)
---
 doc/lispref/windows.texi | 9 +++++----
 lisp/window.el           | 6 ++++++
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 00142d8..af2f3ac 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -3053,10 +3053,11 @@ action function that cares about this entry.
 @item body-function
 The value must be a function taking one argument (a displayed window).
 This function can be used to fill the displayed window's body with
-some contents.  It is called @emph{after} the buffer is displayed, and
-@emph{before} the entries @code{window-height}, @code{window-width}
-and @code{preserve-size} are applied that could resize the window
-to fit it to the inserted contents.
+some contents that might depend on dimensions of the displayed window.
+It is called @emph{after} the buffer is displayed, and @emph{before}
+the entries @code{window-height}, @code{window-width} and
+@code{preserve-size} are applied that could resize the window to fit
+it to the inserted contents.
 @end table
 
 By convention, the entries @code{window-height}, @code{window-width}
diff --git a/lisp/window.el b/lisp/window.el
index 0121a78..8512a0e 100644
--- a/lisp/window.el
+++ b/lisp/window.el
@@ -7405,6 +7405,12 @@ Action alist entries are:
     parameters to give the chosen window.
  `allow-no-window' -- A non-nil value means that `display-buffer'
     may not display the buffer and return nil immediately.
+ `body-function' -- A function called with one argument - the
+    displayed window.  It is called after the buffer is
+    displayed, and before `window-height', `window-width'
+    and `preserve-size' are applied.  The function is supposed
+    to fill the window body with some contents that might depend
+    on dimensions of the displayed window.
 
 The entries `window-height', `window-width' and `preserve-size'
 are applied only when the window used for displaying the buffer