From 9fadd7d16abead86b784e00ca902314ce723abd7 Mon Sep 17 00:00:00 2001
From: Christoph Michael Becker <cmb@php.net>
Date: Fri, 16 Mar 2018 17:33:42 +0000
Subject: [PATCH] Fix #76104: Generator::next() causes yield to return null

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@344528 c90b9560-bf6c-de11-be94-00142212c4b1
---
 language/generators.xml                | 5 +++--
 language/predefined/generator/next.xml | 4 ++++
 2 files changed, 7 insertions(+), 2 deletions(-)

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">