From 382cd2ee6de175337b2c136da0ea27ce71ea558c Mon Sep 17 00:00:00 2001
From: Sascha Kruse <knopwob@googlemail.com>
Date: Tue, 12 Jun 2012 19:12:32 +0200
Subject: [PATCH] add comments to dunstrc

---
 dunstrc | 74 +++++++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 54 insertions(+), 20 deletions(-)

diff --git a/dunstrc b/dunstrc
index 3895f22..097e25d 100644
--- a/dunstrc
+++ b/dunstrc
@@ -1,11 +1,38 @@
 [global]
-    font = -*-terminus-medium-r-*-*-16-*-*-*-*-*-*-*
+    font = Monospace-12
+
+    # The format of the message. Possible variables are:
+    #   %a  appname
+    #   %s  summary
+    #   %b  body
+    #   %i  iconname (including its path)
+    #   %I  iconname (without its path)
     format = "%s %b"
-    sort = no
+
+    # Sort messages by urgency
+    sort = yes
+
+    # Show how many messages are currently hidden (because of geometry)
     indicate_hidden = yes
+
+    # keybindings to remove notification
     key = space
     modifier = ctrl
+
+    # the geometry of the window
+    # geometry [{width}]x{height}][+/-{x}+/-{y}]
+    # The geometry of the message window.
+    # The height is measured in lines everything else in pixels. If the width
+    # is omitted but the height is given ("-geometry x2"), the message window
+    # expands over the whole screen (dmenu-like). If width is 0,
+    # the window expands to the longest message displayed.
+    # A positive x is measured from the left, a negative from the
+    # right side of the screen.  Y is measured from the top and down respectevly.
     geometry = "0x3-30+20"
+
+    # 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.
     idle_threshold = 120
 
 [urgency_low]
@@ -24,22 +51,29 @@
     timeout = 0
 
 
-[signed_on]
-    appname = Pidgin
-    summary = "*signed on*"
-    urgency = low
-    
-[signed_off]
-    appname = Pidgin
-    summary = *signed off*
-    urgency = low
+# Every section that isn't one of the above is interpreted as a rules
+# to override settings for certain messages.
+# Messages can be matched by 'appname', 'summary', 'body' or 'icon'
+# and you can override the 'timeout', 'urgency', 'foreground', 'background'
+# and 'format'.
+# Shell-like globbing will get expanded.
 
-[says]
-    appname = Pidgin
-    summary = *says*
-    urgency = critical
-
-[twitter]
-    appname = Pidgin
-    summary = *twitter.com*
-    urgency = normal
+#[signed_on]
+#    appname = Pidgin
+#    summary = "*signed on*"
+#    urgency = low
+#
+#[signed_off]
+#    appname = Pidgin
+#    summary = *signed off*
+#    urgency = low
+#
+#[says]
+#    appname = Pidgin
+#    summary = *says*
+#    urgency = critical
+#
+#[twitter]
+#    appname = Pidgin
+#    summary = *twitter.com*
+#    urgency = normal