Sync classref with current source

classes/[email protected]

@@ -896,7 +896,7 @@ Random from seed: pass a ``seed``, and an array with both number and new seed is
 
 - :ref:`float<class_float>` **randf** **(** **)**
 
-Returns a random floating point value between 0 and 1.
+Returns a random floating point value on the interval ``[0, 1]``.
 
 ::
 
@@ -906,7 +906,7 @@ Returns a random floating point value between 0 and 1.
 
 - :ref:`int<class_int>` **randi** **(** **)**
 
-Returns a random 32 bit integer. Use remainder to obtain a random value between 0 and N (where N is smaller than 2^32 -1).
+Returns a random 32 bit integer. Use remainder to obtain a random value in the interval ``[0, N]`` (where N is smaller than 2^32 -1).
 
 ::
 

classes/class_animation.rst

@@ -144,6 +144,13 @@ Methods
 | void                                                       | :ref:`value_track_set_update_mode<class_Animation_method_value_track_set_update_mode>` **(** :ref:`int<class_int>` idx, :ref:`UpdateMode<enum_Animation_UpdateMode>` mode **)**                                                                                                                            |
 +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
+Signals
+-------
+
+.. _class_Animation_signal_tracks_changed:
+
+- **tracks_changed** **(** **)**
+
 Enumerations
 ------------
 

classes/class_animationplayer.rst

@@ -356,12 +356,16 @@ Returns ``true`` if playing an animation.
 
 Play the animation with key ``name``. Custom speed and blend times can be set. If custom speed is negative (-1), 'from_end' being true can play the animation backwards.
 
+If the animation has been paused by ``stop(true)`` it will be resumed. Calling ``play()`` without arguments will also resume the animation.
+
 .. _class_AnimationPlayer_method_play_backwards:
 
 - void **play_backwards** **(** :ref:`String<class_String>` name="", :ref:`float<class_float>` custom_blend=-1 **)**
 
 Play the animation with key ``name`` in reverse.
 
+If the animation has been paused by ``stop(true)`` it will be resumed backwards. Calling ``play_backwards()`` without arguments will also resume the animation backwards.
+
 .. _class_AnimationPlayer_method_queue:
 
 - void **queue** **(** :ref:`String<class_String>` name **)**
@@ -396,5 +400,7 @@ Specify a blend time (in seconds) between two animations, referenced by their na
 
 - void **stop** **(** :ref:`bool<class_bool>` reset=true **)**
 
-Stop the currently playing animation. If ``reset`` is ``true``, the anim position is reset to ``0``.
+Stop the currently playing animation. If ``reset`` is ``true``, the animation position is reset to ``0`` and the playback speed is reset to ``1.0``.
+
+If ``reset`` is ``false``, then calling ``play()`` without arguments or ``play("same_as_before")`` will resume the animation. Works the same for the ``play_backwards()`` method.
 

classes/class_audiobuslayout.rst

@@ -19,5 +19,5 @@ Stores information about the audiobusses.
 Description
 -----------
 
-Stores position, muting, solo, bypass, effects, effect position, volume, and the connections between busses. See :ref:`AudioServer<class_AudioServer>` for usage.
+Stores position, muting, solo, bypass, effects, effect position, volume, and the connections between buses. See :ref:`AudioServer<class_AudioServer>` for usage.
 

classes/class_audioserver.rst

