From b940b2703c3fe207470de2a45ddc35bae461c62e Mon Sep 17 00:00:00 2001
From: Nikos Tsipinakis <nikos@tsipinakis.com>
Date: Wed, 27 Mar 2019 11:21:09 +0200
Subject: [PATCH] Document {match,set}_transient

---
 docs/dunst.pod |  8 ++++++--
 dunstrc        | 18 ++++++++++++++++--
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/docs/dunst.pod b/docs/dunst.pod
index 1cc6d8e..84b253e 100644
--- a/docs/dunst.pod
+++ b/docs/dunst.pod
@@ -235,8 +235,8 @@ See TIME FORMAT for valid times.
 
 Set to 0 to disable.
 
-Transient notifications will ignore this setting and timeout anyway.
-Use a rule overwriting with 'set_transient = no' to disable this behavior.
+A client can mark a notification as transient to bypass this setting and timeout
+anyway. Use a rule with 'set_transient = no' to disable this behavior.
 
 =item B<font> (default: "Monospace 8")
 
@@ -624,6 +624,8 @@ Notifications can be matched for any of the following attributes:
 
 =item C<icon>
 
+=item C<match_transient>
+
 =item C<msg_urgency>
 
 =item C<stack_tag>
@@ -670,6 +672,8 @@ The following attributes can be overridden:
 
 =item C<set_stack_tag>
 
+=item C<set_transient>
+
 =item C<timeout>
 
 =item C<urgency>
diff --git a/dunstrc b/dunstrc
index 8231e33..7380ddf 100644
--- a/dunstrc
+++ b/dunstrc
@@ -80,7 +80,8 @@
     # Don't remove messages, if the user is idle (no mouse or keyboard input)
     # for longer than idle_threshold seconds.
     # Set to 0 to disable.
-    # Transient notifications ignore this setting.
+    # A client can set the 'transient' hint to bypass this. See the rules
+    # section for how to disable this if necessary
     idle_threshold = 120
 
     ### Text ###
@@ -304,6 +305,7 @@
 #    category
 #    desktop_entry
 #    icon
+#    match_transient
 #    msg_urgency
 #    stack_tag
 #    summary
@@ -316,6 +318,7 @@
 #    fullscreen
 #    new_icon
 #    set_stack_tag
+#    set_transient
 #    timeout
 #    urgency
 #
@@ -337,13 +340,24 @@
 # NOTE: It might be helpful to run dunst -print in a terminal in order
 # to find fitting options for rules.
 
+# Disable the transient hint so that idle_threshold cannot be bypassed from the
+# client
+#[transient_disable]
+#    match_transient = yes
+#    set_transient = no
+#
+# Make the handling of transient notifications more strict by making them not
+# be placed in history.
+#[transient_history_ignore]
+#    match_transient = yes
+#    history_ignore = yes
+
 # fullscreen values
 # show: show the notifications, regardless if there is a fullscreen window opened
 # delay: displays the new notification, if there is no fullscreen window active
 #        If the notification is already drawn, it won't get undrawn.
 # pushback: same as delay, but when switching into fullscreen, the notification will get
 #           withdrawn from screen again and will get delayed like a new notification
-
 #[fullscreen_delay_everything]
 #    fullscreen = delay
 #[fullscreen_show_critical]