mirrors/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty synced 2026-07-26 18:22:09 +02:00
Code Issues Packages Projects Releases Wiki Activity

Clarify that i=0 is a special case for notification activated reports only

Browse Source
This commit is contained in:
Kovid Goyal
2024-07-31 15:15:24 +05:30
parent f61635838e
commit f4b39b8db4
1 changed files with 7 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/desktop-notifications.rst
View File

@@ -136,7 +136,10 @@ escape code to inform when the notification is closed::
<OSC> 99 ; i=mynotification : p=close ; <terminator> <OSC> 99 ; i=mynotification : p=close ; <terminator>
If no notification id was specified ``i=0`` will be used. If no notification id was specified ``i=0`` will be used in the response
(Ideally ``i`` should have been left out from the response, but for backwards
compatibility ``i=0`` is used).
If ``a=report`` is specified and the notification is activated/clicked on If ``a=report`` is specified and the notification is activated/clicked on
then both the activation report and close notification are sent. If the notification then both the activation report and close notification are sent. If the notification
is updated then the close event is not sent unless the updated notification is updated then the close event is not sent unless the updated notification
@@ -375,7 +378,7 @@ Key Value Default Description
``g`` :ref:`identifier` ``unset`` Identifier for icon data. Make these globally unqiue, ``g`` :ref:`identifier` ``unset`` Identifier for icon data. Make these globally unqiue,
like an UUID. like an UUID.
``i`` :ref:`identifier` ``0`` Identifier for the notification. Make these globally unqiue, ``i`` :ref:`identifier` ``unset`` Identifier for the notification. Make these globally unqiue,
like an UUID, so that terminal multiplexers can like an UUID, so that terminal multiplexers can
direct responses to the correct window. direct responses to the correct window.
@@ -456,4 +459,5 @@ Identifier
Any string consisting solely of characters from the set ``[a-zA-Z0-9_-+.]``, Any string consisting solely of characters from the set ``[a-zA-Z0-9_-+.]``,
that is, the letters ``a-z``, ``A-Z``, the underscore, the hyphen, the plus that is, the letters ``a-z``, ``A-Z``, the underscore, the hyphen, the plus
sign and the period. sign and the period. Applications should make these globally unique, like a
UUID for maximum robustness.