diff --git a/language/predefined/generator/getreturn.xml b/language/predefined/generator/getreturn.xml
new file mode 100644
index 0000000000..748bea2429
--- /dev/null
+++ b/language/predefined/generator/getreturn.xml
@@ -0,0 +1,85 @@
+
+
+
+
+
+ Generator::getReturn
+ Get the return value
+
+
+
+ &reftitle.description;
+
+ public mixedGenerator::getReturn
+
+
+
+
+
+ &reftitle.parameters;
+ &no.function.parameters;
+
+
+
+ &reftitle.returnvalues;
+
+ Returns the generator's return value once it has finished executing.
+
+
+
+
+ &reftitle.examples;
+
+
+ Generator::getReturn example
+
+getReturn(), PHP_EOL;
+]]>
+
+ &example.outputs;
+
+
+
+
+
+
+
+
+
diff --git a/language/predefined/generator/key.xml b/language/predefined/generator/key.xml
index a210a6c45b..0e827ac837 100644
--- a/language/predefined/generator/key.xml
+++ b/language/predefined/generator/key.xml
@@ -14,11 +14,8 @@
-
+ Gets the key of the yielded value.
-
- &warn.undocumented.func;
-
@@ -33,7 +30,34 @@
+
+ &reftitle.examples;
+
+
+ Generator::key example
+
+ 'value';
+}
+
+$gen = Gen();
+
+echo "{$gen->key()} => {$gen->current()}";
+]]>
+
+ &example.outputs;
+
+ value
+]]>
+
+
+
+