mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-06 06:20:55 -08:00
Code Issues Projects Releases Wiki 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
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 (defcustom tab-bar-select-restore-windows #'tab-bar-select-restore-windows
"Function called when selecting a tab to handle windows whose buffer was killed. "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 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 this tab was last selected, this variable determines what to do with
that window. By default, either a random buffer is displayed instead of that window.
the killed buffer, or the window gets deleted. However, with the help
of `window-restore-killed-buffer-windows' it's possible to handle such If this variable is nil, there is no special handling;
situations better by displaying an information about the killed buffer." `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) :type '(choice (const :tag "No special handling" nil)
(const :tag "Show placeholder buffers" (const :tag "Show placeholder buffers"
tab-bar-select-restore-windows) tab-bar-select-restore-windows)