@@ -174,7 +174,7 @@ Adds an :ref:`AudioEffect<class_AudioEffect>` effect to the bus ``bus_idx`` at `
 
 - :ref:`AudioBusLayout<class_AudioBusLayout>` **generate_bus_layout** **(** **)** const
 
-Generates an :ref:`AudioBusLayout<class_AudioBusLayout>` using the available busses and effects.
+Generates an :ref:`AudioBusLayout<class_AudioBusLayout>` using the available buses and effects.
 
 .. _class_AudioServer_method_get_bus_channels:
 
@@ -186,7 +186,7 @@ Returns the amount of channels of the bus at index ``bus_idx``.
 
 - :ref:`int<class_int>` **get_bus_count** **(** **)** const
 
-Returns the number of available busses.
+Returns the number of available buses.
 
 .. _class_AudioServer_method_get_bus_effect:
 
@@ -314,7 +314,7 @@ If ``true``, the bus at index ``bus_idx`` is bypassing effects.
 
 - void **set_bus_count** **(** :ref:`int<class_int>` amount **)**
 
-Adds and removes busses to make the number of busses match ``amount``.
+Adds and removes buses to make the number of buses match ``amount``.
 
 .. _class_AudioServer_method_set_bus_effect_enabled:
 

classes/class_control.rst

@@ -502,9 +502,9 @@ enum **GrowDirection**:
 
 - **GROW_DIRECTION_BEGIN** = **0** --- The control will grow to the left or top to make up if its minimum size is changed to be greater than its current size on the respective axis.
 
-- **GROW_DIRECTION_END** = **1** --- The control wil grow to the right or bottom to make up if its minimum size is changed to be greater than its current size on the respective axis.
+- **GROW_DIRECTION_END** = **1** --- The control will grow to the right or bottom to make up if its minimum size is changed to be greater than its current size on the respective axis.
 
-- **GROW_DIRECTION_BOTH** = **2** --- The control wil grow in both directions equally to make up if its minimum size is changed to be greater than its current size.
+- **GROW_DIRECTION_BOTH** = **2** --- The control will grow in both directions equally to make up if its minimum size is changed to be greater than its current size.
 
 .. _enum_Control_Anchor:
 

classes/class_dictionary.rst

@@ -46,6 +46,8 @@ Description
 
 Dictionary type. Associative container which contains values referenced by unique keys. Dictionaries are always passed by reference.
 
+Erasing elements while iterating over them **is not supported**.
+
 Method Descriptions
 -------------------
 
@@ -71,7 +73,7 @@ Return true if the dictionary is empty.
 
 - :ref:`bool<class_bool>` **erase** **(** :ref:`Variant<class_Variant>` key **)**
 
-Erase a dictionary key/value pair by key.
+Erase a dictionary key/value pair by key. Do not erase elements while iterating over the dictionary.
 
 .. _class_Dictionary_method_get:
 

classes/class_editorspatialgizmoplugin.rst

@@ -130,7 +130,7 @@ Get material from the internal list of materials. If an :ref:`EditorSpatialGizmo
 
 - :ref:`String<class_String>` **get_name** **(** **)** virtual
 
-Override this method to provide the name that will appear in teh gizmo visibility menu.
+Override this method to provide the name that will appear in the gizmo visibility menu.
 
 .. _class_EditorSpatialGizmoPlugin_method_has_gizmo:
 

classes/class_file.rst

@@ -216,7 +216,7 @@ Closes the currently opened file.
 
 - :ref:`bool<class_bool>` **eof_reached** **(** **)** const
 
-Returns ``true`` if the file cursor has reached the end of the file.
+Returns ``true`` if the file cursor has read past the end of the file. Note that this function will still return ``false`` while at the end of the file and only activates when reading past it. This can be confusing but it conforms to how low level file access works in all operating systems. There is always :ref:`get_len<class_File_method_get_len>` and :ref:`get_position<class_File_method_get_position>` to implement a custom logic.
 
 .. _class_File_method_file_exists:
 

classes/class_multimesh.rst

@@ -34,21 +34,25 @@ Properties
 Methods
 -------
 
