; 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:
parent
f200b3c910
commit
37b2c2fcdd
2 changed files with 9 additions and 5 deletions
|
@ -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
|
||||
|
|
7
etc/NEWS
7
etc/NEWS
|
@ -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'.
|
||||
|
|
Loading…
Add table
Reference in a new issue