Sync classref with current source

classes/[email protected]

@@ -541,11 +541,13 @@ Rounds ``s`` to the closest smaller integer and returns it.
 
 ::
 
-    # a is 2
+    # a is 2.0
     a = floor(2.99)
-    # a is -3
+    # a is -3.0
     a = floor(-2.99)
 
+**Note:** This method returns a float. If you need an integer, you can use ``int(s)`` directly.
+
 ----
 
 .. _class_@GDScript_method_fmod:
@@ -702,7 +704,7 @@ Returns a normalized value considering the given range.
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b **)**
 
-Returns True/False whether ``a`` and ``b`` are approximately equal to each other.
+Returns ``true`` if ``a`` and ``b`` are approximately equal to each other.
 
 ----
 
@@ -734,7 +736,7 @@ Returns whether ``s`` is a NaN (Not-A-Number) value.
 
 - :ref:`bool<class_bool>` **is_zero_approx** **(** :ref:`float<class_float>` s **)**
 
-Returns True/False whether ``s`` is zero or almost zero.
+Returns ``true`` if ``s`` is zero or almost zero.
 
 ----
 

classes/class_aabb.rst

@@ -290,11 +290,13 @@ Returns ``true`` if the ``AABB`` intersects the line segment between ``from`` an
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`AABB<class_AABB>` aabb **)**
 
+Returns ``true`` if this ``AABB`` and ``aabb`` are approximately equal, by calling ``is_equal_approx`` on each component.
+
 ----
 
 .. _class_AABB_method_merge:
 
 - :ref:`AABB<class_AABB>` **merge** **(** :ref:`AABB<class_AABB>` with **)**
 
-Returns a larger AABB that contains this AABB and ``with``.
+Returns a larger ``AABB`` that contains both this ``AABB`` and ``with``.
 

classes/class_basis.rst

@@ -221,6 +221,8 @@ Returns the inverse of the matrix.
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Basis<class_Basis>` b, :ref:`float<class_float>` epsilon=0.00001 **)**
 
+Returns ``true`` if this basis and ``b`` are approximately equal, by calling ``is_equal_approx`` on each component.
+
 ----
 
 .. _class_Basis_method_orthonormalized:

classes/class_camera.rst

@@ -133,11 +133,11 @@ enum **KeepAspect**:
 
 enum **DopplerTracking**:
 
-- **DOPPLER_TRACKING_DISABLED** = **0** --- Disables Doppler effect simulation (default).
+- **DOPPLER_TRACKING_DISABLED** = **0** --- Disables `Doppler effect <https://en.wikipedia.org/wiki/Doppler_effect>`_ simulation (default).
 
