; Improve the documentation of a recent commit

* etc/NEWS:
* doc/lispref/frames.texi (Deleting Frames): Improve documentation
of 'frame-deletable-p'.

(cherry picked from commit 37b2c2fcdd9344f33f843d3fd5f9129babdf172f)

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 197f4c17b46600e1c585f346042e30026a99e0e2..73e6b6268d4fa8665ad3885907bc58ac5aaaeed5 100644 (file)
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -2839,8 +2839,11 @@ than deleted.
 @end deffn
 
 The following function checks whether a frame can be safely deleted.  It
-is useful to avoid that a subsequent call of @code{delete-frame} throws
-an error.
+is useful for avoiding the situation whereby a subsequent call of
+@code{delete-frame} fails to delete its argument @var{frame} and/or
+signals an error.  To that end, your Lisp program should call
+@code{delete-frame} only if the following function returns
+non-@code{nil}.
 
 @defun frame-deletable-p &optional frame
 This function returns non-@code{nil} if the frame specified by