-+-----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`AABB<class_AABB>`           | :ref:`get_aabb<class_MultiMesh_method_get_aabb>` **(** **)** const                                                                                                   |
-+-----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Color<class_Color>`         | :ref:`get_instance_color<class_MultiMesh_method_get_instance_color>` **(** :ref:`int<class_int>` instance **)** const                                                |
-+-----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Color<class_Color>`         | :ref:`get_instance_custom_data<class_MultiMesh_method_get_instance_custom_data>` **(** :ref:`int<class_int>` instance **)** const                                    |
-+-----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Transform<class_Transform>` | :ref:`get_instance_transform<class_MultiMesh_method_get_instance_transform>` **(** :ref:`int<class_int>` instance **)** const                                        |
-+-----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                              | :ref:`set_instance_color<class_MultiMesh_method_set_instance_color>` **(** :ref:`int<class_int>` instance, :ref:`Color<class_Color>` color **)**                     |
-+-----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                              | :ref:`set_instance_custom_data<class_MultiMesh_method_set_instance_custom_data>` **(** :ref:`int<class_int>` instance, :ref:`Color<class_Color>` custom_data **)**   |
-+-----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                              | :ref:`set_instance_transform<class_MultiMesh_method_set_instance_transform>` **(** :ref:`int<class_int>` instance, :ref:`Transform<class_Transform>` transform **)** |
-+-----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`AABB<class_AABB>`               | :ref:`get_aabb<class_MultiMesh_method_get_aabb>` **(** **)** const                                                                                                             |
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Color<class_Color>`             | :ref:`get_instance_color<class_MultiMesh_method_get_instance_color>` **(** :ref:`int<class_int>` instance **)** const                                                          |
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Color<class_Color>`             | :ref:`get_instance_custom_data<class_MultiMesh_method_get_instance_custom_data>` **(** :ref:`int<class_int>` instance **)** const                                              |
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Transform<class_Transform>`     | :ref:`get_instance_transform<class_MultiMesh_method_get_instance_transform>` **(** :ref:`int<class_int>` instance **)** const                                                  |
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Transform2D<class_Transform2D>` | :ref:`get_instance_transform_2d<class_MultiMesh_method_get_instance_transform_2d>` **(** :ref:`int<class_int>` instance **)** const                                            |
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                  | :ref:`set_instance_color<class_MultiMesh_method_set_instance_color>` **(** :ref:`int<class_int>` instance, :ref:`Color<class_Color>` color **)**                               |
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                  | :ref:`set_instance_custom_data<class_MultiMesh_method_set_instance_custom_data>` **(** :ref:`int<class_int>` instance, :ref:`Color<class_Color>` custom_data **)**             |
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                  | :ref:`set_instance_transform<class_MultiMesh_method_set_instance_transform>` **(** :ref:`int<class_int>` instance, :ref:`Transform<class_Transform>` transform **)**           |
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                  | :ref:`set_instance_transform_2d<class_MultiMesh_method_set_instance_transform_2d>` **(** :ref:`int<class_int>` instance, :ref:`Transform2D<class_Transform2D>` transform **)** |
++---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 Enumerations
 ------------
@@ -198,6 +202,10 @@ Return the custom data that has been set for a specific instance.
 
 Return the transform of a specific instance.
 
+.. _class_MultiMesh_method_get_instance_transform_2d:
+
+- :ref:`Transform2D<class_Transform2D>` **get_instance_transform_2d** **(** :ref:`int<class_int>` instance **)** const
+
 .. _class_MultiMesh_method_set_instance_color:
 
 - void **set_instance_color** **(** :ref:`int<class_int>` instance, :ref:`Color<class_Color>` color **)**
@@ -216,3 +224,7 @@ Set custom data for a specific instance. Although :ref:`Color<class_Color>` is u
 
 Set the transform for a specific instance.
 
+.. _class_MultiMesh_method_set_instance_transform_2d:
+
+- void **set_instance_transform_2d** **(** :ref:`int<class_int>` instance, :ref:`Transform2D<class_Transform2D>` transform **)**
+

classes/class_networkedmultiplayerenet.rst

@@ -155,7 +155,7 @@ Closes the connection. Ignored if no connection is currently established. If thi
 
 - :ref:`Error<enum_@GlobalScope_Error>` **create_client** **(** :ref:`String<class_String>` address, :ref:`int<class_int>` port, :ref:`int<class_int>` in_bandwidth=0, :ref:`int<class_int>` out_bandwidth=0, :ref:`int<class_int>` client_port=0 **)**
 
-Create client that connects to a server at ``address`` using specified ``port``. The given address needs to be either a fully qualified domain nome (e.g. ``www.example.com``) or an IP address in IPv4 or IPv6 format (e.g. ``192.168.1.1``). The ``port`` is the port the server is listening on. The ``in_bandwidth`` and ``out_bandwidth`` parameters can be used to limit the incoming and outgoing bandwidth to the given number of bytes per second. The default of 0 means unlimited bandwidth. Note that ENet will strategically drop packets on specific sides of a connection between peers to ensure the peer's bandwidth is not overwhelmed. The bandwidth parameters also determine the window size of a connection which limits the amount of reliable packets that may be in transit at any given time. Returns ``OK`` if a client was created, ``ERR_ALREADY_IN_USE`` if this NetworkedMultiplayerEnet instance already has an open connection (in which case you need to call :ref:`close_connection<class_NetworkedMultiplayerENet_method_close_connection>` first) or ``ERR_CANT_CREATE`` if the client could not be created. If ``client_port`` is specified, the client will also listen to the given port, this is useful in some NAT traversal technique.
+Create client that connects to a server at ``address`` using specified ``port``. The given address needs to be either a fully qualified domain name (e.g. ``www.example.com``) or an IP address in IPv4 or IPv6 format (e.g. ``192.168.1.1``). The ``port`` is the port the server is listening on. The ``in_bandwidth`` and ``out_bandwidth`` parameters can be used to limit the incoming and outgoing bandwidth to the given number of bytes per second. The default of 0 means unlimited bandwidth. Note that ENet will strategically drop packets on specific sides of a connection between peers to ensure the peer's bandwidth is not overwhelmed. The bandwidth parameters also determine the window size of a connection which limits the amount of reliable packets that may be in transit at any given time. Returns ``OK`` if a client was created, ``ERR_ALREADY_IN_USE`` if this NetworkedMultiplayerEnet instance already has an open connection (in which case you need to call :ref:`close_connection<class_NetworkedMultiplayerENet_method_close_connection>` first) or ``ERR_CANT_CREATE`` if the client could not be created. If ``client_port`` is specified, the client will also listen to the given port, this is useful in some NAT traversal technique.
 
 .. _class_NetworkedMultiplayerENet_method_create_server:
 

classes/class_optionbutton.rst

@@ -41,6 +41,8 @@ Methods
 +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`             | :ref:`get_item_id<class_OptionButton_method_get_item_id>` **(** :ref:`int<class_int>` idx **)** const                                                                           |
 +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`             | :ref:`get_item_index<class_OptionButton_method_get_item_index>` **(** :ref:`int<class_int>` id **)** const                                                                      |
++-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Variant<class_Variant>`     | :ref:`get_item_metadata<class_OptionButton_method_get_item_metadata>` **(** :ref:`int<class_int>` idx **)** const                                                               |
 +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`String<class_String>`       | :ref:`get_item_text<class_OptionButton_method_get_item_text>` **(** :ref:`int<class_int>` idx **)** const                                                                       |
