; Improve the documentation of a recent commit

* etc/NEWS:
* doc/lispref/frames.texi (Deleting Frames): Improve documentation
of 'frame-deletable-p'.
This commit is contained in:
Eli Zaretskii 2025-04-19 09:11:57 +03:00
parent f200b3c910
commit 37b2c2fcdd
2 changed files with 9 additions and 5 deletions

View file

@ -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

View file

@ -315,9 +315,10 @@ helps to restore window buffers across Emacs sessions.
+++
*** New function 'frame-deletable-p'.
Calling this function before 'delete-frame' is useful to avoid how the
latter function signals an error when its FRAME argument cannot be
deleted.
If this function returns nil, the following call to 'delete-frame' might
fail to delete its argument FRAME or might signal an error. It is
therefore advisable to use this function as part of a condition that
determines whether to call 'delete-frame'.
+++
*** New value 'force' for user option 'frame-inhibit-implied-resize'.