From aa1a9332effa7b92ce0d9c41e7948b2410d9cf73 Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Tue, 23 Jul 2024 23:09:11 +0530 Subject: [PATCH] Allow closing notifications without a status return --- docs/desktop-notifications.rst | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/desktop-notifications.rst b/docs/desktop-notifications.rst index 772872bc3..8ac18cc4a 100644 --- a/docs/desktop-notifications.rst +++ b/docs/desktop-notifications.rst @@ -104,12 +104,16 @@ To close a previous notification, send:: i= : p=close ; This will close a previous notification with the specified id. If closing -succeeds, the terminal will send an escape code of the form:: +succeeds, or the notification was already closed, +the terminal will send an escape code of the form:: i= : p=close ; Closing is done on a best effort basis so applications must not rely on the -delivery of the closed escape code. +delivery of the closed escape code. If you do not want to receive an escape +code notifying you of closure, use:: + + i= : p=close_simple ; Querying for support ------------------------- @@ -178,9 +182,11 @@ Key Value Default Description direct responses to the correct window. ``p`` One of ``title``, ``title`` Whether the payload is the notification title or body or query. If a - ``body``, ``close`` notification has no title, the body will be used as title. Terminal - , ``?`` emulators should ignore payloads of unknown type to allow for future - expansion of this protocol. + ``body``, notification has no title, the body will be used as title. Terminal + ``close``, emulators should ignore payloads of unknown type to allow for future + ``close_simple``, expansion of this protocol. + ``?`` + ``o`` One of ``always``, ``always`` When to honor the notification request. ``unfocused`` means when the window ``unfocused`` or the notification is sent on does not have keyboard focus. ``invisible``