diff --git a/doc/base/classes.xml b/doc/base/classes.xml
index 6f271d168a8..15e6f30c277 100644
--- a/doc/base/classes.xml
+++ b/doc/base/classes.xml
@@ -3684,6 +3684,8 @@
 			<argument index="0" name="gravity" type="float">
 			</argument>
 			<description>
+			Set the gravity intensity. This is useful to alter the force of gravity without altering its direction.
+			This value multiplies the gravity vector, whether it is the given vector ([method set_gravity_vector]), or a calculated one (when using a center of gravity).
 			</description>
 		</method>
 		<method name="get_gravity" qualifiers="const">