Updated docs to fix stubs and clarify docs a bit

Author: oddbookworm

docs/reST/ref/math.rst

@@ -391,7 +391,9 @@ Conversion can be combined with swizzling or slicing to create a new order
       Returns a Vector which is a linear interpolation between self and the
       given Vector. The second parameter determines how far between self and
       other the result is going to be. It must be a value between ``0`` and ``1``
-      where ``0`` means self and ``1`` means other will be returned.
+      when ``do_clamp`` is ``True`` where ``0`` means self and ``1`` means other
+      will be returned. When ``do_clamp`` is ``False``, the lerp will extend out
+      linearly when the second parameter is outside of the nominal range.
 
       .. versionchanged:: 2.5.7 The ``do_clamp`` parameter is added with a default
          value of ``True``. When it's ``True``, the second parameter is limited
@@ -881,12 +883,14 @@ Conversion can be combined with swizzling or slicing to create a new order
 
       | :sl:`returns a linear interpolation to the given vector.`
       | :sg:`lerp(Vector3, float, /) -> Vector3`
-      | :sg:`lerp(Vector3, float, bool, /)`
+      | :sg:`lerp(Vector3, float, bool, /) -> Vector3`
 
       Returns a Vector which is a linear interpolation between self and the
-      given Vector. The second parameter determines how far between self an
-      other the result is going to be. It must be a value between ``0`` and
-      ``1``, where ``0`` means self and ``1`` means other will be returned.
+      given Vector. The second parameter determines how far between self and
+      other the result is going to be. It must be a value between ``0`` and ``1``
+      when ``do_clamp`` is ``True`` where ``0`` means self and ``1`` means other
+      will be returned. When ``do_clamp`` is ``False``, the lerp will extend out
+      linearly when the second parameter is outside of the nominal range.
 
       .. versionchanged:: 2.5.7 The ``do_clamp`` parameter is added with a default
          value of ``True``. When it's ``True``, the second parameter is limited

src_c/doc/math_doc.h

@@ -59,7 +59,7 @@
 #define DOC_MATH_VECTOR3_DISTANCESQUAREDTO "distance_squared_to(Vector3, /) -> float\ncalculates the squared Euclidean distance to a given vector."
 #define DOC_MATH_VECTOR3_MOVETOWARDS "move_towards(Vector3, float, /) -> Vector3\nreturns a vector moved toward the target by a given distance."
 #define DOC_MATH_VECTOR3_MOVETOWARDSIP "move_towards_ip(Vector3, float, /) -> None\nmoves the vector toward its target at a given distance."
-#define DOC_MATH_VECTOR3_LERP "lerp(Vector3, float, /) -> Vector3\nreturns a linear interpolation to the given vector."
+#define DOC_MATH_VECTOR3_LERP "lerp(Vector3, float, /) -> Vector3\nlerp(Vector3, float, bool, /) -> Vector3\nreturns a linear interpolation to the given vector."
 #define DOC_MATH_VECTOR3_SLERP "slerp(Vector3, float, /) -> Vector3\nreturns a spherical interpolation to the given vector."
 #define DOC_MATH_VECTOR3_SMOOTHSTEP "smoothstep(Vector3, float, /) -> Vector3\nreturns a smooth interpolation to the given vector."
 #define DOC_MATH_VECTOR3_ELEMENTWISE "elementwise() -> VectorElementwiseProxy\nThe next operation will be performed elementwise."