diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 0bde65915c..7ebe165e10 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -337,34 +337,36 @@
                     You can use this variable to add more features in addition to those.
                     Here are some examples of features you can add:</para>
                     <literallayout class='monospaced'>
-     "dbg-pkgs" - Adds -dbg packages for all installed packages
-                  including symbol information for debugging and 
-                  profiling.
+"dbg-pkgs" - Adds -dbg packages for all installed packages
+             including symbol information for debugging and 
+             profiling.
 
-     "dev-pkgs" - Adds -dev packages for all installed packages.  
-                  This is useful if you want to develop against 
-                  the libraries in the image.
+"dev-pkgs" - Adds -dev packages for all installed packages.  
+             This is useful if you want to develop against 
+             the libraries in the image.
 
-     "tools-sdk" - Adds development tools such as gcc, make, 
-                   pkgconfig and so forth.
+"tools-sdk" - Adds development tools such as gcc, make, 
+              pkgconfig and so forth.
 
-     "tools-debug" - Adds debugging tools such as gdb and 
-                     strace.
+"tools-debug" - Adds debugging tools such as gdb and 
+                strace.
 
-     "tools-profile" - Adds profiling tools such as oprofile, 
-                       exmap, lttng and valgrind (x86 only).
+"tools-profile" - Adds profiling tools such as oprofile, 
+                  exmap, lttng and valgrind (x86 only).
 
-     "tools-testapps" - Adds useful testing tools such as 
-                        ts_print, aplay, arecord and so 
-                        forth.
+"tools-testapps" - Adds useful testing tools such as 
+                   ts_print, aplay, arecord and so 
+                   forth.
 
-     "debug-tweaks" - Makes an image suitable for development.  
-                      For example, ssh root access has a blank 
-                      password.  There are other application 
-                      targets too, see 
-                      meta/classes/poky-image.bbclass
-                      and meta/packages/tasks/task-poky.bb 
-                      for more details.
+"debug-tweaks" - Makes an image suitable for development.  
+                 For example, ssh root access has a blank 
+                 password.  You should remove this feature 
+                 before you produce a production image.  
+                       
+                 There are other application targets too, see
+                 <filename>meta/classes/poky-image.bbclass</filename>
+                 and <filename>meta/packages/tasks/task-poky.bb</filename>
+                 for more details.
                     </literallayout> 
             </glossdef>
         </glossentry>