-- **DOPPLER_TRACKING_IDLE_STEP** = **1** --- Simulate Doppler effect by tracking positions of objects that are changed in ``_process``. Changes in the relative velocity of this camera compared to those objects affect how Audio is perceived (changing the Audio's ``pitch shift``).
+- **DOPPLER_TRACKING_IDLE_STEP** = **1** --- Simulate `Doppler effect <https://en.wikipedia.org/wiki/Doppler_effect>`_ by tracking positions of objects that are changed in ``_process``. Changes in the relative velocity of this camera compared to those objects affect how Audio is perceived (changing the Audio's ``pitch shift``).
 
-- **DOPPLER_TRACKING_PHYSICS_STEP** = **2** --- Simulate Doppler effect by tracking positions of objects that are changed in ``_physics_process``. Changes in the relative velocity of this camera compared to those objects affect how Audio is perceived (changing the Audio's ``pitch shift``).
+- **DOPPLER_TRACKING_PHYSICS_STEP** = **2** --- Simulate `Doppler effect <https://en.wikipedia.org/wiki/Doppler_effect>`_ by tracking positions of objects that are changed in ``_physics_process``. Changes in the relative velocity of this camera compared to those objects affect how Audio is perceived (changing the Audio's ``pitch shift``).
 
 Description
 -----------
@@ -191,7 +191,7 @@ If ``true``, the ancestor :ref:`Viewport<class_Viewport>` is currently using thi
 | *Getter*  | get_doppler_tracking()      |
 +-----------+-----------------------------+
 
-If not :ref:`DOPPLER_TRACKING_DISABLED<class_Camera_constant_DOPPLER_TRACKING_DISABLED>`, this camera will simulate the Doppler effect for objects changed in particular ``_process`` methods. See :ref:`DopplerTracking<enum_Camera_DopplerTracking>` for possible values.
+If not :ref:`DOPPLER_TRACKING_DISABLED<class_Camera_constant_DOPPLER_TRACKING_DISABLED>`, this camera will simulate the `Doppler effect <https://en.wikipedia.org/wiki/Doppler_effect>`_ for objects changed in particular ``_process`` methods. See :ref:`DopplerTracking<enum_Camera_DopplerTracking>` for possible values.
 
 ----
 
@@ -253,6 +253,8 @@ The camera's field of view angle (in degrees). Only applicable in perspective mo
 | *Getter*  | get_frustum_offset()      |
 +-----------+---------------------------+
 
+The camera's frustum offset. This can be changed from the default to create "tilted frustum" effects such as `Y-shearing <https://zdoom.org/wiki/Y-shearing>`_.
+
 ----
 
 .. _class_Camera_property_h_offset:
@@ -380,12 +382,16 @@ Gets the camera transform. Subclassed cameras such as :ref:`InterpolatedCamera<c
 
 - :ref:`bool<class_bool>` **get_cull_mask_bit** **(** :ref:`int<class_int>` layer **)** const
 
+Returns ``true`` if the given ``layer`` in the :ref:`cull_mask<class_Camera_property_cull_mask>` is enabled, ``false`` otherwise.
+
 ----
 
 .. _class_Camera_method_get_frustum:
 
 - :ref:`Array<class_Array>` **get_frustum** **(** **)** const
 
+Returns the camera's frustum planes in world-space units as an array of :ref:`Plane<class_Plane>`\ s in the following order: near, far, left, top, right, bottom. Not to be confused with :ref:`frustum_offset<class_Camera_property_frustum_offset>`.
+
 ----
 
 .. _class_Camera_method_is_position_behind:
@@ -442,19 +448,23 @@ Returns a 3D position in worldspace, that is the result of projecting a point on
 
 - void **set_cull_mask_bit** **(** :ref:`int<class_int>` layer, :ref:`bool<class_bool>` enable **)**
 
+Enables or disables the given ``layer`` in the :ref:`cull_mask<class_Camera_property_cull_mask>`.
+
 ----
 
 .. _class_Camera_method_set_frustum:
 
 - void **set_frustum** **(** :ref:`float<class_float>` size, :ref:`Vector2<class_Vector2>` offset, :ref:`float<class_float>` z_near, :ref:`float<class_float>` z_far **)**
 
+Sets the camera projection to frustum mode (see :ref:`PROJECTION_FRUSTUM<class_Camera_constant_PROJECTION_FRUSTUM>`), by specifying a ``size``, an ``offset``, and the ``z_near`` and ``z_far`` clip planes in world-space units.
+
 ----
 
 .. _class_Camera_method_set_orthogonal:
 
 - void **set_orthogonal** **(** :ref:`float<class_float>` size, :ref:`float<class_float>` z_near, :ref:`float<class_float>` z_far **)**
 
-Sets the camera projection to orthogonal mode, by specifying a width and the ``near`` and ``far`` clip planes in worldspace units. (As a hint, 2D games often use this projection, with values specified in pixels)
+Sets the camera projection to orthogonal mode (see :ref:`PROJECTION_ORTHOGONAL<class_Camera_constant_PROJECTION_ORTHOGONAL>`), by specifying a ``size``, and the ``z_near`` and ``z_far`` clip planes in world-space units. (As a hint, 2D games often use this projection, with values specified in pixels.)
 
 ----
 
@@ -462,7 +472,7 @@ Sets the camera projection to orthogonal mode, by specifying a width and the ``n
 
 - void **set_perspective** **(** :ref:`float<class_float>` fov, :ref:`float<class_float>` z_near, :ref:`float<class_float>` z_far **)**
 
-Sets the camera projection to perspective mode, by specifying a ``fov`` angle in degrees (FOV means Field of View), and the ``near`` and ``far`` clip planes in world-space units.
+Sets the camera projection to perspective mode (see :ref:`PROJECTION_PERSPECTIVE<class_Camera_constant_PROJECTION_PERSPECTIVE>`), by specifying a ``fov`` (field of view) angle in degrees, and the ``z_near`` and ``z_far`` clip planes in world-space units.
 
 ----
 

classes/class_color.rst

@@ -948,6 +948,8 @@ Returns the inverted color ``(1 - r, 1 - g, 1 - b, a)``.
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Color<class_Color>` color **)**
 
+Returns ``true`` if this color and ``color`` are approximately equal, by running :ref:`@GDScript.is_equal_approx<class_@GDScript_method_is_equal_approx>` on each component.
+
 ----
 
 .. _class_Color_method_lightened:

classes/class_dynamicfont.rst

@@ -88,7 +88,9 @@ enum **SpacingType**:
 Description
 -----------
 
-DynamicFont renders vector font files (such as TTF or OTF) dynamically at runtime instead of using a prerendered texture atlas like :ref:`BitmapFont<class_BitmapFont>`. This trades the faster loading time of :ref:`BitmapFont<class_BitmapFont>`\ s for the ability to change font parameters like size and spacing during runtime. :ref:`DynamicFontData<class_DynamicFontData>` is used for referencing the font file paths.
+DynamicFont renders vector font files (such as TTF or OTF) dynamically at runtime instead of using a prerendered texture atlas like :ref:`BitmapFont<class_BitmapFont>`. This trades the faster loading time of :ref:`BitmapFont<class_BitmapFont>`\ s for the ability to change font parameters like size and spacing during runtime. :ref:`DynamicFontData<class_DynamicFontData>` is used for referencing the font file paths. DynamicFont also supports defining one or more fallbacks fonts, which will be used when displaying a character not supported by the main font.
+
+DynamicFont uses the `FreeType <https://www.freetype.org/>`_ library for rasterization.
 
 ::
 
@@ -190,6 +192,10 @@ The font data.
 | *Getter*  | get_outline_color()      |
 +-----------+--------------------------+
 
+The font outline's color.
+
+**Note:** It's recommended to leave this at the default value so that you can adjust it in individual controls. For example, if the outline is made black here, it won't be possible to change its color using a Label's font outline modulate theme item.
+
 ----
 
 .. _class_DynamicFont_property_outline_size:
@@ -204,6 +210,8 @@ The font data.
 | *Getter*  | get_outline_size()      |
 +-----------+-------------------------+
 
+The font outline's thickness in pixels (not relative to the font size).
+
 ----
 
 .. _class_DynamicFont_property_size:
@@ -218,7 +226,7 @@ The font data.
 | *Getter*  | get_size()      |
 +-----------+-----------------+
 
-The font size.
+The font size in pixels.
 
 ----
 
@@ -234,7 +242,7 @@ The font size.
 | *Getter*  | get_use_filter()      |
 +-----------+-----------------------+
 
-If ``true``, filtering is used.
+If ``true``, filtering is used. This makes the font blurry instead of pixelated when scaling it if font oversampling is disabled or ineffective. It's recommended to enable this when using the font in a control whose size changes over time, unless a pixel art aesthetic is desired.
 
 ----
 
@@ -250,7 +258,7 @@ If ``true``, filtering is used.
 | *Getter*  | get_use_mipmaps()      |
 +-----------+------------------------+
 
-If ``true``, mipmapping is used.
+If ``true``, mipmapping is used. This improves the font's appearance when downscaling it if font oversampling is disabled or ineffective.
 
 Method Descriptions
 -------------------
@@ -283,6 +291,8 @@ Returns the number of fallback fonts.
 
 - :ref:`int<class_int>` **get_spacing** **(** :ref:`int<class_int>` type **)** const
 
+Returns the spacing for the given ``type`` (see :ref:`SpacingType<enum_DynamicFont_SpacingType>`).
+
 ----
 
 .. _class_DynamicFont_method_remove_fallback:
@@ -305,3 +315,5 @@ Sets the fallback font at index ``idx``.
 
 - void **set_spacing** **(** :ref:`int<class_int>` type, :ref:`int<class_int>` value **)**
 
+Sets the spacing for ``type`` (see :ref:`SpacingType<enum_DynamicFont_SpacingType>`) to ``value`` in pixels (not relative to the font size).
+

classes/class_gdscript.rst

@@ -30,7 +30,7 @@ Methods
 Description
 -----------
 
-A script implemented in the GDScript programming language. The script exends the functionality of all objects that instance it.
+A script implemented in the GDScript programming language. The script extends the functionality of all objects that instance it.
 
 :ref:`new<class_GDScript_method_new>` creates a new instance of the script. :ref:`Object.set_script<class_Object_method_set_script>` extends an existing object, if that object's class matches one of the script's base classes.
 

classes/class_gridmap.rst

@@ -89,6 +89,8 @@ Signals
 
 - **cell_size_changed** **(** :ref:`Vector3<class_Vector3>` cell_size **)**
 
+Emitted when :ref:`cell_size<class_GridMap_property_cell_size>` changes.
+
 Constants
 ---------
 
@@ -99,13 +101,13 @@ Constants
 Description
 -----------
 
-GridMap lets you place meshes on a grid interactively. It works both from the editor and can help you create in-game level editors.
+GridMap lets you place meshes on a grid interactively. It works both from the editor and from scripts, which can help you create in-game level editors.
 
-GridMaps use a :ref:`MeshLibrary<class_MeshLibrary>` which contain a list of tiles: meshes with materials plus optional collisions and extra elements.
+GridMaps use a :ref:`MeshLibrary<class_MeshLibrary>` which contains a list of tiles. Each tile is a mesh with materials plus optional collision and navigation shapes.
 
-A GridMap contains a collection of cells. Each grid cell refers to a :ref:`MeshLibrary<class_MeshLibrary>` item. All cells in the map have the same dimensions.
+A GridMap contains a collection of cells. Each grid cell refers to a tile in the :ref:`MeshLibrary<class_MeshLibrary>`. All cells in the map have the same dimensions.
 
-A GridMap is split into a sparse collection of octants for efficient rendering and physics processing. Every octant has the same dimensions and can contain several cells.
+Internally, a GridMap is split into a sparse collection of octants for efficient rendering and physics processing. Every octant has the same dimensions and can contain several cells.
 
 Tutorials
 ---------
@@ -191,6 +193,10 @@ The size of each octant measured in number of cells. This applies to all three a
 | *Getter*  | get_cell_scale()      |
 +-----------+-----------------------+
 
+The scale of the cell items.
+
+This does not affect the size of the grid cells themselves, only the items in them. This can be used to make cell items overlap their neighbors.
+
 ----
 
 .. _class_GridMap_property_cell_size:
@@ -207,6 +213,8 @@ The size of each octant measured in number of cells. This applies to all three a
 
 The dimensions of the grid's cells.
 
+This does not affect the size of the meshes. See :ref:`cell_scale<class_GridMap_property_cell_scale>`.
+
 ----
 
 .. _class_GridMap_property_collision_layer:
@@ -221,6 +229,10 @@ The dimensions of the grid's cells.
 | *Getter*  | get_collision_layer()      |
 +-----------+----------------------------+
 
+The physics layers this GridMap is in.
+
+GridMaps act as static bodies, meaning they aren't affected by gravity or other forces. They only affect other physics bodies that collide with them.
+
 ----
 
 .. _class_GridMap_property_collision_mask:
@@ -235,6 +247,8 @@ The dimensions of the grid's cells.
 | *Getter*  | get_collision_mask()      |
 +-----------+---------------------------+
 
+The physics layers this GridMap detects collisions in.
+
 ----
 
 .. _class_GridMap_property_mesh_library:
@@ -298,19 +312,23 @@ The orientation of the cell at the grid-based X, Y and Z coordinates. -1 is retu
 
 - :ref:`bool<class_bool>` **get_collision_layer_bit** **(** :ref:`int<class_int>` bit **)** const
 
+Returns an individual bit on the :ref:`collision_layer<class_GridMap_property_collision_layer>`.
+
 ----
 
 .. _class_GridMap_method_get_collision_mask_bit:
 
 - :ref:`bool<class_bool>` **get_collision_mask_bit** **(** :ref:`int<class_int>` bit **)** const
 
+Returns an individual bit on the :ref:`collision_mask<class_GridMap_property_collision_mask>`.
+
 ----
 
 .. _class_GridMap_method_get_meshes:
 
 - :ref:`Array<class_Array>` **get_meshes** **(** **)**
 
-Array of :ref:`Transform<class_Transform>` and :ref:`Mesh<class_Mesh>` references corresponding to the non-empty cells in the grid. The transforms are specified in world space.
+Returns an array of :ref:`Transform<class_Transform>` and :ref:`Mesh<class_Mesh>` references corresponding to the non-empty cells in the grid. The transforms are specified in world space.
 
 ----
 
@@ -318,7 +336,7 @@ Array of :ref:`Transform<class_Transform>` and :ref:`Mesh<class_Mesh>` reference
 
 - :ref:`Array<class_Array>` **get_used_cells** **(** **)** const
 
-Array of :ref:`Vector3<class_Vector3>` with the non-empty cell coordinates in the grid map.
+Returns an array of :ref:`Vector3<class_Vector3>` with the non-empty cell coordinates in the grid map.
 
 ----
 
@@ -332,6 +350,8 @@ Array of :ref:`Vector3<class_Vector3>` with the non-empty cell coordinates in th
 
 - :ref:`Vector3<class_Vector3>` **map_to_world** **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y, :ref:`int<class_int>` z **)** const
 
+Returns the position of a grid cell in the GridMap's local coordinate space.
+
 ----
 
 .. _class_GridMap_method_resource_changed:
@@ -344,11 +364,11 @@ Array of :ref:`Vector3<class_Vector3>` with the non-empty cell coordinates in th
 
 - void **set_cell_item** **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y, :ref:`int<class_int>` z, :ref:`int<class_int>` item, :ref:`int<class_int>` orientation=0 **)**
 
-Set the mesh index for the cell referenced by its grid-based X, Y and Z coordinates.
+Sets the mesh index for the cell referenced by its grid-based X, Y and Z coordinates.
 
-A negative item index will clear the cell.
+A negative item index such as :ref:`INVALID_CELL_ITEM<class_GridMap_constant_INVALID_CELL_ITEM>` will clear the cell.
 
-Optionally, the item's orientation can be passed.
+Optionally, the item's orientation can be passed. For valid orientation values, see :ref:`Basis.get_orthogonal_index<class_Basis_method_get_orthogonal_index>`.
 
 ----
 
@@ -362,15 +382,23 @@ Optionally, the item's orientation can be passed.
 
 - void **set_collision_layer_bit** **(** :ref:`int<class_int>` bit, :ref:`bool<class_bool>` value **)**
 
+Sets an individual bit on the :ref:`collision_layer<class_GridMap_property_collision_layer>`.
+
 ----
 
 .. _class_GridMap_method_set_collision_mask_bit:
 
 - void **set_collision_mask_bit** **(** :ref:`int<class_int>` bit, :ref:`bool<class_bool>` value **)**
 
+Sets an individual bit on the :ref:`collision_mask<class_GridMap_property_collision_mask>`.
+
 ----
 
 .. _class_GridMap_method_world_to_map:
 
 - :ref:`Vector3<class_Vector3>` **world_to_map** **(** :ref:`Vector3<class_Vector3>` pos **)** const
 
+Returns the coordinates of the grid cell containing the given point.
+
+``pos`` should be in the GridMap's local coordinate space.
+

classes/class_line2d.rst

@@ -21,6 +21,8 @@ A 2D line.
 Properties
 ----------
 
++-----------------------------------------------------+---------------------------------------------------------------+-------------------------+
+| :ref:`bool<class_bool>`                             | :ref:`antialiased<class_Line2D_property_antialiased>`         | false                   |
 +-----------------------------------------------------+---------------------------------------------------------------+-------------------------+
 | :ref:`LineCapMode<enum_Line2D_LineCapMode>`         | :ref:`begin_cap_mode<class_Line2D_property_begin_cap_mode>`   | 0                       |
 +-----------------------------------------------------+---------------------------------------------------------------+-------------------------+
@@ -127,6 +129,22 @@ A line through several points in 2D space.
 Property Descriptions
 ---------------------
 
+.. _class_Line2D_property_antialiased:
+
+- :ref:`bool<class_bool>` **antialiased**
+
++-----------+------------------------+
+| *Default* | false                  |
++-----------+------------------------+
+| *Setter*  | set_antialiased(value) |
++-----------+------------------------+
+| *Getter*  | get_antialiased()      |
++-----------+------------------------+
+
+If ``true``, the line's border will be anti-aliased.
+
+----
+
 .. _class_Line2D_property_begin_cap_mode:
 
 - :ref:`LineCapMode<enum_Line2D_LineCapMode>` **begin_cap_mode**

classes/class_listener.rst

@@ -16,7 +16,7 @@ Listener
 Brief Description
 -----------------
 
-
+Overrides the location sounds are heard from.
 
 Methods
 -------
@@ -31,6 +31,13 @@ Methods
 | void                              | :ref:`make_current<class_Listener_method_make_current>` **(** **)**                           |
 +-----------------------------------+-----------------------------------------------------------------------------------------------+
 
+Description
+-----------
+
+Once added to the scene tree and enabled using :ref:`make_current<class_Listener_method_make_current>`, this node will override the location sounds are heard from. This can be used to listen from a location different from the :ref:`Camera<class_Camera>`.
+
+**Note:** There is no 2D equivalent for this node yet.
+
 Method Descriptions
 -------------------
 
@@ -38,21 +45,31 @@ Method Descriptions
 
 - void **clear_current** **(** **)**
 
+Disables the listener to use the current camera's listener instead.
+
 ----
 
 .. _class_Listener_method_get_listener_transform:
 
 - :ref:`Transform<class_Transform>` **get_listener_transform** **(** **)** const
 
+Returns the listener's global orthonormalized :ref:`Transform<class_Transform>`.
+
 ----
 
 .. _class_Listener_method_is_current:
 
 - :ref:`bool<class_bool>` **is_current** **(** **)** const
 
+Returns ``true`` if the listener was made current using :ref:`make_current<class_Listener_method_make_current>`, ``false`` otherwise.
+
+**Note:** There may be more than one Listener marked as "current" in the scene tree, but only the one that was made current last will be used.
+
 ----
 
 .. _class_Listener_method_make_current:
 
 - void **make_current** **(** **)**
 
+Enables the listener. This will override the current camera's listener.
+

classes/class_meshlibrary.rst

@@ -62,7 +62,7 @@ Methods
 Description
 -----------
 
-A library of meshes. Contains a list of :ref:`Mesh<class_Mesh>` resources, each with a name and ID. This resource is used in :ref:`GridMap<class_GridMap>`.
+A library of meshes. Contains a list of :ref:`Mesh<class_Mesh>` resources, each with a name and ID. Each item can also include collision and navigation shapes. This resource is used in :ref:`GridMap<class_GridMap>`.
 
 Method Descriptions
 -------------------
@@ -79,7 +79,9 @@ Clears the library.
 
 - void **create_item** **(** :ref:`int<class_int>` id **)**
 
-Create a new item in the library, supplied as an ID.
+Creates a new item in the library with the given ID.
+
+You can get an unused ID from :ref:`get_last_unused_item_id<class_MeshLibrary_method_get_last_unused_item_id>`.
 
 ----
 
@@ -87,13 +89,15 @@ Create a new item in the library, supplied as an ID.
 
 - :ref:`int<class_int>` **find_item_by_name** **(** :ref:`String<class_String>` name **)** const
 
+Returns the first item with the given name.
+
 ----
 
 .. _class_MeshLibrary_method_get_item_list:
 
 - :ref:`PoolIntArray<class_PoolIntArray>` **get_item_list** **(** **)** const
 
-Returns the list of items.
+Returns the list of item IDs in use.
 
 ----
 
@@ -101,7 +105,7 @@ Returns the list of items.
 
 - :ref:`Mesh<class_Mesh>` **get_item_mesh** **(** :ref:`int<class_int>` id **)** const
 
-Returns the mesh of the item.
+Returns the item's mesh.
 
 ----
 
@@ -109,7 +113,7 @@ Returns the mesh of the item.
 
 - :ref:`String<class_String>` **get_item_name** **(** :ref:`int<class_int>` id **)** const
 
-Returns the name of the item.
+Returns the item's name.
 
 ----
 
@@ -117,12 +121,16 @@ Returns the name of the item.
 
 - :ref:`NavigationMesh<class_NavigationMesh>` **get_item_navmesh** **(** :ref:`int<class_int>` id **)** const
 
+Returns the item's navigation mesh.
+
 ----
 
 .. _class_MeshLibrary_method_get_item_navmesh_transform:
 
 - :ref:`Transform<class_Transform>` **get_item_navmesh_transform** **(** :ref:`int<class_int>` id **)** const
 
+Returns the transform applied to the item's navigation mesh.
+
 ----
 
 .. _class_MeshLibrary_method_get_item_preview:
@@ -139,6 +147,10 @@ Returns a generated item preview (a 3D rendering in isometric perspective).
 
 - :ref:`Array<class_Array>` **get_item_shapes** **(** :ref:`int<class_int>` id **)** const
 
+Returns an item's collision shapes.
+
+The array consists of each :ref:`Shape<class_Shape>` followed by its :ref:`Transform<class_Transform>`.
+
 ----
 
 .. _class_MeshLibrary_method_get_last_unused_item_id:
@@ -171,27 +183,39 @@ Sets the item's mesh.
 
 Sets the item's name.
 
+This name is shown in the editor. It can also be used to look up the item later using :ref:`find_item_by_name<class_MeshLibrary_method_find_item_by_name>`.
+
 ----
 
 .. _class_MeshLibrary_method_set_item_navmesh:
 
 - void **set_item_navmesh** **(** :ref:`int<class_int>` id, :ref:`NavigationMesh<class_NavigationMesh>` navmesh **)**
 
+Sets the item's navigation mesh.
+
 ----
 
 .. _class_MeshLibrary_method_set_item_navmesh_transform:
 
 - void **set_item_navmesh_transform** **(** :ref:`int<class_int>` id, :ref:`Transform<class_Transform>` navmesh **)**
 
+Sets the transform to apply to the item's navigation mesh.
+
 ----
 
 .. _class_MeshLibrary_method_set_item_preview:
 
 - void **set_item_preview** **(** :ref:`int<class_int>` id, :ref:`Texture<class_Texture>` texture **)**
 
+Sets a texture to use as the item's preview icon in the editor.
+
 ----
 
 .. _class_MeshLibrary_method_set_item_shapes:
 
 - void **set_item_shapes** **(** :ref:`int<class_int>` id, :ref:`Array<class_Array>` shapes **)**
 
+Sets an item's collision shapes.
+
+The array should consist of :ref:`Shape<class_Shape>` objects, each followed by a :ref:`Transform<class_Transform>` that will be applied to it. For shapes that should not have a transform, use :ref:`Transform.IDENTITY<class_Transform_constant_IDENTITY>`.
+

classes/class_plane.rst

@@ -223,6 +223,8 @@ Returns the intersection point of a segment from position ``begin`` to position
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Plane<class_Plane>` plane **)**
 
+Returns ``true`` if this plane and ``plane`` are approximately equal, by running :ref:`@GDScript.is_equal_approx<class_@GDScript_method_is_equal_approx>` on each component.
+
 ----
 
 .. _class_Plane_method_is_point_over:

classes/class_quat.rst

@@ -205,6 +205,8 @@ Returns the inverse of the quaternion.
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Quat<class_Quat>` quat **)**
 
