diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd index 68b350aa..0d25fe12 100644 --- a/doc/foot.ini.5.scd +++ b/doc/foot.ini.5.scd @@ -202,8 +202,9 @@ in this order: _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 (see - the *notify* option). + 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*. @@ -222,11 +223,14 @@ in this order: Command to execute to display a notification. _${title}_ and _${body}_ will be replaced with the notification's actual _title_ and _body_ (message content). - + Applications can trigger notifications in the following ways: - OSC 777: *\\e]777;notify;;<body>\\e\\\\* + Notifications are *inhibited* if the foot window has keyboard + focus. + Default: _notify-send -a foot -i foot ${title} ${body}_. *url-launch*