masscollaborationlabs/emacs
2
0
Fork 0
mirror of https://github.com/masscollaborationlabs/emacs.git synced 2025-07-04 03:13:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

; Improve documentation of 'modifier-bar-mode'

Browse source 
* doc/emacs/custom.texi (Modifier Keys):
* doc/emacs/frames.texi (Tool Bars):
* lisp/tool-bar.el (modifier-bar-mode): Improve documentation of
'modifier-bar-mode'.
This commit is contained in:
Eli Zaretskii 2025-04-24 12:32:02 +03:00
parent a975232c0f
commit 49ea1f64c7
3 changed files with 22 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

4
doc/emacs/custom.texi
View file

@ -2164,6 +2164,10 @@ You can similarly enter the Shift, Control, and Meta modifiers by
using @kbd{C-x @@ S}, @kbd{C-x @@ c}, and @kbd{C-x @@ m}, respectively,
although this is rarely needed.
On graphical terminals, you can enable the Modifier Bar mode, which
allows simulating the missing modifier keys by clicking a tool-bar
button. @xref{Tool Bars}.
@node Function Keys
@subsection Rebinding Function Keys

21
doc/emacs/frames.texi
View file

@ -1343,15 +1343,18 @@ displayed by moving the mouse pointer to the top of the screen.
@cindex displaying modifier keys in the tool bar
@cindex mode, Modifier Bar
@cindex Modifier Bar
Keyboards often lack one or more of the modifier keys that Emacs
might want to use, making it difficult or impossible to input key
sequences that contain them. Emacs can optionally display a list of
buttons that act as substitutes for modifier keys within the tool bar;
these buttons are also referred to as the ``modifier bar''. Clicking
an icon within the modifier bar will cause a modifier key to be
applied to the next keyboard event that is read. The modifier bar is
displayed when the global minor mode @code{modifier-bar-mode} is
enabled; to do so, type @kbd{M-x modifier-bar-mode}.
Keyboards often lack one or more of the modifier keys (@pxref{Modifier
Keys}) that Emacs users might want to use, making it difficult or
impossible to input key sequences with these modifiers. For example,
many keyboards lack the Hyper and Super modifiers, and smartphones
usually also lack Ctrl and Alt modifiers. Emacs can optionally display
a tool bar of buttons that can substitute the modifier keys; this
additional tool bar is known as the @dfn{modifier bar}. Clicking a
button within the modifier bar will cause the modifier key shown on the
button to be applied to the next keyboard event that Emacs reads. The
modifier bar is displayed when the global minor mode
@code{modifier-bar-mode} is enabled; to do so, type @kbd{M-x
modifier-bar-mode}.
@node Tab Bars
@section Tab Bars

11
lisp/tool-bar.el
View file

@ -532,12 +532,13 @@ decoding the current key sequence, nil otherwise."
(not (memq modifier modifier-bar-modifier-list)))
(define-minor-mode modifier-bar-mode
"Toggle display of the modifier bar.
"Toggle display of the key-modifier tool bar.
When enabled, a small tool bar will be displayed next to the tool
bar containing items bound to
`tool-bar-event-apply-control-modifier' and its related commands,
which see."
When enabled, a small tool bar will be displayed in addition to the
regular tool bar, containing buttons for key modifiers such as
Ctrl, Shift, Alt, etc. This is useful on terminals whose keyboard
has no keys for these modifiers, such as smartphones and other
devices with small keyboards."
:init-value nil
:global t
:group 'tool-bar