@@ -106,13 +108,13 @@ Signals
 
 - **item_focused** **(** :ref:`int<class_int>` ID **)**
 
-This signal is emitted when user navigated to an item using ``ui_up`` or ``ui_down`` action. ID of the item selected is passed as argument (if no IDs were added, ID will be just the item index).
+This signal is emitted when user navigated to an item using ``ui_up`` or ``ui_down`` action. ID of the item selected is passed as argument.
 
 .. _class_OptionButton_signal_item_selected:
 
 - **item_selected** **(** :ref:`int<class_int>` ID **)**
 
-This signal is emitted when the current item was changed by the user. ID of the item selected is passed as argument (if no IDs were added, ID will be just the item index).
+This signal is emitted when the current item was changed by the user. Index of the item selected is passed as argument.
 
 Description
 -----------
@@ -173,7 +175,13 @@ Return the icon of the item at index "idx".
 
 - :ref:`int<class_int>` **get_item_id** **(** :ref:`int<class_int>` idx **)** const
 
-Return the ID of the item at index "idx".
+Return the ID of the item at index ``idx``.
+
+.. _class_OptionButton_method_get_item_index:
+
+- :ref:`int<class_int>` **get_item_index** **(** :ref:`int<class_int>` id **)** const
+
+Return the index of the item with the given ``id``.
 
 .. _class_OptionButton_method_get_item_metadata:
 

classes/class_os.rst

