diff --git a/reference/dom/domdocument/createelement.xml b/reference/dom/domdocument/createelement.xml
index b16e79d70e..125f0ea1d3 100644
--- a/reference/dom/domdocument/createelement.xml
+++ b/reference/dom/domdocument/createelement.xml
@@ -34,7 +34,7 @@
      <listitem>
       <para>
        The value of the element. By default, an empty element will be created.
-       You can also set the value later with <literal>DOMElement->nodeValue</literal>.
+       The value can also be set later with <literal>DOMElement->nodeValue</literal>.
       </para>
      </listitem>
     </varlistentry>
@@ -93,6 +93,15 @@ echo $dom->saveXML();
    </example>
   </para>
  </refsect1>
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    To create a text node with <literal>escaping support</literal> use
+    <methodname>DOMDocument::createTextElement</methodname>.
+   </para>
+  </note>
+ </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>