diff --git a/blocks.def/volume.sh b/blocks.def/volume.sh
index def94ba..6ff90e3 100755
--- a/blocks.def/volume.sh
+++ b/blocks.def/volume.sh
@@ -1,4 +1,7 @@
 #!/bin/sh
+# This script parses the output of `pacmd list-sinks' to find volume and mute
+# status of the default audio sink and whether headphones are plugged in or not
+# Also see ../daemons/pulse_daemon.sh
 pacmd list-sinks |
     awk '
         BEGIN {
diff --git a/daemons/pulse_daemon.sh b/daemons/pulse_daemon.sh
index da0c5ec..5bf1da1 100755
--- a/daemons/pulse_daemon.sh
+++ b/daemons/pulse_daemon.sh
@@ -1,5 +1,5 @@
 #!/bin/sh
-# This script should be autostarted on startup
+# This script should be autostarted with X session
 # It signals volume block to update on audio related events
 pactl subscribe |
     while read -r output ; do