diff --git a/language/generators.xml b/language/generators.xml
index 37f0b0c875..9fc3a09f4c 100644
--- a/language/generators.xml
+++ b/language/generators.xml
@@ -218,8 +218,9 @@ foreach ($generator as $value) {
     </para>
 
     <para>
-     This syntax may be used in conjunction with the
-     <methodname>Generator::send</methodname> method.
+     The value that will be assigned to <varname>$data</varname> is the value
+     passed to <methodname>Generator::send</methodname>, or &null; if 
+     <methodname>Generator::next</methodname> is called instead.
     </para>
    </caution>
 
diff --git a/language/predefined/generator/next.xml b/language/predefined/generator/next.xml
index 85c26d3f6d..b21b66b463 100644
--- a/language/predefined/generator/next.xml
+++ b/language/predefined/generator/next.xml
@@ -13,6 +13,10 @@
    <modifier>public</modifier> <type>void</type><methodname>Generator::next</methodname>
    <void />
   </methodsynopsis>
+  <para>
+   Calling <methodname>Generator::next</methodname> is equivalent to calling
+   <methodname>Generator::send</methodname> with &null; as argument.
+  </para>
  </refsect1>
 
  <refsect1 role="parameters">