diff --git a/cdist/conf/explorer/su b/cdist/conf/explorer/su
index ae164e69..9fc83c56 100644
--- a/cdist/conf/explorer/su
+++ b/cdist/conf/explorer/su
@@ -20,8 +20,9 @@
 # This explorer returns script code string for running a command with su.
 # If no su is found then it returns empty string.
 # It uses two arguments, first user and the second command to run.
-# If the result string is assigned to foo it is used as:
-# $ $foo user command
+# If the result string is assigned to foo it can be used in code
+# generation as:
+# echo "$foo user command"
 #
 
 which su > /dev/null 2>&1
diff --git a/cdist/conf/explorer/sucmd b/cdist/conf/explorer/sucmd
index bd4343d2..78d46b09 100644
--- a/cdist/conf/explorer/sucmd
+++ b/cdist/conf/explorer/sucmd
@@ -23,8 +23,9 @@
 # If no su nor sudo is found then it returns string script code to run
 # bare command.
 # It uses two arguments, first user and the second command to run.
-# If the result string is assigned to foo it is used as:
-# $ $foo user command
+# If the result string is assigned to foo it can be used in code
+# generation as:
+# echo "$foo user command"
 #
 
 sudo_func() {
diff --git a/cdist/conf/explorer/sudo b/cdist/conf/explorer/sudo
index 079c570d..b217f58b 100644
--- a/cdist/conf/explorer/sudo
+++ b/cdist/conf/explorer/sudo
@@ -20,8 +20,9 @@
 # This explorer returns script code string for running a command with sudo.
 # If no sudo is found then it returns empty string.
 # It uses two arguments, first user and the second command to run.
-# If the result string is assigned to foo it is used as:
-# $ $foo user command
+# If the result string is assigned to foo it can be used in code
+# generation as:
+# echo "$foo user command"
 #
 
 which sudo > /dev/null 2>&1