From 7c6686221f328e9399eb679c246662c801b2356b Mon Sep 17 00:00:00 2001 From: Daniel Eklöf Date: Thu, 8 Oct 2020 19:55:32 +0200 Subject: bell: optionally render margins in red when receiving BEL MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add anew config option, ‘bell=none|set-urgency’. When set to ‘set-urgency’, the margins will be painted in red (if the window did not have keyboard focus). This is intended as a cheap replacement for the ‘urgency’ hint, that doesn’t (yet) exist on Wayland. Closes #157 --- doc/foot.ini.5.scd | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) (limited to 'doc') diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd index 60da2d67..22b2adde 100644 --- a/doc/foot.ini.5.scd +++ b/doc/foot.ini.5.scd @@ -91,6 +91,22 @@ in this order: (including SMT). Note that this is not always the best value. In some cases, the number of physical _cores_ is better. +*bell* + Action to perform when receiving a *BEL* character. Can be set to + either *set-urgency* 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). + + When set to *none*, no special action is taken when receiving *BEL*. + + Default: _none_. + # SECTION: scrollback -- cgit v1.3 From f47d27968f7f4e32724657aaf525975f4ef5e902 Mon Sep 17 00:00:00 2001 From: Daniel Eklöf Date: Fri, 9 Oct 2020 07:39:53 +0200 Subject: doc: foot.ini: bell/urgency: add note about this getting replaced in the future MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The ‘set-urgency’ action is an interim workaround for lack of support of an urgency hint in Wayland compositors. If/when such a feature gets implemented in Wayland, I intend to use that instead of the current implementation in foot. --- doc/foot.ini.5.scd | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd index 22b2adde..496162e8 100644 --- a/doc/foot.ini.5.scd +++ b/doc/foot.ini.5.scd @@ -102,7 +102,10 @@ in this order: 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). - + + _Note_: expect this feature to be *replaced* with proper + compositor urgency support once/if that gets implemented. + When set to *none*, no special action is taken when receiving *BEL*. Default: _none_. -- cgit v1.3