classref: Sync with current 3.4 branch

classes/[email protected]

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the @GDScript.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -479,6 +479,8 @@ Deprecated alias for :ref:`step_decimals<class_@GDScript_method_step_decimals>`.
 
 - :ref:`float<class_float>` **dectime** **(** :ref:`float<class_float>` value, :ref:`float<class_float>` amount, :ref:`float<class_float>` step **)**
 
+**Note:** ``dectime`` has been deprecated and will be removed in Godot 4.0, please use :ref:`move_toward<class_@GDScript_method_move_toward>` instead.
+
 Returns the result of ``value`` decreased by ``step`` \* ``amount``.
 
 ::
@@ -511,7 +513,21 @@ Converts a dictionary (previously created with :ref:`inst2dict<class_@GDScript_m
 
 - :ref:`float<class_float>` **ease** **(** :ref:`float<class_float>` s, :ref:`float<class_float>` curve **)**
 
-Easing function, based on exponent. The curve values are: 0 is constant, 1 is linear, 0 to 1 is ease-in, 1+ is ease out. Negative values are in-out/out in.
+Returns an "eased" value of ``x`` based on an easing function defined with ``curve``. This easing function is based on an exponent. The ``curve`` can be any floating-point number, with specific values leading to the following behaviors:
+
+::
+
+    - Lower than -1.0 (exclusive): Ease in-out
+    - 1.0: Linear
+    - Between -1.0 and 0.0 (exclusive): Ease out-in
+    - 0.0: Constant
+    - Between 0.0 to 1.0 (exclusive): Ease in
+    - 1.0: Linear
+    - Greater than 1.0 (exclusive): Ease out
+
+`ease() curve values cheatsheet <https://raw.githubusercontent.com/godotengine/godot-docs/3.4/img/ease_cheatsheet.png>`__
+
+See also :ref:`smoothstep<class_@GDScript_method_smoothstep>`. If you need to perform more advanced transitions, use :ref:`Tween<class_Tween>` or :ref:`AnimationPlayer<class_AnimationPlayer>`.
 
 ----
 
@@ -1197,7 +1213,9 @@ Randomizes the seed (or the internal state) of the random number generator. Curr
 
 - :ref:`Array<class_Array>` **range** **(** ... **)** |vararg|
 
-Returns an array with the given range. Range can be 1 argument N (0 to N-1), two arguments (initial, final-1) or three arguments (initial, final-1, increment).
+Returns an array with the given range. Range can be 1 argument ``N`` (0 to ``N`` - 1), two arguments (``initial``, ``final - 1``) or three arguments (``initial``, ``final - 1``, ``increment``). Returns an empty array if the range isn't valid (e.g. ``range(2, 5, -1)`` or ``range(5, 5, 1)``).
+
+Returns an array with the given range. ``range()`` can have 1 argument N (``0`` to ``N - 1``), two arguments (``initial``, ``final - 1``) or three arguments (``initial``, ``final - 1``, ``increment``). ``increment`` can be negative. If ``increment`` is negative, ``final - 1`` will become ``final + 1``. Also, the initial value must be greater than the final value for the loop to run.
 
 ::
 
@@ -1213,6 +1231,24 @@ Output:
     [2, 3, 4]
     [0, 2, 4]
 
+To iterate over an :ref:`Array<class_Array>` backwards, use:
+
+::
+
+    var array = [3, 6, 9]
+    var i := array.size() - 1
+    while i >= 0:
+        print(array[i])
+        i -= 1
+
+Output:
+
+::
+
+    9
+    6
+    3
+
 ----
 
 .. _class_@GDScript_method_range_lerp:
@@ -1312,6 +1348,10 @@ This S-shaped curve is the cubic Hermite interpolator, given by ``f(y) = 3*y^2 -
     smoothstep(0, 2, 1.0) # Returns 0.5
     smoothstep(0, 2, 2.0) # Returns 1.0
 
+Compared to :ref:`ease<class_@GDScript_method_ease>` with a curve value of ``-1.6521``, :ref:`smoothstep<class_@GDScript_method_smoothstep>` returns the smoothest possible curve with no sudden changes in the derivative. If you need to perform more advanced transitions, use :ref:`Tween<class_Tween>` or :ref:`AnimationPlayer<class_AnimationPlayer>`.
+
+`Comparison between smoothstep() and ease(x, -1.6521) return values <https://raw.githubusercontent.com/godotengine/godot-docs/3.4/img/smoothstep_ease_comparison.png>`__
+
 ----
 
 .. _class_@GDScript_method_sqrt:

classes/[email protected]

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the @GlobalScope.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -1176,7 +1176,7 @@ enum **KeyModifierMask**:
 
 - **KEY_MASK_CTRL** = **268435456** --- Ctrl key mask.
 
-- **KEY_MASK_CMD** = **268435456** --- Command key mask. On macOS, this is equivalent to :ref:`KEY_MASK_META<class_@GlobalScope_constant_KEY_MASK_META>`. On other platforms, this is equivalent to :ref:`KEY_MASK_CTRL<class_@GlobalScope_constant_KEY_MASK_CTRL>`. This mask should be preferred to :ref:`KEY_MASK_META<class_@GlobalScope_constant_KEY_MASK_META>` or :ref:`KEY_MASK_CTRL<class_@GlobalScope_constant_KEY_MASK_CTRL>` for system shortcuts as it handles all platforms correctly.
+- **KEY_MASK_CMD** = **platform-dependent** --- Command key mask. On macOS, this is equivalent to :ref:`KEY_MASK_META<class_@GlobalScope_constant_KEY_MASK_META>`. On other platforms, this is equivalent to :ref:`KEY_MASK_CTRL<class_@GlobalScope_constant_KEY_MASK_CTRL>`. This mask should be preferred to :ref:`KEY_MASK_META<class_@GlobalScope_constant_KEY_MASK_META>` or :ref:`KEY_MASK_CTRL<class_@GlobalScope_constant_KEY_MASK_CTRL>` for system shortcuts as it handles all platforms correctly.
 
 - **KEY_MASK_KPAD** = **536870912** --- Keypad key mask.
 
@@ -1887,7 +1887,7 @@ enum **PropertyHint**:
 
 - **PROPERTY_HINT_RANGE** = **1** --- Hints that an integer or float property should be within a range specified via the hint string ``"min,max"`` or ``"min,max,step"``. The hint string can optionally include ``"or_greater"`` and/or ``"or_lesser"`` to allow manual input going respectively above the max or below the min values. Example: ``"-360,360,1,or_greater,or_lesser"``.
 
-- **PROPERTY_HINT_EXP_RANGE** = **2** --- Hints that an integer or float property should be within an exponential range specified via the hint string ``"min,max"`` or ``"min,max,step"``. The hint string can optionally include ``"or_greater"`` and/or ``"or_lesser"`` to allow manual input going respectively above the max or below the min values. Example: ``"0.01,100,0.01,or_greater"``.
+- **PROPERTY_HINT_EXP_RANGE** = **2** --- Hints that a float property should be within an exponential range specified via the hint string ``"min,max"`` or ``"min,max,step"``. The hint string can optionally include ``"or_greater"`` and/or ``"or_lesser"`` to allow manual input going respectively above the max or below the min values. Example: ``"0.01,100,0.01,or_greater"``.
 
 - **PROPERTY_HINT_ENUM** = **3** --- Hints that an integer, float or string property is an enumerated value to pick in a list specified via a hint string such as ``"Hello,Something,Else"``.
 

classes/class_aabb.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AABB.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -161,7 +161,16 @@ Returns ``true`` if this ``AABB`` completely encloses another one.
 
 - :ref:`AABB<class_AABB>` **expand** **(** :ref:`Vector3<class_Vector3>` to_point **)**
 
-Returns this ``AABB`` expanded to include a given point.
+Returns a copy of this ``AABB`` expanded to include a given point.
+
+**Example:**
+
+::
+
+    # position (-3, 2, 0), size (1, 1, 1)
+    var box = AABB(Vector3(-3, 2, 0), Vector3(1, 1, 1))
+    # position (-3, -1, 0), size (3, 4, 2), so we fit both the original AABB and Vector3(0, -1, 2)
+    var box2 = box.expand(Vector3(0, -1, 2))
 
 ----
 

classes/class_acceptdialog.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AcceptDialog.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -149,6 +149,8 @@ You can use :ref:`remove_button<class_AcceptDialog_method_remove_button>` method
 
 Returns the label used for built-in text.
 
+**Warning:** This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their :ref:`CanvasItem.visible<class_CanvasItem_property_visible>` property.
+
 ----
 
 .. _class_AcceptDialog_method_get_ok:
@@ -157,6 +159,8 @@ Returns the label used for built-in text.
 
 Returns the OK :ref:`Button<class_Button>` instance.
 
+**Warning:** This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their :ref:`CanvasItem.visible<class_CanvasItem_property_visible>` property.
+
 ----
 
 .. _class_AcceptDialog_method_register_text_enter:

classes/class_aescontext.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AESContext.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -107,7 +107,7 @@ Close this AES context so it can be started again. See :ref:`start<class_AESCont
 
 Get the current IV state for this context (IV gets updated when calling :ref:`update<class_AESContext_method_update>`). You normally don't need this function.
 
-Note: This function only makes sense when the context is started with :ref:`MODE_CBC_ENCRYPT<class_AESContext_constant_MODE_CBC_ENCRYPT>` or :ref:`MODE_CBC_DECRYPT<class_AESContext_constant_MODE_CBC_DECRYPT>`.
+**Note:** This function only makes sense when the context is started with :ref:`MODE_CBC_ENCRYPT<class_AESContext_constant_MODE_CBC_ENCRYPT>` or :ref:`MODE_CBC_DECRYPT<class_AESContext_constant_MODE_CBC_DECRYPT>`.
 
 ----
 
@@ -125,7 +125,7 @@ Start the AES context in the given ``mode``. A ``key`` of either 16 or 32 bytes
 
 Run the desired operation for this AES context. Will return a :ref:`PoolByteArray<class_PoolByteArray>` containing the result of encrypting (or decrypting) the given ``src``. See :ref:`start<class_AESContext_method_start>` for mode of operation.
 
-Note: The size of ``src`` must be a multiple of 16. Apply some padding if needed.
+**Note:** The size of ``src`` must be a multiple of 16. Apply some padding if needed.
 
 .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
 .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`

classes/class_animatedsprite.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimatedSprite.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -25,7 +25,7 @@ Tutorials
 
 - :doc:`../tutorials/2d/2d_sprite_animation`
 
-- `2D Dodge The Creeps Demo <https://godotengine.org/asset-library/asset/515>`_
+- `2D Dodge The Creeps Demo <https://godotengine.org/asset-library/asset/515>`__
 
 Properties
 ----------

classes/class_animatedsprite3d.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimatedSprite3D.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animatedtexture.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimatedTexture.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animation.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the Animation.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationnode.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNode.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationnodeadd2.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeAdd2.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationnodeadd3.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeAdd3.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -31,7 +31,7 @@ Tutorials
 
 - :doc:`../tutorials/animation/animation_tree`
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 Properties
 ----------

classes/class_animationnodeanimation.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeAnimation.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,9 +23,9 @@ Tutorials
 
 - :doc:`../tutorials/animation/animation_tree`
 
-- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`_
+- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`__
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 Properties
 ----------

classes/class_animationnodeblend2.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeBlend2.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,9 +23,9 @@ Tutorials
 
 - :doc:`../tutorials/animation/animation_tree`
 
-- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`_
+- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`__
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 Properties
 ----------

classes/class_animationnodeblend3.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeBlend3.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationnodeblendspace1d.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeBlendSpace1D.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationnodeblendspace2d.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeBlendSpace2D.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -27,7 +27,7 @@ Tutorials
 
 - :doc:`../tutorials/animation/animation_tree`
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 Properties
 ----------

classes/class_animationnodeblendtree.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeBlendTree.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationnodeoneshot.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeOneShot.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,7 +23,7 @@ Tutorials
 
 - :doc:`../tutorials/animation/animation_tree`
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 Properties
 ----------

classes/class_animationnodeoutput.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeOutput.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -18,9 +18,9 @@ Tutorials
 
 - :doc:`../tutorials/animation/animation_tree`
 
-- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`_
+- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`__
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
 .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`

classes/class_animationnodestatemachine.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeStateMachine.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationnodestatemachineplayback.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeStateMachinePlayback.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationnodestatemachinetransition.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeStateMachineTransition.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -78,7 +78,7 @@ Property Descriptions
 | *Getter*  | get_advance_condition()      |
 +-----------+------------------------------+
 
-Turn on auto advance when this condition is set. The provided name will become a boolean parameter on the :ref:`AnimationTree<class_AnimationTree>` that can be controlled from code (see `https://docs.godotengine.org/en/3.3/tutorials/animation/animation_tree.html#controlling-from-code <https://docs.godotengine.org/en/3.3/tutorials/animation/animation_tree.html#controlling-from-code>`_). For example, if :ref:`AnimationTree.tree_root<class_AnimationTree_property_tree_root>` is an :ref:`AnimationNodeStateMachine<class_AnimationNodeStateMachine>` and :ref:`advance_condition<class_AnimationNodeStateMachineTransition_property_advance_condition>` is set to ``"idle"``:
+Turn on auto advance when this condition is set. The provided name will become a boolean parameter on the :ref:`AnimationTree<class_AnimationTree>` that can be controlled from code (see `https://docs.godotengine.org/en/3.4/tutorials/animation/animation_tree.html#controlling-from-code <https://docs.godotengine.org/en/3.4/tutorials/animation/animation_tree.html#controlling-from-code>`__). For example, if :ref:`AnimationTree.tree_root<class_AnimationTree_property_tree_root>` is an :ref:`AnimationNodeStateMachine<class_AnimationNodeStateMachine>` and :ref:`advance_condition<class_AnimationNodeStateMachineTransition_property_advance_condition>` is set to ``"idle"``:
 
 ::
 

classes/class_animationnodetimescale.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeTimeScale.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,7 +23,7 @@ Tutorials
 
 - :doc:`../tutorials/animation/animation_tree`
 
-- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`_
+- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`__
 
 .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
 .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`

classes/class_animationnodetimeseek.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeTimeSeek.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationnodetransition.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationNodeTransition.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,9 +23,9 @@ Tutorials
 
 - :doc:`../tutorials/animation/animation_tree`
 
-- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`_
+- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`__
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 Properties
 ----------

classes/class_animationplayer.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationPlayer.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -29,7 +29,7 @@ Tutorials
 
 - :doc:`../tutorials/2d/2d_sprite_animation`
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 Properties
 ----------
@@ -224,7 +224,7 @@ The name of the animation to play when the scene loads.
 
 The name of the currently playing animation. If no animation is playing, the property's value is an empty string. Changing this value does not restart the animation. See :ref:`play<class_AnimationPlayer_method_play>` for more information on playing animations.
 
-**Note**: while this property appears in the inspector, it's not meant to be edited, and it's not saved in the scene. This property is mainly used to get the currently playing animation, and internally for animation playback tracks. For more information, see :ref:`Animation<class_Animation>`.
+**Note:** While this property appears in the inspector, it's not meant to be edited, and it's not saved in the scene. This property is mainly used to get the currently playing animation, and internally for animation playback tracks. For more information, see :ref:`Animation<class_Animation>`.
 
 ----
 

classes/class_animationrootnode.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationRootNode.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationtrackeditplugin.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationTrackEditPlugin.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_animationtree.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationTree.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -16,14 +16,16 @@ A node to be used for advanced animation transitions in an :ref:`AnimationPlayer
 Description
 -----------
 
-Note: When linked with an :ref:`AnimationPlayer<class_AnimationPlayer>`, several properties and methods of the corresponding :ref:`AnimationPlayer<class_AnimationPlayer>` will not function as expected. Playback and transitions should be handled using only the ``AnimationTree`` and its constituent :ref:`AnimationNode<class_AnimationNode>`\ (s). The :ref:`AnimationPlayer<class_AnimationPlayer>` node should be used solely for adding, deleting, and editing animations.
+A node to be used for advanced animation transitions in an :ref:`AnimationPlayer<class_AnimationPlayer>`.
+
+**Note:** When linked with an :ref:`AnimationPlayer<class_AnimationPlayer>`, several properties and methods of the corresponding :ref:`AnimationPlayer<class_AnimationPlayer>` will not function as expected. Playback and transitions should be handled using only the ``AnimationTree`` and its constituent :ref:`AnimationNode<class_AnimationNode>`\ (s). The :ref:`AnimationPlayer<class_AnimationPlayer>` node should be used solely for adding, deleting, and editing animations.
 
 Tutorials
 ---------
 
 - :doc:`../tutorials/animation/animation_tree`
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 Properties
 ----------

classes/class_animationtreeplayer.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AnimationTreePlayer.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_area.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the Area.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -21,9 +21,9 @@ Description
 Tutorials
 ---------
 
-- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`_
+- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`__
 
-- `GUI in 3D Demo <https://godotengine.org/asset-library/asset/127>`_
+- `GUI in 3D Demo <https://godotengine.org/asset-library/asset/127>`__
 
 Properties
 ----------
@@ -100,33 +100,33 @@ Emitted when another Area exits this Area. Requires :ref:`monitoring<class_Area_
 
 .. _class_Area_signal_area_shape_entered:
 
-- **area_shape_entered** **(** :ref:`RID<class_RID>` area_rid, :ref:`Area<class_Area>` area, :ref:`int<class_int>` area_shape, :ref:`int<class_int>` local_shape **)**
+- **area_shape_entered** **(** :ref:`RID<class_RID>` area_rid, :ref:`Area<class_Area>` area, :ref:`int<class_int>` area_shape_index, :ref:`int<class_int>` local_shape_index **)**
 
 Emitted when one of another Area's :ref:`Shape<class_Shape>`\ s enters one of this Area's :ref:`Shape<class_Shape>`\ s. Requires :ref:`monitoring<class_Area_property_monitoring>` to be set to ``true``.
 
-``area_id`` the :ref:`RID<class_RID>` of the other Area's :ref:`CollisionObject<class_CollisionObject>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``area_rid`` the :ref:`RID<class_RID>` of the other Area's :ref:`CollisionObject<class_CollisionObject>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
 
 ``area`` the other Area.
 
-``area_shape`` the index of the :ref:`Shape<class_Shape>` of the other Area used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``area_shape_index`` the index of the :ref:`Shape<class_Shape>` of the other Area used by the :ref:`PhysicsServer<class_PhysicsServer>`. Get the :ref:`CollisionShape<class_CollisionShape>` node with ``area.shape_owner_get_owner(area_shape_index)``.
 
-``local_shape`` the index of the :ref:`Shape<class_Shape>` of this Area used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``local_shape_index`` the index of the :ref:`Shape<class_Shape>` of this Area used by the :ref:`PhysicsServer<class_PhysicsServer>`. Get the :ref:`CollisionShape<class_CollisionShape>` node with ``self.shape_owner_get_owner(local_shape_index)``.
 
 ----
 
 .. _class_Area_signal_area_shape_exited:
 
-- **area_shape_exited** **(** :ref:`RID<class_RID>` area_rid, :ref:`Area<class_Area>` area, :ref:`int<class_int>` area_shape, :ref:`int<class_int>` local_shape **)**
+- **area_shape_exited** **(** :ref:`RID<class_RID>` area_rid, :ref:`Area<class_Area>` area, :ref:`int<class_int>` area_shape_index, :ref:`int<class_int>` local_shape_index **)**
 
 Emitted when one of another Area's :ref:`Shape<class_Shape>`\ s enters one of this Area's :ref:`Shape<class_Shape>`\ s. Requires :ref:`monitoring<class_Area_property_monitoring>` to be set to ``true``.
 
-``area_id`` the :ref:`RID<class_RID>` of the other Area's :ref:`CollisionObject<class_CollisionObject>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``area_rid`` the :ref:`RID<class_RID>` of the other Area's :ref:`CollisionObject<class_CollisionObject>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
 
 ``area`` the other Area.
 
-``area_shape`` the index of the :ref:`Shape<class_Shape>` of the other Area used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``area_shape_index`` the index of the :ref:`Shape<class_Shape>` of the other Area used by the :ref:`PhysicsServer<class_PhysicsServer>`. Get the :ref:`CollisionShape<class_CollisionShape>` node with ``area.shape_owner_get_owner(area_shape_index)``.
 
-``local_shape`` the index of the :ref:`Shape<class_Shape>` of this Area used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``local_shape_index`` the index of the :ref:`Shape<class_Shape>` of this Area used by the :ref:`PhysicsServer<class_PhysicsServer>`. Get the :ref:`CollisionShape<class_CollisionShape>` node with ``self.shape_owner_get_owner(local_shape_index)``.
 
 ----
 
@@ -152,33 +152,33 @@ Emitted when a :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`GridMap<class_Grid
 
 .. _class_Area_signal_body_shape_entered:
 
-- **body_shape_entered** **(** :ref:`RID<class_RID>` body_rid, :ref:`Node<class_Node>` body, :ref:`int<class_int>` body_shape, :ref:`int<class_int>` local_shape **)**
+- **body_shape_entered** **(** :ref:`RID<class_RID>` body_rid, :ref:`Node<class_Node>` body, :ref:`int<class_int>` body_shape_index, :ref:`int<class_int>` local_shape_index **)**
 
 Emitted when one of a :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`GridMap<class_GridMap>`'s :ref:`Shape<class_Shape>`\ s enters one of this Area's :ref:`Shape<class_Shape>`\ s. Requires :ref:`monitoring<class_Area_property_monitoring>` to be set to ``true``. :ref:`GridMap<class_GridMap>`\ s are detected if the :ref:`MeshLibrary<class_MeshLibrary>` has Collision :ref:`Shape<class_Shape>`\ s.
 
-``body_id`` the :ref:`RID<class_RID>` of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`MeshLibrary<class_MeshLibrary>`'s :ref:`CollisionObject<class_CollisionObject>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``body_rid`` the :ref:`RID<class_RID>` of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`MeshLibrary<class_MeshLibrary>`'s :ref:`CollisionObject<class_CollisionObject>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
 
 ``body`` the :ref:`Node<class_Node>`, if it exists in the tree, of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`GridMap<class_GridMap>`.
 
-``body_shape`` the index of the :ref:`Shape<class_Shape>` of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`GridMap<class_GridMap>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``body_shape_index`` the index of the :ref:`Shape<class_Shape>` of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`GridMap<class_GridMap>` used by the :ref:`PhysicsServer<class_PhysicsServer>`. Get the :ref:`CollisionShape<class_CollisionShape>` node with ``body.shape_owner_get_owner(body_shape_index)``.
 
-``local_shape`` the index of the :ref:`Shape<class_Shape>` of this Area used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``local_shape_index`` the index of the :ref:`Shape<class_Shape>` of this Area used by the :ref:`PhysicsServer<class_PhysicsServer>`. Get the :ref:`CollisionShape<class_CollisionShape>` node with ``self.shape_owner_get_owner(local_shape_index)``.
 
 ----
 
 .. _class_Area_signal_body_shape_exited:
 
-- **body_shape_exited** **(** :ref:`RID<class_RID>` body_rid, :ref:`Node<class_Node>` body, :ref:`int<class_int>` body_shape, :ref:`int<class_int>` local_shape **)**
+- **body_shape_exited** **(** :ref:`RID<class_RID>` body_rid, :ref:`Node<class_Node>` body, :ref:`int<class_int>` body_shape_index, :ref:`int<class_int>` local_shape_index **)**
 
 Emitted when one of a :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`GridMap<class_GridMap>`'s :ref:`Shape<class_Shape>`\ s enters one of this Area's :ref:`Shape<class_Shape>`\ s. Requires :ref:`monitoring<class_Area_property_monitoring>` to be set to ``true``. :ref:`GridMap<class_GridMap>`\ s are detected if the :ref:`MeshLibrary<class_MeshLibrary>` has Collision :ref:`Shape<class_Shape>`\ s.
 
-``body_id`` the :ref:`RID<class_RID>` of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`MeshLibrary<class_MeshLibrary>`'s :ref:`CollisionObject<class_CollisionObject>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``body_rid`` the :ref:`RID<class_RID>` of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`MeshLibrary<class_MeshLibrary>`'s :ref:`CollisionObject<class_CollisionObject>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
 
 ``body`` the :ref:`Node<class_Node>`, if it exists in the tree, of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`GridMap<class_GridMap>`.
 
-``body_shape`` the index of the :ref:`Shape<class_Shape>` of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`GridMap<class_GridMap>` used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``body_shape_index`` the index of the :ref:`Shape<class_Shape>` of the :ref:`PhysicsBody<class_PhysicsBody>` or :ref:`GridMap<class_GridMap>` used by the :ref:`PhysicsServer<class_PhysicsServer>`. Get the :ref:`CollisionShape<class_CollisionShape>` node with ``body.shape_owner_get_owner(body_shape_index)``.
 
-``local_shape`` the index of the :ref:`Shape<class_Shape>` of this Area used by the :ref:`PhysicsServer<class_PhysicsServer>`.
+``local_shape_index`` the index of the :ref:`Shape<class_Shape>` of this Area used by the :ref:`PhysicsServer<class_PhysicsServer>`. Get the :ref:`CollisionShape<class_CollisionShape>` node with ``self.shape_owner_get_owner(local_shape_index)``.
 
 Enumerations
 ------------
@@ -475,7 +475,9 @@ Method Descriptions
 
 - :ref:`Array<class_Array>` **get_overlapping_areas** **(** **)** |const|
 
-Returns a list of intersecting ``Area``\ s. For performance reasons (collisions are all processed at the same time) this list is modified once during the physics step, not immediately after objects are moved. Consider using signals instead.
+Returns a list of intersecting ``Area``\ s. The overlapping area's :ref:`CollisionObject.collision_layer<class_CollisionObject_property_collision_layer>` must be part of this area's :ref:`CollisionObject.collision_mask<class_CollisionObject_property_collision_mask>` in order to be detected.
+
+For performance reasons (collisions are all processed at the same time) this list is modified once during the physics step, not immediately after objects are moved. Consider using signals instead.
 
 ----
 
@@ -483,7 +485,9 @@ Returns a list of intersecting ``Area``\ s. For performance reasons (collisions
 
 - :ref:`Array<class_Array>` **get_overlapping_bodies** **(** **)** |const|
 
-Returns a list of intersecting :ref:`PhysicsBody<class_PhysicsBody>`\ s. For performance reasons (collisions are all processed at the same time) this list is modified once during the physics step, not immediately after objects are moved. Consider using signals instead.
+Returns a list of intersecting :ref:`PhysicsBody<class_PhysicsBody>`\ s. The overlapping body's :ref:`CollisionObject.collision_layer<class_CollisionObject_property_collision_layer>` must be part of this area's :ref:`CollisionObject.collision_mask<class_CollisionObject_property_collision_mask>` in order to be detected.
+
+For performance reasons (collisions are all processed at the same time) this list is modified once during the physics step, not immediately after objects are moved. Consider using signals instead.
 
 ----
 

classes/class_area2d.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the Area2D.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,11 +23,11 @@ Tutorials
 
 - :doc:`../tutorials/physics/using_area_2d`
 
-- `2D Dodge The Creeps Demo <https://godotengine.org/asset-library/asset/515>`_
+- `2D Dodge The Creeps Demo <https://godotengine.org/asset-library/asset/515>`__
 
-- `2D Pong Demo <https://godotengine.org/asset-library/asset/121>`_
+- `2D Pong Demo <https://godotengine.org/asset-library/asset/121>`__
 
-- `2D Platformer Demo <https://godotengine.org/asset-library/asset/120>`_
+- `2D Platformer Demo <https://godotengine.org/asset-library/asset/120>`__
 
 Properties
 ----------
@@ -96,33 +96,33 @@ Emitted when another Area2D exits this Area2D. Requires :ref:`monitoring<class_A
 
 .. _class_Area2D_signal_area_shape_entered:
 
-- **area_shape_entered** **(** :ref:`RID<class_RID>` area_rid, :ref:`Area2D<class_Area2D>` area, :ref:`int<class_int>` area_shape, :ref:`int<class_int>` local_shape **)**
+- **area_shape_entered** **(** :ref:`RID<class_RID>` area_rid, :ref:`Area2D<class_Area2D>` area, :ref:`int<class_int>` area_shape_index, :ref:`int<class_int>` local_shape_index **)**
 
 Emitted when one of another Area2D's :ref:`Shape2D<class_Shape2D>`\ s enters one of this Area2D's :ref:`Shape2D<class_Shape2D>`\ s. Requires :ref:`monitoring<class_Area2D_property_monitoring>` to be set to ``true``.
 
-``area_id`` the :ref:`RID<class_RID>` of the other Area2D's :ref:`CollisionObject2D<class_CollisionObject2D>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``area_rid`` the :ref:`RID<class_RID>` of the other Area2D's :ref:`CollisionObject2D<class_CollisionObject2D>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
 
 ``area`` the other Area2D.
 
-``area_shape`` the index of the :ref:`Shape2D<class_Shape2D>` of the other Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``area_shape_index`` the index of the :ref:`Shape2D<class_Shape2D>` of the other Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`. Get the :ref:`CollisionShape2D<class_CollisionShape2D>` node with ``area.shape_owner_get_owner(area_shape_index)``.
 
-``local_shape`` the index of the :ref:`Shape2D<class_Shape2D>` of this Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``local_shape_index`` the index of the :ref:`Shape2D<class_Shape2D>` of this Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`. Get the :ref:`CollisionShape2D<class_CollisionShape2D>` node with ``self.shape_owner_get_owner(local_shape_index)``.
 
 ----
 
 .. _class_Area2D_signal_area_shape_exited:
 
-- **area_shape_exited** **(** :ref:`RID<class_RID>` area_rid, :ref:`Area2D<class_Area2D>` area, :ref:`int<class_int>` area_shape, :ref:`int<class_int>` local_shape **)**
+- **area_shape_exited** **(** :ref:`RID<class_RID>` area_rid, :ref:`Area2D<class_Area2D>` area, :ref:`int<class_int>` area_shape_index, :ref:`int<class_int>` local_shape_index **)**
 
 Emitted when one of another Area2D's :ref:`Shape2D<class_Shape2D>`\ s exits one of this Area2D's :ref:`Shape2D<class_Shape2D>`\ s. Requires :ref:`monitoring<class_Area2D_property_monitoring>` to be set to ``true``.
 
-``area_id`` the :ref:`RID<class_RID>` of the other Area2D's :ref:`CollisionObject2D<class_CollisionObject2D>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``area_rid`` the :ref:`RID<class_RID>` of the other Area2D's :ref:`CollisionObject2D<class_CollisionObject2D>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
 
 ``area`` the other Area2D.
 
-``area_shape`` the index of the :ref:`Shape2D<class_Shape2D>` of the other Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``area_shape_index`` the index of the :ref:`Shape2D<class_Shape2D>` of the other Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`. Get the :ref:`CollisionShape2D<class_CollisionShape2D>` node with ``area.shape_owner_get_owner(area_shape_index)``.
 
-``local_shape`` the index of the :ref:`Shape2D<class_Shape2D>` of this Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``local_shape_index`` the index of the :ref:`Shape2D<class_Shape2D>` of this Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`. Get the :ref:`CollisionShape2D<class_CollisionShape2D>` node with ``self.shape_owner_get_owner(local_shape_index)``.
 
 ----
 
@@ -148,33 +148,33 @@ Emitted when a :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileMap<class_
 
 .. _class_Area2D_signal_body_shape_entered:
 
-- **body_shape_entered** **(** :ref:`RID<class_RID>` body_rid, :ref:`Node<class_Node>` body, :ref:`int<class_int>` body_shape, :ref:`int<class_int>` local_shape **)**
+- **body_shape_entered** **(** :ref:`RID<class_RID>` body_rid, :ref:`Node<class_Node>` body, :ref:`int<class_int>` body_shape_index, :ref:`int<class_int>` local_shape_index **)**
 
 Emitted when one of a :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileMap<class_TileMap>`'s :ref:`Shape2D<class_Shape2D>`\ s enters one of this Area2D's :ref:`Shape2D<class_Shape2D>`\ s. Requires :ref:`monitoring<class_Area2D_property_monitoring>` to be set to ``true``. :ref:`TileMap<class_TileMap>`\ s are detected if the :ref:`TileSet<class_TileSet>` has Collision :ref:`Shape2D<class_Shape2D>`\ s.
 
-``body_id`` the :ref:`RID<class_RID>` of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileSet<class_TileSet>`'s :ref:`CollisionObject2D<class_CollisionObject2D>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``body_rid`` the :ref:`RID<class_RID>` of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileSet<class_TileSet>`'s :ref:`CollisionObject2D<class_CollisionObject2D>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
 
 ``body`` the :ref:`Node<class_Node>`, if it exists in the tree, of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileMap<class_TileMap>`.
 
-``body_shape`` the index of the :ref:`Shape2D<class_Shape2D>` of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileMap<class_TileMap>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``body_shape_index`` the index of the :ref:`Shape2D<class_Shape2D>` of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileMap<class_TileMap>` used by the :ref:`Physics2DServer<class_Physics2DServer>`. Get the :ref:`CollisionShape2D<class_CollisionShape2D>` node with ``body.shape_owner_get_owner(body_shape_index)``.
 
-``local_shape`` the index of the :ref:`Shape2D<class_Shape2D>` of this Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``local_shape_index`` the index of the :ref:`Shape2D<class_Shape2D>` of this Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`. Get the :ref:`CollisionShape2D<class_CollisionShape2D>` node with ``self.shape_owner_get_owner(local_shape_index)``.
 
 ----
 
 .. _class_Area2D_signal_body_shape_exited:
 
-- **body_shape_exited** **(** :ref:`RID<class_RID>` body_rid, :ref:`Node<class_Node>` body, :ref:`int<class_int>` body_shape, :ref:`int<class_int>` local_shape **)**
+- **body_shape_exited** **(** :ref:`RID<class_RID>` body_rid, :ref:`Node<class_Node>` body, :ref:`int<class_int>` body_shape_index, :ref:`int<class_int>` local_shape_index **)**
 
 Emitted when one of a :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileMap<class_TileMap>`'s :ref:`Shape2D<class_Shape2D>`\ s exits one of this Area2D's :ref:`Shape2D<class_Shape2D>`\ s. Requires :ref:`monitoring<class_Area2D_property_monitoring>` to be set to ``true``. :ref:`TileMap<class_TileMap>`\ s are detected if the :ref:`TileSet<class_TileSet>` has Collision :ref:`Shape2D<class_Shape2D>`\ s.
 
-``body_id`` the :ref:`RID<class_RID>` of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileSet<class_TileSet>`'s :ref:`CollisionObject2D<class_CollisionObject2D>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``body_rid`` the :ref:`RID<class_RID>` of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileSet<class_TileSet>`'s :ref:`CollisionObject2D<class_CollisionObject2D>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
 
 ``body`` the :ref:`Node<class_Node>`, if it exists in the tree, of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileMap<class_TileMap>`.
 
-``body_shape`` the index of the :ref:`Shape2D<class_Shape2D>` of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileMap<class_TileMap>` used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``body_shape_index`` the index of the :ref:`Shape2D<class_Shape2D>` of the :ref:`PhysicsBody2D<class_PhysicsBody2D>` or :ref:`TileMap<class_TileMap>` used by the :ref:`Physics2DServer<class_Physics2DServer>`. Get the :ref:`CollisionShape2D<class_CollisionShape2D>` node with ``body.shape_owner_get_owner(body_shape_index)``.
 
-``local_shape`` the index of the :ref:`Shape2D<class_Shape2D>` of this Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`.
+``local_shape_index`` the index of the :ref:`Shape2D<class_Shape2D>` of this Area2D used by the :ref:`Physics2DServer<class_Physics2DServer>`. Get the :ref:`CollisionShape2D<class_CollisionShape2D>` node with ``self.shape_owner_get_owner(local_shape_index)``.
 
 Enumerations
 ------------
@@ -407,7 +407,9 @@ Method Descriptions
 
 - :ref:`Array<class_Array>` **get_overlapping_areas** **(** **)** |const|
 
-Returns a list of intersecting ``Area2D``\ s. For performance reasons (collisions are all processed at the same time) this list is modified once during the physics step, not immediately after objects are moved. Consider using signals instead.
+Returns a list of intersecting ``Area2D``\ s. The overlapping area's :ref:`CollisionObject2D.collision_layer<class_CollisionObject2D_property_collision_layer>` must be part of this area's :ref:`CollisionObject2D.collision_mask<class_CollisionObject2D_property_collision_mask>` in order to be detected.
+
+For performance reasons (collisions are all processed at the same time) this list is modified once during the physics step, not immediately after objects are moved. Consider using signals instead.
 
 ----
 
@@ -415,7 +417,9 @@ Returns a list of intersecting ``Area2D``\ s. For performance reasons (collision
 
 - :ref:`Array<class_Array>` **get_overlapping_bodies** **(** **)** |const|
 
-Returns a list of intersecting :ref:`PhysicsBody2D<class_PhysicsBody2D>`\ s. For performance reasons (collisions are all processed at the same time) this list is modified once during the physics step, not immediately after objects are moved. Consider using signals instead.
+Returns a list of intersecting :ref:`PhysicsBody2D<class_PhysicsBody2D>`\ s. The overlapping body's :ref:`CollisionObject2D.collision_layer<class_CollisionObject2D_property_collision_layer>` must be part of this area's :ref:`CollisionObject2D.collision_mask<class_CollisionObject2D_property_collision_mask>` in order to be detected.
+
+For performance reasons (collisions are all processed at the same time) this list is modified once during the physics step, not immediately after objects are moved. Consider using signals instead.
 
 ----
 

classes/class_array.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the Array.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -97,6 +97,8 @@ Methods
 +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Variant<class_Variant>` | :ref:`min<class_Array_method_min>` **(** **)**                                                                                                                                                                   |
 +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Variant<class_Variant>` | :ref:`pop_at<class_Array_method_pop_at>` **(** :ref:`int<class_int>` position **)**                                                                                                                              |
++-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Variant<class_Variant>` | :ref:`pop_back<class_Array_method_pop_back>` **(** **)**                                                                                                                                                         |
 +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Variant<class_Variant>` | :ref:`pop_front<class_Array_method_pop_front>` **(** **)**                                                                                                                                                       |
@@ -386,6 +388,16 @@ Returns the minimum value contained in the array if all elements are of comparab
 
 ----
 
+.. _class_Array_method_pop_at:
+
+- :ref:`Variant<class_Variant>` **pop_at** **(** :ref:`int<class_int>` position **)**
+
+Removes and returns the element of the array at index ``position``. If negative, ``position`` is considered relative to the end of the array. Leaves the array untouched and returns ``null`` if the array is empty or if it's accessed out of bounds. An error message is printed when the array is accessed out of bounds, but not when the array is empty.
+
+**Note:** On large arrays, this method can be slower than :ref:`pop_back<class_Array_method_pop_back>` as it will reindex the array's elements that are located after the removed element. The larger the array and the lower the index of the removed element, the slower :ref:`pop_at<class_Array_method_pop_at>` will be.
+
+----
+
 .. _class_Array_method_pop_back:
 
 - :ref:`Variant<class_Variant>` **pop_back** **(** **)**
@@ -498,7 +510,7 @@ Sorts the array using a custom method. The arguments are an object that holds th
 
 For two elements ``a`` and ``b``, if the given method returns ``true``, element ``b`` will be after element ``a`` in the array.
 
-**Note:** you cannot randomize the return value as the heapsort algorithm expects a deterministic result. Doing so will result in unexpected behavior.
+**Note:** You cannot randomize the return value as the heapsort algorithm expects a deterministic result. Doing so will result in unexpected behavior.
 
 ::
 

classes/class_arraymesh.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the ArrayMesh.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -40,7 +40,7 @@ The :ref:`MeshInstance<class_MeshInstance>` is ready to be added to the :ref:`Sc
 
 See also :ref:`ImmediateGeometry<class_ImmediateGeometry>`, :ref:`MeshDataTool<class_MeshDataTool>` and :ref:`SurfaceTool<class_SurfaceTool>` for procedural geometry generation.
 
-**Note:** Godot uses clockwise `winding order <https://learnopengl.com/Advanced-OpenGL/Face-culling>`_ for front faces of triangle primitive modes.
+**Note:** Godot uses clockwise `winding order <https://learnopengl.com/Advanced-OpenGL/Face-culling>`__ for front faces of triangle primitive modes.
 
 Tutorials
 ---------

classes/class_arvranchor.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the ARVRAnchor.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_arvrcamera.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the ARVRCamera.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_arvrcontroller.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the ARVRController.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_arvrinterface.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the ARVRInterface.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_arvrinterfacegdnative.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the ARVRInterfaceGDNative.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_arvrorigin.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the ARVROrigin.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_arvrpositionaltracker.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the ARVRPositionalTracker.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_arvrserver.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the ARVRServer.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_aspectratiocontainer.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AspectRatioContainer.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_astar.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AStar.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_astar2d.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AStar2D.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_atlastexture.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AtlasTexture.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audiobuslayout.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioBusLayout.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffect.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffect.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,7 +23,7 @@ Base resource for audio bus. Applies an audio effect on the bus that the resourc
 Tutorials
 ---------
 
-- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`_
+- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`__
 
 .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
 .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`

classes/class_audioeffectamplify.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectAmplify.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectbandlimitfilter.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectBandLimitFilter.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectbandpassfilter.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectBandPassFilter.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectcapture.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectCapture.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectchorus.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectChorus.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectcompressor.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectCompressor.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectdelay.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectDelay.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectdistortion.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectDistortion.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffecteq.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectEQ.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffecteq10.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectEQ10.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffecteq21.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectEQ21.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffecteq6.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectEQ6.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectfilter.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectFilter.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffecthighpassfilter.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectHighPassFilter.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffecthighshelffilter.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectHighShelfFilter.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectinstance.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectInstance.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectlimiter.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectLimiter.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectlowpassfilter.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectLowPassFilter.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectlowshelffilter.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectLowShelfFilter.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectnotchfilter.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectNotchFilter.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectpanner.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectPanner.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectphaser.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectPhaser.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectpitchshift.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectPitchShift.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -77,7 +77,7 @@ Property Descriptions
 | *Getter*  | get_fft_size()      |
 +-----------+---------------------+
 
-The size of the `Fast Fourier transform <https://en.wikipedia.org/wiki/Fast_Fourier_transform>`_ buffer. Higher values smooth out the effect over time, but have greater latency. The effects of this higher latency are especially noticeable on sounds that have sudden amplitude changes.
+The size of the `Fast Fourier transform <https://en.wikipedia.org/wiki/Fast_Fourier_transform>`__ buffer. Higher values smooth out the effect over time, but have greater latency. The effects of this higher latency are especially noticeable on sounds that have sudden amplitude changes.
 
 ----
 

classes/class_audioeffectrecord.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectRecord.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,7 +23,7 @@ Tutorials
 
 - :doc:`../tutorials/audio/recording_with_microphone`
 
-- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`_
+- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`__
 
 Properties
 ----------

classes/class_audioeffectreverb.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectReverb.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,7 +23,7 @@ Simulates rooms of different sizes. Its parameters can be adjusted to simulate t
 Tutorials
 ---------
 
-- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`_
+- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
 
 Properties
 ----------

classes/class_audioeffectspectrumanalyzer.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectSpectrumAnalyzer.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,9 +23,9 @@ See also :ref:`AudioStreamGenerator<class_AudioStreamGenerator>` for procedurall
 Tutorials
 ---------
 
-- `https://godotengine.org/asset-library/asset/528 <Audio Spectrum Demo>`_
+- `https://godotengine.org/asset-library/asset/528 <Audio Spectrum Demo>`__
 
-- `https://godotengine.org/article/godot-32-will-get-new-audio-features <Godot 3.2 will get new audio features>`_
+- `https://godotengine.org/article/godot-32-will-get-new-audio-features <Godot 3.2 will get new audio features>`__
 
 Properties
 ----------
@@ -100,7 +100,7 @@ The length of the buffer to keep (in seconds). Higher values keep data around fo
 | *Getter*  | get_fft_size()      |
 +-----------+---------------------+
 
-The size of the `Fast Fourier transform <https://en.wikipedia.org/wiki/Fast_Fourier_transform>`_ buffer. Higher values smooth out the spectrum analysis over time, but have greater latency. The effects of this higher latency are especially noticeable with sudden amplitude changes.
+The size of the `Fast Fourier transform <https://en.wikipedia.org/wiki/Fast_Fourier_transform>`__ buffer. Higher values smooth out the spectrum analysis over time, but have greater latency. The effects of this higher latency are especially noticeable with sudden amplitude changes.
 
 ----
 

classes/class_audioeffectspectrumanalyzerinstance.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectSpectrumAnalyzerInstance.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioeffectstereoenhance.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioEffectStereoEnhance.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audioserver.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioServer.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,11 +23,11 @@ Tutorials
 
 - :doc:`../tutorials/audio/audio_buses`
 
-- `Audio Device Changer Demo <https://godotengine.org/asset-library/asset/525>`_
+- `Audio Device Changer Demo <https://godotengine.org/asset-library/asset/525>`__
 
-- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`_
+- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`__
 
-- `Audio Spectrum Demo <https://godotengine.org/asset-library/asset/528>`_
+- `Audio Spectrum Demo <https://godotengine.org/asset-library/asset/528>`__
 
 Properties
 ----------

classes/class_audiostream.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStream.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -25,11 +25,11 @@ Tutorials
 
 - :doc:`../tutorials/audio/audio_streams`
 
-- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`_
+- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`__
 
-- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`_
+- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`__
 
-- `Audio Spectrum Demo <https://godotengine.org/asset-library/asset/528>`_
+- `Audio Spectrum Demo <https://godotengine.org/asset-library/asset/528>`__
 
 Methods
 -------

classes/class_audiostreamgenerator.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamGenerator.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -25,9 +25,9 @@ See also :ref:`AudioEffectSpectrumAnalyzer<class_AudioEffectSpectrumAnalyzer>` f
 Tutorials
 ---------
 
-- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`_
+- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`__
 
-- `https://godotengine.org/article/godot-32-will-get-new-audio-features <Godot 3.2 will get new audio features>`_
+- `https://godotengine.org/article/godot-32-will-get-new-audio-features <Godot 3.2 will get new audio features>`__
 
 Properties
 ----------
@@ -73,7 +73,7 @@ The sample rate to use (in Hz). Higher values are more demanding for the CPU to
 
 In games, common sample rates in use are ``11025``, ``16000``, ``22050``, ``32000``, ``44100``, and ``48000``.
 
-According to the `Nyquist-Shannon sampling theorem <https://en.wikipedia.org/wiki/Nyquist%E2%80%93Shannon_sampling_theorem>`_, there is no quality difference to human hearing when going past 40,000 Hz (since most humans can only hear up to ~20,000 Hz, often less). If you are generating lower-pitched sounds such as voices, lower sample rates such as ``32000`` or ``22050`` may be usable with no loss in quality.
+According to the `Nyquist-Shannon sampling theorem <https://en.wikipedia.org/wiki/Nyquist%E2%80%93Shannon_sampling_theorem>`__, there is no quality difference to human hearing when going past 40,000 Hz (since most humans can only hear up to ~20,000 Hz, often less). If you are generating lower-pitched sounds such as voices, lower sample rates such as ``32000`` or ``22050`` may be usable with no loss in quality.
 
 .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
 .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`

classes/class_audiostreamgeneratorplayback.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamGeneratorPlayback.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -21,9 +21,9 @@ This class is meant to be used with :ref:`AudioStreamGenerator<class_AudioStream
 Tutorials
 ---------
 
-- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`_
+- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`__
 
-- `https://godotengine.org/article/godot-32-will-get-new-audio-features <Godot 3.2 will get new audio features>`_
+- `https://godotengine.org/article/godot-32-will-get-new-audio-features <Godot 3.2 will get new audio features>`__
 
 Methods
 -------

classes/class_audiostreammicrophone.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamMicrophone.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audiostreammp3.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamMP3.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audiostreamoggvorbis.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamOGGVorbis.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audiostreamplayback.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamPlayback.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -23,7 +23,7 @@ Can play, loop, pause a scroll through audio. See :ref:`AudioStream<class_AudioS
 Tutorials
 ---------
 
-- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`_
+- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`__
 
 .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
 .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`

classes/class_audiostreamplaybackresampled.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamPlaybackResampled.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audiostreamplayer.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamPlayer.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -25,15 +25,15 @@ Tutorials
 
 - :doc:`../tutorials/audio/audio_streams`
 
-- `2D Dodge The Creeps Demo <https://godotengine.org/asset-library/asset/515>`_
+- `2D Dodge The Creeps Demo <https://godotengine.org/asset-library/asset/515>`__
 
-- `Audio Device Changer Demo <https://godotengine.org/asset-library/asset/525>`_
+- `Audio Device Changer Demo <https://godotengine.org/asset-library/asset/525>`__
 
-- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`_
+- `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`__
 
-- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`_
+- `Audio Mic Record Demo <https://godotengine.org/asset-library/asset/527>`__
 
-- `Audio Spectrum Demo <https://godotengine.org/asset-library/asset/528>`_
+- `Audio Spectrum Demo <https://godotengine.org/asset-library/asset/528>`__
 
 Properties
 ----------

classes/class_audiostreamplayer2d.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamPlayer2D.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audiostreamplayer3d.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamPlayer3D.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -117,7 +117,7 @@ enum **AttenuationModel**:
 
 - **ATTENUATION_LOGARITHMIC** = **2** --- Logarithmic dampening of loudness according to distance.
 
-- **ATTENUATION_DISABLED** = **3** --- No dampening of loudness according to distance. The sound will still be heard positionally, unlike an :ref:`AudioStreamPlayer<class_AudioStreamPlayer>`.
+- **ATTENUATION_DISABLED** = **3** --- No dampening of loudness according to distance. The sound will still be heard positionally, unlike an :ref:`AudioStreamPlayer<class_AudioStreamPlayer>`. :ref:`ATTENUATION_DISABLED<class_AudioStreamPlayer3D_constant_ATTENUATION_DISABLED>` can be combined with a :ref:`max_distance<class_AudioStreamPlayer3D_property_max_distance>` value greater than ``0.0`` to achieve linear attenuation clamped to a sphere of a defined size.
 
 ----
 
@@ -147,9 +147,9 @@ enum **DopplerTracking**:
 
 - **DOPPLER_TRACKING_DISABLED** = **0** --- Disables doppler tracking.
 
-- **DOPPLER_TRACKING_IDLE_STEP** = **1** --- Executes doppler tracking in idle step.
+- **DOPPLER_TRACKING_IDLE_STEP** = **1** --- Executes doppler tracking in idle step (every rendered frame).
 
-- **DOPPLER_TRACKING_PHYSICS_STEP** = **2** --- Executes doppler tracking in physics step.
+- **DOPPLER_TRACKING_PHYSICS_STEP** = **2** --- Executes doppler tracking in physics step (every simulated physics frame).
 
 Property Descriptions
 ---------------------
@@ -262,7 +262,9 @@ The bus on which this audio is playing.
 | *Getter*  | get_doppler_tracking()      |
 +-----------+-----------------------------+
 
-Decides in which step the Doppler effect should be calculated.
+Decides in which step the `Doppler effect <https://en.wikipedia.org/wiki/Doppler_effect>`__ should be calculated.
+
+**Note:** Only effective if the current :ref:`Camera<class_Camera>`'s :ref:`Camera.doppler_tracking<class_Camera_property_doppler_tracking>` property is set to a value other than :ref:`Camera.DOPPLER_TRACKING_DISABLED<class_Camera_constant_DOPPLER_TRACKING_DISABLED>`.
 
 ----
 

classes/class_audiostreamrandompitch.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamRandomPitch.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_audiostreamsample.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the AudioStreamSample.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -188,7 +188,7 @@ The sample rate for mixing this audio. Higher values require more storage space,
 
 In games, common sample rates in use are ``11025``, ``16000``, ``22050``, ``32000``, ``44100``, and ``48000``.
 
-According to the `Nyquist-Shannon sampling theorem <https://en.wikipedia.org/wiki/Nyquist%E2%80%93Shannon_sampling_theorem>`_, there is no quality difference to human hearing when going past 40,000 Hz (since most humans can only hear up to ~20,000 Hz, often less). If you are using lower-pitched sounds such as voices, lower sample rates such as ``32000`` or ``22050`` may be usable with no loss in quality.
+According to the `Nyquist-Shannon sampling theorem <https://en.wikipedia.org/wiki/Nyquist%E2%80%93Shannon_sampling_theorem>`__, there is no quality difference to human hearing when going past 40,000 Hz (since most humans can only hear up to ~20,000 Hz, often less). If you are using lower-pitched sounds such as voices, lower sample rates such as ``32000`` or ``22050`` may be usable with no loss in quality.
 
 ----
 

classes/class_backbuffercopy.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the BackBufferCopy.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_bakedlightmap.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the BakedLightmap.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -18,6 +18,8 @@ Description
 
 Baked lightmaps are an alternative workflow for adding indirect (or baked) lighting to a scene. Unlike the :ref:`GIProbe<class_GIProbe>` approach, baked lightmaps work fine on low-end PCs and mobile devices as they consume almost no resources in run-time.
 
+**Procedural generation:** Lightmap baking functionality is only available in the editor. This means ``BakedLightmap`` is not suited to procedurally generated or user-built levels. For procedurally generated or user-built levels, use :ref:`GIProbe<class_GIProbe>` instead.
+
 **Note:** Due to how lightmaps work, most properties only have a visible effect once lightmaps are baked again.
 
 Tutorials
@@ -126,6 +128,8 @@ enum **BakeQuality**:
 
 .. _class_BakedLightmap_constant_BAKE_ERROR_NO_LIGHTMAPPER:
 
+.. _class_BakedLightmap_constant_BAKE_ERROR_NO_ROOT:
+
 enum **BakeError**:
 
 - **BAKE_ERROR_OK** = **0** --- Baking was successful.
@@ -142,7 +146,9 @@ enum **BakeError**:
 
 - **BAKE_ERROR_USER_ABORTED** = **6** --- Returns if user cancels baking.
 
-- **BAKE_ERROR_NO_LIGHTMAPPER** = **7**
+- **BAKE_ERROR_NO_LIGHTMAPPER** = **7** --- Returns if lightmapper can't be created. Unless you are using a custom lightmapper, please report this as bug.
+
+- **BAKE_ERROR_NO_ROOT** = **8** --- There is no root node to start baking from. Either provide ``from_node`` argument or attach this node to a parent that should be used as root.
 
 ----
 
@@ -534,7 +540,7 @@ Method Descriptions
 
 - :ref:`BakeError<enum_BakedLightmap_BakeError>` **bake** **(** :ref:`Node<class_Node>` from_node=null, :ref:`String<class_String>` data_save_path="" **)**
 
-Bakes the lightmap, scanning from the given ``from_node`` root and saves the resulting :ref:`BakedLightmapData<class_BakedLightmapData>` in ``data_save_path``. If no save path is provided it will try to match the path from the current :ref:`light_data<class_BakedLightmap_property_light_data>`.
+Bakes the lightmap, scanning from the given ``from_node`` root and saves the resulting :ref:`BakedLightmapData<class_BakedLightmapData>` in ``data_save_path``. If no root node is provided, parent of this node will be used as root instead. If no save path is provided it will try to match the path from the current :ref:`light_data<class_BakedLightmap_property_light_data>`.
 
 .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
 .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`

classes/class_bakedlightmapdata.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the BakedLightmapData.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_basebutton.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the BaseButton.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -203,7 +203,7 @@ If ``true``, the button is in disabled state and can't be clicked or toggled.
 | *Getter*  | get_enabled_focus_mode()      |
 +-----------+-------------------------------+
 
-*Deprecated.* This property has been deprecated due to redundancy and no longer has any effect when set. Please use :ref:`Control.focus_mode<class_Control_property_focus_mode>` instead.
+*Deprecated.* This property has been deprecated due to redundancy and will be removed in Godot 4.0. This property no longer has any effect when set. Please use :ref:`Control.focus_mode<class_Control_property_focus_mode>` instead.
 
 ----
 

classes/class_basis.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the Basis.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -31,13 +31,13 @@ Tutorials
 
 - :doc:`../tutorials/3d/using_transforms`
 
-- `Matrix Transform Demo <https://godotengine.org/asset-library/asset/584>`_
+- `Matrix Transform Demo <https://godotengine.org/asset-library/asset/584>`__
 
-- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`_
+- `3D Platformer Demo <https://godotengine.org/asset-library/asset/125>`__
 
-- `3D Voxel Demo <https://godotengine.org/asset-library/asset/676>`_
+- `3D Voxel Demo <https://godotengine.org/asset-library/asset/676>`__
 
-- `2.5D Demo <https://godotengine.org/asset-library/asset/583>`_
+- `2.5D Demo <https://godotengine.org/asset-library/asset/583>`__
 
 Properties
 ----------

classes/class_bitmap.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the BitMap.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -88,7 +88,7 @@ Returns the amount of bitmap elements that are set to ``true``.
 
 - void **grow_mask** **(** :ref:`int<class_int>` pixels, :ref:`Rect2<class_Rect2>` rect **)**
 
-Applies morphological dilation to the bitmap. The first argument is the dilation amount, Rect2 is the area where the dilation will be applied.
+Applies morphological dilation or erosion to the bitmap. If ``pixels`` is positive, dilation is applied to the bitmap. If ``pixels`` is negative, erosion is applied to the bitmap. ``rect`` defines the area where the morphological operation is applied. Pixels located outside the ``rect`` are unaffected by :ref:`grow_mask<class_BitMap_method_grow_mask>`.
 
 ----
 

classes/class_bitmapfont.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the BitmapFont.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 
@@ -11,7 +11,7 @@ BitmapFont
 
 **Inherits:** :ref:`Font<class_Font>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
 
-Renders text using fonts under the `BMFont <https://www.angelcode.com/products/bmfont/>`_ format.
+Renders text using fonts under the `BMFont <https://www.angelcode.com/products/bmfont/>`__ format.
 
 Handles files with the ``.fnt`` extension.
 

classes/class_bone2d.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the Bone2D.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.
 

classes/class_boneattachment.rst

@@ -1,6 +1,6 @@
 :github_url: hide
 
-.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
+.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
 .. DO NOT EDIT THIS FILE, but the BoneAttachment.xml source instead.
 .. The source is found in doc/classes or modules/<name>/doc_classes.