@@ -85,6 +85,8 @@ Methods
 +-----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`PoolStringArray<class_PoolStringArray>` | :ref:`get_connected_midi_inputs<class_OS_method_get_connected_midi_inputs>` **(** **)**                                                                                                                                         |
 +-----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`VideoDriver<enum_OS_VideoDriver>`       | :ref:`get_current_video_driver<class_OS_method_get_current_video_driver>` **(** **)** const                                                                                                                                     |
++-----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Dictionary<class_Dictionary>`           | :ref:`get_date<class_OS_method_get_date>` **(** :ref:`bool<class_bool>` utc=false **)** const                                                                                                                                   |
 +-----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Dictionary<class_Dictionary>`           | :ref:`get_datetime<class_OS_method_get_datetime>` **(** :ref:`bool<class_bool>` utc=false **)** const                                                                                                                           |
@@ -161,7 +163,7 @@ Methods
 +-----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`                         | :ref:`get_video_driver_count<class_OS_method_get_video_driver_count>` **(** **)** const                                                                                                                                         |
 +-----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`String<class_String>`                   | :ref:`get_video_driver_name<class_OS_method_get_video_driver_name>` **(** :ref:`int<class_int>` driver **)** const                                                                                                              |
+| :ref:`String<class_String>`                   | :ref:`get_video_driver_name<class_OS_method_get_video_driver_name>` **(** :ref:`VideoDriver<enum_OS_VideoDriver>` driver **)** const                                                                                            |
 +-----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`                         | :ref:`get_virtual_keyboard_height<class_OS_method_get_virtual_keyboard_height>` **(** **)**                                                                                                                                     |
 +-----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -237,6 +239,18 @@ Methods
 Enumerations
 ------------
 
+.. _enum_OS_VideoDriver:
+
+.. _class_OS_constant_VIDEO_DRIVER_GLES2:
+
+.. _class_OS_constant_VIDEO_DRIVER_GLES3:
+
+enum **VideoDriver**:
+
+- **VIDEO_DRIVER_GLES2** = **1** --- The GLES2 rendering backend. It uses OpenGL ES 2.0 on mobile devices, OpenGL 2.1 on desktop platforms and WebGL 1.0 on the web.
+
+- **VIDEO_DRIVER_GLES3** = **0** --- The GLES3 rendering backend. It uses OpenGL ES 3.0 on mobile devices, OpenGL 3.3 on desktop platforms and WebGL 2.0 on the web.
+
 .. _enum_OS_Weekday:
 
 .. _class_OS_constant_DAY_SUNDAY:
@@ -723,6 +737,12 @@ Returns the command line arguments passed to the engine.
 
 - :ref:`PoolStringArray<class_PoolStringArray>` **get_connected_midi_inputs** **(** **)**
 
+.. _class_OS_method_get_current_video_driver:
+
+- :ref:`VideoDriver<enum_OS_VideoDriver>` **get_current_video_driver** **(** **)** const
+
+Returns the currently used video driver, using one of the values from :ref:`VideoDriver<enum_OS_VideoDriver>`.
+
 .. _class_OS_method_get_date:
 
 - :ref:`Dictionary<class_Dictionary>` **get_date** **(** :ref:`bool<class_bool>` utc=false **)** const
@@ -979,9 +999,13 @@ If the project name is empty, ``user://`` falls back to ``res://``.
 
 - :ref:`int<class_int>` **get_video_driver_count** **(** **)** const
 
+Returns the number of video drivers supported on the current platform.
+
 .. _class_OS_method_get_video_driver_name:
 
-- :ref:`String<class_String>` **get_video_driver_name** **(** :ref:`int<class_int>` driver **)** const
+- :ref:`String<class_String>` **get_video_driver_name** **(** :ref:`VideoDriver<enum_OS_VideoDriver>` driver **)** const
+
+Returns the name of the video driver matching the given ``driver`` index. This index is a value from :ref:`VideoDriver<enum_OS_VideoDriver>`, and you can use :ref:`get_current_video_driver<class_OS_method_get_current_video_driver>` to get the current backend's index.
 
 .. _class_OS_method_get_virtual_keyboard_height:
 

classes/class_physics2dserver.rst

