diff --git a/README.md b/README.md
index d68174e58..04276a1ff 100644
--- a/README.md
+++ b/README.md
@@ -164,7 +164,7 @@ magazines                                 downloads specific magazine issue as a
    <magpi>            [number]            downloads issue [number] of magazine
    <wireframe>        [list]              lists downloaded magazines in tree format of specific magazine
                       [url]               shows the homepage URL of magazine
-resolution <cea|dmt [modes]>              sets the screen resolution
+resolution <cea|dmt [modes]>              sets the screen resolution depending on the attached display device
 system [cpu|ram|disk|volt|temperature]    display real system informations
 message gitter <apitoken|authorize>       sets api/channel info in config file and sends/recieves messages in gitter
                <send|show|read|mark>
diff --git a/modules/help.sh b/modules/help.sh
index 162406fe2..e4766da04 100644
--- a/modules/help.sh
+++ b/modules/help.sh
@@ -140,7 +140,7 @@ magazines                                 downloads specific magazine issue as a
    <magpi>            [number]            downloads issue [number] of magazine
    <wireframe>        [list]              lists downloaded magazines in tree format of specific magazine
                       [url]               shows the homepage URL of magazine
-resolution <cea|dmt [modes]>              sets the screen resolution
+resolution <cea|dmt [modes]>              sets the screen resolution depending on the attached display device
 system [cpu|ram|disk|volt|temperature]    display real system informations
 message gitter <apitoken|authorize>       sets api/channel info in config file and sends/recieves messages in gitter
                <send|show|read|mark>
diff --git a/modules/resolution.sh b/modules/resolution.sh
index 3e81e879f..7a70f005c 100644
--- a/modules/resolution.sh
+++ b/modules/resolution.sh
@@ -46,16 +46,16 @@ function resolution() {
       fi
     done
       if [ $available == 1 ]; then
-      set_config_var hdmi_force_hotplug 1 $config
-      set_config_var hdmi_group $group $config
-      set_config_var hdmi_mode $mode $config
-      echo "Screen resolution set to $set_resolution"
-      reboot_needed
-      echo "reboot needed to see the changes"
+        set_config_var hdmi_force_hotplug 1 $config
+        set_config_var hdmi_group $group $config
+        set_config_var hdmi_mode $mode $config
+        echo "Screen resolution set to $set_resolution"
+        reboot_needed
+        echo "reboot needed to see the changes"
       else
-      echo "mode is not available  Possible modes are:"
-      tvservice -m DMT
-     fi
+        echo "mode is not available  Possible modes are:"
+        tvservice -m DMT
+      fi
   else
     echo "hdmi group should be either cea or dmt"
   fi
@@ -88,11 +88,16 @@ function resolution_help {
   echo
   echo "screen resolution set to the specified hdmi_group and hdmi_mode"
   echo
+  echo "mode number support will vary on the attached display device"
+  echo
   echo "Example:"
-  echo "  $BASENAME resolution cea 1"
-  echo "  System will set the resolution to CEA 640X480"
+  echo "  $BASENAME resolution cea"
+  echo "  System will provide all possible modes for the group cea"
+  echo
+  echo "  $BASENAME resolution cea 4"
+  echo "  System will set the resolution to CEA 1280x720 (resolution may vary)"
   echo
-  echo "  $BASENAME resolution dmt 9"
-  echo "  System will set the resolution to DMT 800X600"
+  echo "  $BASENAME resolution dmt 4"
+  echo "  System will set the resolution to DMT 640x480 (resolution may vary)"
   echo
 }
diff --git a/package.json b/package.json
index bfd7cfbca..86372d8d4 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@treehouses/cli",
-  "version": "1.25.17",
+  "version": "1.25.18",
   "remote": "4000",
   "description": "Thin command-line interface for Raspberry Pi low level configuration.",
   "main": "cli.sh",