+Returns ``true`` if this quaterion and ``quat`` are approximately equal, by running :ref:`@GDScript.is_equal_approx<class_@GDScript_method_is_equal_approx>` on each component.
+
 ----
 
 .. _class_Quat_method_is_normalized:

classes/class_rect2.rst

@@ -218,11 +218,13 @@ Returns ``true`` if the ``Rect2`` overlaps with another.
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Rect2<class_Rect2>` rect **)**
 
+Returns ``true`` if this ``Rect2`` and ``rect`` are approximately equal, by calling ``is_equal_approx`` on each component.
+
 ----
 
 .. _class_Rect2_method_merge:
 
 - :ref:`Rect2<class_Rect2>` **merge** **(** :ref:`Rect2<class_Rect2>` b **)**
 
-Returns a larger Rect2 that contains this Rect2 and ``b``.
+Returns a larger ``Rect2`` that contains this ``Rect2`` and ``b``.
 

classes/class_script.rst

@@ -61,7 +61,7 @@ Methods
 Description
 -----------
 
-A class stored as a resource. A script exends the functionality of all objects that instance it.
+A class stored as a resource. A script extends the functionality of all objects that instance it.
 
 The ``new`` method of a script subclass creates a new instance. :ref:`Object.set_script<class_Object_method_set_script>` extends an existing object, if that object's class matches one of the script's base classes.
 

classes/class_transform.rst

@@ -181,6 +181,8 @@ Returns the inverse of the transform, under the assumption that the transformati
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Transform<class_Transform>` transform **)**
 