@@ -246,6 +246,8 @@ Enumerations
 
 .. _class_Physics2DServer_constant_SPACE_PARAM_CONSTRAINT_DEFAULT_BIAS:
 
+.. _class_Physics2DServer_constant_SPACE_PARAM_TEST_MOTION_MIN_CONTACT_DEPTH:
+
 enum **SpaceParameter**:
 
 - **SPACE_PARAM_CONTACT_RECYCLE_RADIUS** = **0** --- Constant to set/get the maximum distance a pair of bodies has to move before their collision status has to be recalculated.
@@ -262,6 +264,8 @@ enum **SpaceParameter**:
 
 - **SPACE_PARAM_CONSTRAINT_DEFAULT_BIAS** = **6** --- Constant to set/get the default solver bias for all physics constraints. A solver bias is a factor controlling how much two objects "rebound", after violating a constraint, to avoid leaving them in that state because of numerical imprecision.
 
+- **SPACE_PARAM_TEST_MOTION_MIN_CONTACT_DEPTH** = **7**
+
 .. _enum_Physics2DServer_ShapeType:
 
 .. _class_Physics2DServer_constant_SHAPE_LINE:

classes/class_physicsserver.rst

@@ -784,6 +784,8 @@ enum **ProcessInfo**:
 
 .. _class_PhysicsServer_constant_SPACE_PARAM_CONSTRAINT_DEFAULT_BIAS:
 
+.. _class_PhysicsServer_constant_SPACE_PARAM_TEST_MOTION_MIN_CONTACT_DEPTH:
+
 enum **SpaceParameter**:
 
 - **SPACE_PARAM_CONTACT_RECYCLE_RADIUS** = **0** --- Constant to set/get the maximum distance a pair of bodies has to move before their collision status has to be recalculated.
@@ -802,6 +804,8 @@ enum **SpaceParameter**:
 
 - **SPACE_PARAM_CONSTRAINT_DEFAULT_BIAS** = **7** --- Constant to set/get the default solver bias for all physics constraints. A solver bias is a factor controlling how much two objects "rebound", after violating a constraint, to avoid leaving them in that state because of numerical imprecision.
 
+- **SPACE_PARAM_TEST_MOTION_MIN_CONTACT_DEPTH** = **8**
+
 .. _enum_PhysicsServer_BodyAxis:
 
 .. _class_PhysicsServer_constant_BODY_AXIS_LINEAR_X:

classes/class_randomnumbergenerator.rst

@@ -51,6 +51,8 @@ Property Descriptions
 | *Getter* | get_seed()      |
 +----------+-----------------+
 
+The seed used by the random number generator. A given seed will give a reproducible sequence of pseudo-random numbers.
+
 Method Descriptions
 -------------------
 
@@ -76,7 +78,7 @@ Generates pseudo-random 32-bit unsigned integer between '0' and '4294967295'.
 
 - :ref:`int<class_int>` **randi_range** **(** :ref:`int<class_int>` from, :ref:`int<class_int>` to **)**
 
-Generates pseudo-random 32-bit signed integer between ``from`` and ``to``\ (inclusive).
+Generates pseudo-random 32-bit signed integer between ``from`` and ``to`` (inclusive).
 
 .. _class_RandomNumberGenerator_method_randomize:
 

classes/class_resource.rst

@@ -56,7 +56,12 @@ Signals
 Description
 -----------
 
-Resource is the base class for all resource types. Resources are primarily data containers. They are reference counted and freed when no longer in use. They are also loaded only once from disk, and further attempts to load the resource will return the same reference (all this in contrast to a :ref:`Node<class_Node>`, which is not reference counted and can be instanced from disk as many times as desired). Resources can be saved externally on disk or bundled into another object, such as a :ref:`Node<class_Node>` or another resource.
+Resource is the base class for all resource types, serving primarily as data containers. They are reference counted and freed when no longer in use. They are also loaded only once from disk, and further attempts to load the resource will return the same reference (all this in contrast to a :ref:`Node<class_Node>`, which is not reference counted and can be instanced from disk as many times as desired). Resources can be saved externally on disk or bundled into another object, such as a :ref:`Node<class_Node>` or another resource.
+
+Tutorials
+---------
+
+- :doc:`../getting_started/step_by_step/resources`
 
 Property Descriptions
 ---------------------
