mirrors/foot
1
0
Fork 0
mirror of https://codeberg.org/dnkl/foot.git synced 2026-03-07 04:34:03 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

enhanced bell configuration

Browse source 
Add a separate section for bell configuration, with a bell-specific
command option and a setting to allow that command to run without regard
to keyboard focus (for those of us who enjoy being beeped at at all
times, for example). The actions are also no longer mutually exclusive;
this is primarily anticipating urgency support which cannot be
replicated outside the process (in server mode anyway) and would thus be
complementary to any notification or arbitrary command.
This commit is contained in:
Ryan Farley 2021-04-29 04:12:55 -05:00
parent 8cb95018c0
commit 5d71ccc174
5 changed files with 96 additions and 63 deletions
Download patch file Download diff file Expand all files Collapse all files

59
doc/foot.ini.5.scd
View file

@ -211,32 +211,6 @@ in this order:
Default: _no_.
*bell*
Action to perform when receiving a *BEL* character. Can be set to
either *set-urgency*, *notify* or *none*.
When set to *set-urgency*, the margins will be painted in red
whenever *BEL* is received while the window does *not* have
keyboard focus. Note that Wayland currently does not have an
_urgency_ hint like X11. The value *set-urgency* was chosen for
forward-compatibility in the hopes that a corresponding Wayland
protocol is added in the future (in which case foot will use that
instead of painting its margins red).
Applications can enable/disable this feature programmatically with
the *CSI ? 1042 h* and *CSI ? 1042 l* escape sequences.
_Note_: expect this feature to be *replaced* with proper
compositor urgency support once/if that gets implemented.
When set to *notify*, foot will emit a desktop notification using
the command specified in the *notify* option, but only if the foot
window does *not* have keyboard focus.
When set to *none*, no special action is taken when receiving *BEL*.
Default: _none_.
*word-delimiters*
String of characters that act as word delimiters when selecting
text. Note that whitespace characters are _always_ word
@ -288,6 +262,39 @@ in this order:
Default: _url-mode_
# SECTION: bell
*urgent*
When set to _true_, the margins will be painted in red
whenever *BEL* is received while the window does *not* have
keyboard focus. Note that Wayland currently does not have an
_urgency_ hint like X11. The name *urgent* was chosen for
forward-compatibility in the hopes that a corresponding Wayland
protocol is added in the future (in which case foot will use that
instead of painting its margins red).
Applications can enable/disable this feature programmatically with
the *CSI ? 1042 h* and *CSI ? 1042 l* escape sequences.
_Note_: expect this feature to be *replaced* with proper
compositor urgency support once/if that gets implemented.
Default: _false_
*notify*
When set to _true_, foot will emit a desktop notification using
the command specified in the *notify* option whenever *BEL* is
received and the window does *not* have keyboard focus. Default:
_false_
*command*
When set, foot will execute this command when *BEL* is received.
Default: none
*command-focused*
Whether to run the command on *BEL* even while focused. Default:
_false_
# SECTION: scrollback
*lines*