diff --git a/language/basic-syntax.xml b/language/basic-syntax.xml
index 7f43e9afc9..35757f00d7 100644
--- a/language/basic-syntax.xml
+++ b/language/basic-syntax.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.28 $ -->
+<!-- $Revision: 1.29 $ -->
  <chapter id="language.basic-syntax">
   <title>Basic syntax</title>
 
@@ -235,6 +235,13 @@ if ($expression) {
 ]]>
     </programlisting>
    </informalexample>
+   
+   <simpara>
+    The one-line comment styles actually only comment to the end
+    of the line or the current block of PHP code, whichever comes first.
+    This means that HTML code after // ?> WILL be printed: ?> skips out of
+    the PHP mode and returns to HTML mode, and // cannot influence that.
+   </simpara>
   </sect1>
  </chapter>