+Returns ``true`` if this transform and ``transform`` are approximately equal, by calling ``is_equal_approx`` on each component.
+
 ----
 
 .. _class_Transform_method_looking_at:

classes/class_transform2d.rst

@@ -216,6 +216,8 @@ Returns the inverse of the transform, under the assumption that the transformati
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Transform2D<class_Transform2D>` transform **)**
 
+Returns ``true`` if this transform and ``transform`` are approximately equal, by calling ``is_equal_approx`` on each component.
+
 ----
 
 .. _class_Transform2D_method_orthonormalized:

classes/class_vector2.rst

@@ -309,6 +309,8 @@ Returns the vector with all components rounded down.
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Vector2<class_Vector2>` v **)**
 
+Returns ``true`` if this vector and ``v`` are approximately equal, by running :ref:`@GDScript.is_equal_approx<class_@GDScript_method_is_equal_approx>` on each component.
+
 ----
 
 .. _class_Vector2_method_is_normalized:

classes/class_vector3.rst

@@ -309,6 +309,8 @@ Returns the inverse of the vector. This is the same as ``Vector3( 1.0 / v.x, 1.0
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Vector3<class_Vector3>` v **)**
 
+Returns ``true`` if this vector and ``v`` are approximately equal, by running :ref:`@GDScript.is_equal_approx<class_@GDScript_method_is_equal_approx>` on each component.
+
 ----
 
 .. _class_Vector3_method_is_normalized:

classes/class_visualserver.rst

@@ -72,7 +72,7 @@ Methods
 +---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                                    | :ref:`canvas_item_add_texture_rect_region<class_VisualServer_method_canvas_item_add_texture_rect_region>` **(** :ref:`RID<class_RID>` item, :ref:`Rect2<class_Rect2>` rect, :ref:`RID<class_RID>` texture, :ref:`Rect2<class_Rect2>` src_rect, :ref:`Color<class_Color>` modulate=Color( 1, 1, 1, 1 ), :ref:`bool<class_bool>` transpose=false, :ref:`RID<class_RID>` normal_map, :ref:`bool<class_bool>` clip_uv=true **)**                                                                                                                                                                                                                                    |
 +---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                                    | :ref:`canvas_item_add_triangle_array<class_VisualServer_method_canvas_item_add_triangle_array>` **(** :ref:`RID<class_RID>` item, :ref:`PoolIntArray<class_PoolIntArray>` indices, :ref:`PoolVector2Array<class_PoolVector2Array>` points, :ref:`PoolColorArray<class_PoolColorArray>` colors, :ref:`PoolVector2Array<class_PoolVector2Array>` uvs=PoolVector2Array(  ), :ref:`PoolIntArray<class_PoolIntArray>` bones=PoolIntArray(  ), :ref:`PoolRealArray<class_PoolRealArray>` weights=PoolRealArray(  ), :ref:`RID<class_RID>` texture, :ref:`int<class_int>` count=-1, :ref:`RID<class_RID>` normal_map **)**                                             |
+| void                                                    | :ref:`canvas_item_add_triangle_array<class_VisualServer_method_canvas_item_add_triangle_array>` **(** :ref:`RID<class_RID>` item, :ref:`PoolIntArray<class_PoolIntArray>` indices, :ref:`PoolVector2Array<class_PoolVector2Array>` points, :ref:`PoolColorArray<class_PoolColorArray>` colors, :ref:`PoolVector2Array<class_PoolVector2Array>` uvs=PoolVector2Array(  ), :ref:`PoolIntArray<class_PoolIntArray>` bones=PoolIntArray(  ), :ref:`PoolRealArray<class_PoolRealArray>` weights=PoolRealArray(  ), :ref:`RID<class_RID>` texture, :ref:`int<class_int>` count=-1, :ref:`RID<class_RID>` normal_map, :ref:`bool<class_bool>` antialiased=false **)**  |
 +---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                                    | :ref:`canvas_item_clear<class_VisualServer_method_canvas_item_clear>` **(** :ref:`RID<class_RID>` item **)**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 +---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -2070,7 +2070,7 @@ Adds a texture rect with region setting to the :ref:`CanvasItem<class_CanvasItem
 
 .. _class_VisualServer_method_canvas_item_add_triangle_array:
 
-- void **canvas_item_add_triangle_array** **(** :ref:`RID<class_RID>` item, :ref:`PoolIntArray<class_PoolIntArray>` indices, :ref:`PoolVector2Array<class_PoolVector2Array>` points, :ref:`PoolColorArray<class_PoolColorArray>` colors, :ref:`PoolVector2Array<class_PoolVector2Array>` uvs=PoolVector2Array(  ), :ref:`PoolIntArray<class_PoolIntArray>` bones=PoolIntArray(  ), :ref:`PoolRealArray<class_PoolRealArray>` weights=PoolRealArray(  ), :ref:`RID<class_RID>` texture, :ref:`int<class_int>` count=-1, :ref:`RID<class_RID>` normal_map **)**
+- void **canvas_item_add_triangle_array** **(** :ref:`RID<class_RID>` item, :ref:`PoolIntArray<class_PoolIntArray>` indices, :ref:`PoolVector2Array<class_PoolVector2Array>` points, :ref:`PoolColorArray<class_PoolColorArray>` colors, :ref:`PoolVector2Array<class_PoolVector2Array>` uvs=PoolVector2Array(  ), :ref:`PoolIntArray<class_PoolIntArray>` bones=PoolIntArray(  ), :ref:`PoolRealArray<class_PoolRealArray>` weights=PoolRealArray(  ), :ref:`RID<class_RID>` texture, :ref:`int<class_int>` count=-1, :ref:`RID<class_RID>` normal_map, :ref:`bool<class_bool>` antialiased=false **)**
 
 ----