@@ -81,6 +86,8 @@ Property Descriptions
 | *Getter* | get_name()      |
 +----------+-----------------+
 
+The name of the resource. This is an optional identifier.
+
 .. _class_Resource_property_resource_path:
 
 - :ref:`String<class_String>` **resource_path**
@@ -91,6 +98,8 @@ Property Descriptions
 | *Getter* | get_path()      |
 +----------+-----------------+
 
+The path to the resource. In case it has its own file, it will return its filepath. If it's tied to the scene, it will return the scene's path, followed by the resource's index.
+
 Method Descriptions
 -------------------
 
@@ -102,6 +111,8 @@ Method Descriptions
 
 - :ref:`Resource<class_Resource>` **duplicate** **(** :ref:`bool<class_bool>` subresources=false **)** const
 
+Duplicates the resource, returning a new resource. By default, sub-resources are shared between resource copies for efficiency, this can be changed by passing ``true`` to the ``subresources`` argument.
+
 .. _class_Resource_method_get_local_scene:
 
 - :ref:`Node<class_Node>` **get_local_scene** **(** **)** const
@@ -110,7 +121,7 @@ Method Descriptions
 
 - :ref:`RID<class_RID>` **get_rid** **(** **)** const
 
-Return the RID of the resource (or an empty RID). Many resources (such as :ref:`Texture<class_Texture>`, :ref:`Mesh<class_Mesh>`, etc) are high level abstractions of resources stored in a server, so this function will return the original RID.
+Returns the RID of the resource (or an empty RID). Many resources (such as :ref:`Texture<class_Texture>`, :ref:`Mesh<class_Mesh>`, etc) are high level abstractions of resources stored in a server, so this function will return the original RID.
 
 .. _class_Resource_method_setup_local_to_scene:
 
