doc: Sync classref with current source

2 files changed, 3 insertions, 38 deletions

diff --git a/modules/gdscript/doc_classes/@GDScript.xml b/modules/gdscript/doc_classes/@GDScript.xml
index d8825ecc9a..c86b974f47 100644
--- a/modules/gdscript/doc_classes/@GDScript.xml
+++ b/modules/gdscript/doc_classes/@GDScript.xml
@@ -1367,42 +1367,6 @@
 				[code]wrapi[/code] is more flexible than using the [method posmod] approach by giving the user control over the minimum value.
 			</description>
 		</method>
-		<method name="yield">
-			<return type="GDScriptFunctionState">
-			</return>
-			<argument index="0" name="object" type="Object" default="null">
-			</argument>
-			<argument index="1" name="signal" type="String" default="&quot;&quot;">
-			</argument>
-			<description>
-				Stops the function execution and returns the current suspended state to the calling function.
-				From the caller, call [method GDScriptFunctionState.resume] on the state to resume execution. This invalidates the state. Within the resumed function, [code]yield()[/code] returns whatever was passed to the [code]resume()[/code] function call.
-				If passed an object and a signal, the execution is resumed when the object emits the given signal. In this case, [code]yield()[/code] returns the argument passed to [code]emit_signal()[/code] if the signal takes only one argument, or an array containing all the arguments passed to [code]emit_signal()[/code] if the signal takes multiple arguments.
-				You can also use [code]yield[/code] to wait for a function to finish:
-				[codeblock]
-				func _ready():
-				    yield(countdown(), "completed") # waiting for the countdown() function to complete
-				    print('Ready')
-
-				func countdown():
-				    yield(get_tree(), "idle_frame") # returns a GDScriptFunctionState object to _ready()
-				    print(3)
-				    yield(get_tree().create_timer(1.0), "timeout")
-				    print(2)
-				    yield(get_tree().create_timer(1.0), "timeout")
-				    print(1)
-				    yield(get_tree().create_timer(1.0), "timeout")
-
-				# prints:
-				# 3
-				# 2
-				# 1
-				# Ready
-				[/codeblock]
-				When yielding on a function, the [code]completed[/code] signal will be emitted automatically when the function returns. It can, therefore, be used as the [code]signal[/code] parameter of the [code]yield[/code] method to resume.
-				In order to yield on a function, the resulting function should also return a [code]GDScriptFunctionState[/code]. Notice [code]yield(get_tree(), "idle_frame")[/code] from the above example.
-			</description>
-		</method>
 	</methods>
 	<constants>
 		<constant name="PI" value="3.141593">
diff --git a/modules/gdscript/doc_classes/GDScriptFunctionState.xml b/modules/gdscript/doc_classes/GDScriptFunctionState.xml
index 9a73764646..5e369b32d9 100644
--- a/modules/gdscript/doc_classes/GDScriptFunctionState.xml
+++ b/modules/gdscript/doc_classes/GDScriptFunctionState.xml
@@ -4,7 +4,8 @@
 		State of a function call after yielding.
 	</brief_description>
 	<description>
-		Calling [method @GDScript.yield] within a function will cause that function to yield and return its current state as an object of this type. The yielded function call can then be resumed later by calling [method resume] on this state object.
+		FIXME: Outdated docs as of GDScript rewrite in 4.0.
+		Calling [code]yield[/code] within a function will cause that function to yield and return its current state as an object of this type. The yielded function call can then be resumed later by calling [method resume] on this state object.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -26,7 +27,7 @@
 			</argument>
 			<description>
 				Resume execution of the yielded function call.
-				If handed an argument, return the argument from the [method @GDScript.yield] call in the yielded function call. You can pass e.g. an [Array] to hand multiple arguments.
+				If handed an argument, return the argument from the [code]yield[/code] call in the yielded function call. You can pass e.g. an [Array] to hand multiple arguments.
 				This function returns what the resumed function call returns, possibly another function state if yielded again.
 			</description>
 		</method>