mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-21 13:10:37 -08:00
Code Issues Projects Releases Wiki Activity

* lisp/tab-bar.el: Doc fixes for commands bound to modifier keys.

Browse source 
(tab-bar-select-tab-modifiers)
(tab-bar-select-tab, tab-bar-switch-to-last-tab): Doc fixes.
This commit is contained in:
Juri Linkov 2021-11-16 22:40:45 +02:00
parent e852822f3d
commit 38d905abf9
1 changed files with 12 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

19
lisp/tab-bar.el
View file

@ -91,9 +91,10 @@
(defcustom tab-bar-select-tab-modifiers '() (defcustom tab-bar-select-tab-modifiers '()
"List of modifier keys for selecting tab-bar tabs by their numbers. "List of modifier keys for selecting tab-bar tabs by their numbers.
Possible modifier keys are `control', `meta', `shift', `hyper', `super' and Possible modifier keys are `control', `meta', `shift', `hyper', `super' and
`alt'. Pressing one of the modifiers in the list and a digit selects `alt'. Pressing one of the modifiers in the list and a digit selects the
the tab whose number equals the digit. Negative numbers count from tab whose number equals the digit (see `tab-bar-select-tab').
the end of the tab bar. The digit 9 selects the last (rightmost) tab. The digit 9 selects the last (rightmost) tab (see `tab-last').
The digit 0 selects the most recently visited tab (see `tab-recent').
For easier selection of tabs by their numbers, consider customizing For easier selection of tabs by their numbers, consider customizing
`tab-bar-tab-hints', which will show tab numbers alongside the tab name." `tab-bar-tab-hints', which will show tab numbers alongside the tab name."
:type '(set :tag "Tab selection modifier keys" :type '(set :tag "Tab selection modifier keys"
@ -1060,11 +1061,14 @@ inherits the current tab's `explicit-name' parameter."
(defun tab-bar-select-tab (&optional tab-number) (defun tab-bar-select-tab (&optional tab-number)
"Switch to the tab by its absolute position TAB-NUMBER in the tab bar. "Switch to the tab by its absolute position TAB-NUMBER in the tab bar.
When this command is bound to a numeric key (with a prefix or modifier key When this command is bound to a numeric key (with a key prefix or modifier key
using `tab-bar-select-tab-modifiers'), calling it without an argument using `tab-bar-select-tab-modifiers'), calling it without an argument
will translate its bound numeric key to the numeric argument. will translate its bound numeric key to the numeric argument.
TAB-NUMBER counts from 1. Negative TAB-NUMBER counts tabs from the end of Also the prefix argument TAB-NUMBER can be used to override
the tab bar." the numeric key, so it takes precedence over the bound digit key.
For example, `<MODIFIER>-2' will select the second tab, but `C-u 15
<MODIFIER>-2' will select the 15th tab. TAB-NUMBER counts from 1.
Negative TAB-NUMBER counts tabs from the end of the tab bar."
(interactive "P") (interactive "P")
(unless (integerp tab-number) (unless (integerp tab-number)
(let ((key (event-basic-type last-command-event))) (let ((key (event-basic-type last-command-event)))
@ -1161,7 +1165,8 @@ Interactively, ARG is the prefix numeric argument and defaults to 1."
(defun tab-bar-switch-to-last-tab (&optional arg) (defun tab-bar-switch-to-last-tab (&optional arg)
"Switch to the last tab or ARGth tab from the end of the tab bar. "Switch to the last tab or ARGth tab from the end of the tab bar.
Interactively, ARG is the prefix numeric argument; it defaults to 1, Interactively, ARG is the prefix numeric argument; it defaults to 1,
which means the last tab on the tab bar." which means the last tab on the tab bar. For example, `C-u 2
<MODIFIER>-9' selects the tab before the last tab."
(interactive "p") (interactive "p")
(tab-bar-select-tab (- (length (funcall tab-bar-tabs-function)) (tab-bar-select-tab (- (length (funcall tab-bar-tabs-function))
(1- (or arg 1))))) (1- (or arg 1)))))