@@ -120,5 +131,5 @@ Return the RID of the resource (or an empty RID). Many resources (such as :ref:`
 
 - void **take_over_path** **(** :ref:`String<class_String>` path **)**
 
-Set the path of the resource. Differs from set_path(), if another ``Resource`` exists with "path" it over-takes it, instead of failing.
+Sets the path of the resource. Differs from ``set_path()``, if another ``Resource`` exists with "path" it over-takes it, instead of failing.
 

classes/class_skeleton2d.rst

@@ -27,6 +27,13 @@ Methods
 | :ref:`RID<class_RID>`       | :ref:`get_skeleton<class_Skeleton2D_method_get_skeleton>` **(** **)** const             |
 +-----------------------------+-----------------------------------------------------------------------------------------+
 
+Signals
+-------
+
+.. _class_Skeleton2D_signal_bone_setup_changed:
+
+- **bone_setup_changed** **(** **)**
+
 Method Descriptions
 -------------------
 

classes/class_surfacetool.rst

@@ -32,7 +32,7 @@ Methods
 +-----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                              | :ref:`add_tangent<class_SurfaceTool_method_add_tangent>` **(** :ref:`Plane<class_Plane>` tangent **)**                                                                                                                                                                                                                                                                                                                                                                                     |
 +-----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                              | :ref:`add_triangle_fan<class_SurfaceTool_method_add_triangle_fan>` **(** :ref:`PoolVector3Array<class_PoolVector3Array>` vertexes, :ref:`PoolVector2Array<class_PoolVector2Array>` uvs=PoolVector2Array(  ), :ref:`PoolColorArray<class_PoolColorArray>` colors=PoolColorArray(  ), :ref:`PoolVector2Array<class_PoolVector2Array>` uv2s=PoolVector2Array(  ), :ref:`PoolVector3Array<class_PoolVector3Array>` normals=PoolVector3Array(  ), :ref:`Array<class_Array>` tangents=[  ] **)** |
+| void                              | :ref:`add_triangle_fan<class_SurfaceTool_method_add_triangle_fan>` **(** :ref:`PoolVector3Array<class_PoolVector3Array>` vertices, :ref:`PoolVector2Array<class_PoolVector2Array>` uvs=PoolVector2Array(  ), :ref:`PoolColorArray<class_PoolColorArray>` colors=PoolColorArray(  ), :ref:`PoolVector2Array<class_PoolVector2Array>` uv2s=PoolVector2Array(  ), :ref:`PoolVector3Array<class_PoolVector3Array>` normals=PoolVector3Array(  ), :ref:`Array<class_Array>` tangents=[  ] **)** |
 +-----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                              | :ref:`add_uv<class_SurfaceTool_method_add_uv>` **(** :ref:`Vector2<class_Vector2>` uv **)**                                                                                                                                                                                                                                                                                                                                                                                                |
 +-----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -123,7 +123,7 @@ Specify a Tangent for the next Vertex to use.
 
 .. _class_SurfaceTool_method_add_triangle_fan:
 
-- void **add_triangle_fan** **(** :ref:`PoolVector3Array<class_PoolVector3Array>` vertexes, :ref:`PoolVector2Array<class_PoolVector2Array>` uvs=PoolVector2Array(  ), :ref:`PoolColorArray<class_PoolColorArray>` colors=PoolColorArray(  ), :ref:`PoolVector2Array<class_PoolVector2Array>` uv2s=PoolVector2Array(  ), :ref:`PoolVector3Array<class_PoolVector3Array>` normals=PoolVector3Array(  ), :ref:`Array<class_Array>` tangents=[  ] **)**
+- void **add_triangle_fan** **(** :ref:`PoolVector3Array<class_PoolVector3Array>` vertices, :ref:`PoolVector2Array<class_PoolVector2Array>` uvs=PoolVector2Array(  ), :ref:`PoolColorArray<class_PoolColorArray>` colors=PoolColorArray(  ), :ref:`PoolVector2Array<class_PoolVector2Array>` uv2s=PoolVector2Array(  ), :ref:`PoolVector3Array<class_PoolVector3Array>` normals=PoolVector3Array(  ), :ref:`Array<class_Array>` tangents=[  ] **)**
 
 Insert a triangle fan made of array data into :ref:`Mesh<class_Mesh>` being constructed.
 

classes/class_tabcontainer.rst

@@ -98,6 +98,8 @@ Theme Properties
 +---------------------------------+---------------------+
 | :ref:`StyleBox<class_StyleBox>` | tab_bg              |
 +---------------------------------+---------------------+
+| :ref:`StyleBox<class_StyleBox>` | tab_disabled        |
++---------------------------------+---------------------+
 | :ref:`StyleBox<class_StyleBox>` | tab_fg              |
 +---------------------------------+---------------------+
 | :ref:`int<class_int>`           | top_margin          |

classes/class_tabs.rst

@@ -108,6 +108,8 @@ Theme Properties
 +---------------------------------+---------------------+
 | :ref:`StyleBox<class_StyleBox>` | tab_bg              |
 +---------------------------------+---------------------+
+| :ref:`StyleBox<class_StyleBox>` | tab_disabled        |
++---------------------------------+---------------------+
 | :ref:`StyleBox<class_StyleBox>` | tab_fg              |
 +---------------------------------+---------------------+
 | :ref:`int<class_int>`           | top_margin          |

classes/class_tilemap.rst

@@ -377,7 +377,7 @@ Clears cells that do not exist in the tileset.
 
 - :ref:`int<class_int>` **get_cell** **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y **)** const
 
-Returns the tile index of the given cell.
+Returns the tile index of the given cell. If no tile exists in the cell, returns :ref:`INVALID_CELL<class_TileMap_constant_INVALID_CELL>`.
 
 .. _class_TileMap_method_get_cell_autotile_coord:
 
@@ -387,7 +387,7 @@ Returns the tile index of the given cell.
 
 - :ref:`int<class_int>` **get_cellv** **(** :ref:`Vector2<class_Vector2>` position **)** const
 
-Returns the tile index of the cell given by a Vector2.
+Returns the tile index of the cell given by a Vector2. If no tile exists in the cell, returns :ref:`INVALID_CELL<class_TileMap_constant_INVALID_CELL>`.
 
 .. _class_TileMap_method_get_collision_layer_bit: