mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-21 06:55:39 +00:00
Code Issues Releases Activity

* lisp/tab-bar.el (tab-bar-select-restore-windows): Improve the docstring.

Browse Source 
Suggested by Kévin Le Gouguec <kevin.legouguec@gmail.com> in bug#71779.
This commit is contained in:
Juri Linkov 2024-06-27 19:57:18 +03:00
parent c1e7569a92
commit 339310d020
1 changed files with 14 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
lisp/tab-bar.el
View File

@ -1455,11 +1455,20 @@ and the newly selected tab."
(defcustom tab-bar-select-restore-windows #'tab-bar-select-restore-windows
"Function called when selecting a tab to handle windows whose buffer was killed.
When a tab-bar tab displays a window whose buffer was killed since
this tab was last selected, this function determines what to do with
that window. By default, either a random buffer is displayed instead of
the killed buffer, or the window gets deleted. However, with the help
of `window-restore-killed-buffer-windows' it's possible to handle such
situations better by displaying an information about the killed buffer."
this tab was last selected, this variable determines what to do with
that window.
If this variable is nil, there is no special handling;
`set-window-configuration' will decide what to do with the window,
then either a random buffer is displayed instead of the killed buffer,
or the window gets deleted.
If this variable is a function, display another buffer in that window,
and pass that buffer to the function. See the variable
`window-restore-killed-buffer-windows' for the calling convention.
By default, `tab-bar-select-restore-windows' displays a placeholder buffer
in the same window to give information about the killed buffer."
:type '(choice (const :tag "No special handling" nil)
(const :tag "Show placeholder buffers"
tab-bar-select-restore-windows)