diff --git a/doc/classes/Color.xml b/doc/classes/Color.xml
index 5434b5ed591..513f21a5ebe 100644
--- a/doc/classes/Color.xml
+++ b/doc/classes/Color.xml
@@ -322,7 +322,9 @@
- Returns the linear interpolation between this color's components and [param to]'s components. The interpolation factor [param weight] should be between 0.0 and 1.0 (inclusive). See also [method @GlobalScope.lerp].
+ Returns the linear interpolation between this color's components and [param to]'s components.
+ To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i]. If this is not desired, use [method @GlobalScope.clampf] to limit [param weight].
+ See also [method @GlobalScope.lerp].
[codeblocks]
[gdscript]
var red = Color(1.0, 0.0, 0.0)
diff --git a/doc/classes/Transform2D.xml b/doc/classes/Transform2D.xml
index c55b5f1c907..6e6863292a3 100644
--- a/doc/classes/Transform2D.xml
+++ b/doc/classes/Transform2D.xml
@@ -145,7 +145,8 @@
Returns the result of the linear interpolation between this transform and [param xform] by the given [param weight].
- The [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). Values outside this range are allowed and can be used to perform [i]extrapolation[/i] instead.
+ To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i]. If this is not desired, use [method @GlobalScope.clampf] to limit [param weight].
+ See also [method @GlobalScope.lerp].
diff --git a/doc/classes/Transform3D.xml b/doc/classes/Transform3D.xml
index 702509b054a..de5b33c4967 100644
--- a/doc/classes/Transform3D.xml
+++ b/doc/classes/Transform3D.xml
@@ -72,7 +72,8 @@
Returns the result of the linear interpolation between this transform and [param xform] by the given [param weight].
- The [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). Values outside this range are allowed and can be used to perform [i]extrapolation[/i] instead.
+ To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i]. If this is not desired, use [method @GlobalScope.clampf] to limit [param weight].
+ See also [method @GlobalScope.lerp].
diff --git a/doc/classes/Vector2.xml b/doc/classes/Vector2.xml
index e0c33ce786c..6a5bc96d6bf 100644
--- a/doc/classes/Vector2.xml
+++ b/doc/classes/Vector2.xml
@@ -263,7 +263,9 @@
- Returns the result of the linear interpolation between this vector and [param to] by amount [param weight]. [param weight] is on the range of [code]0.0[/code] to [code]1.0[/code], representing the amount of interpolation.
+ Returns the result of the linear interpolation between this vector and [param to] by amount [param weight].
+ To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i]. If this is not desired, use [method @GlobalScope.clampf] to limit [param weight].
+ See also [method @GlobalScope.lerp].
diff --git a/doc/classes/Vector3.xml b/doc/classes/Vector3.xml
index dd86c4b2874..48a5c63cbe3 100644
--- a/doc/classes/Vector3.xml
+++ b/doc/classes/Vector3.xml
@@ -232,7 +232,9 @@
- Returns the result of the linear interpolation between this vector and [param to] by amount [param weight]. [param weight] is on the range of [code]0.0[/code] to [code]1.0[/code], representing the amount of interpolation.
+ Returns the result of the linear interpolation between this vector and [param to] by amount [param weight].
+ To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i]. If this is not desired, use [method @GlobalScope.clampf] to limit [param weight].
+ See also [method @GlobalScope.lerp].
diff --git a/doc/classes/Vector4.xml b/doc/classes/Vector4.xml
index bc5201baac5..7923c4718de 100644
--- a/doc/classes/Vector4.xml
+++ b/doc/classes/Vector4.xml
@@ -181,7 +181,9 @@
- Returns the result of the linear interpolation between this vector and [param to] by amount [param weight]. [param weight] is on the range of [code]0.0[/code] to [code]1.0[/code], representing the amount of interpolation.
+ Returns the result of the linear interpolation between this vector and [param to] by amount [param weight].
+ To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i]. If this is not desired, use [method @GlobalScope.clampf] to limit [param weight].
+ See also [method @GlobalScope.lerp].