classref: Sync with current 4.0 branch (d0c0d44)

classes/[email protected]

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/modules/gdscript/doc_classes/@GDScript.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/modules/gdscript/doc_classes/@GDScript.xml.
 
 .. _class_@GDScript:
 
@@ -133,7 +133,7 @@ Mark the following property as exported (editable in the Inspector dock and save
     @export var string = ""
     @export var int_number = 5
     @export var float_number: float = 5
-    @export var image : Image
+    @export var image: Image
 
 .. rst-class:: classref-item-separator
 
@@ -173,7 +173,7 @@ See also :ref:`@GlobalScope.PROPERTY_HINT_COLOR_NO_ALPHA<class_@GlobalScope_cons
 
 ::
 
-    @export_color_no_alpha var dye_color : Color
+    @export_color_no_alpha var dye_color: Color
 
 .. rst-class:: classref-item-separator
 
@@ -465,7 +465,7 @@ See also :ref:`@GlobalScope.PROPERTY_HINT_GLOBAL_FILE<class_@GlobalScope_constan
 
 Define a new group for the following exported properties. This helps to organize properties in the Inspector dock. Groups can be added with an optional ``prefix``, which would make group to only consider properties that have this prefix. The grouping will break on the first property that doesn't have a prefix. The prefix is also removed from the property's name in the Inspector dock.
 
-If no ``prefix`` is provided, the every following property is added to the group. The group ends when then next group or category is defined. You can also force end a group by using this annotation with empty strings for parameters, ``@export_group("", "")``.
+If no ``prefix`` is provided, then every following property will be added to the group. The group ends when then next group or category is defined. You can also force end a group by using this annotation with empty strings for parameters, ``@export_group("", "")``.
 
 Groups cannot be nested, use :ref:`@export_subgroup<class_@GDScript_annotation_@export_subgroup>` to add subgroups within groups.
 
@@ -712,7 +712,7 @@ Method Descriptions
 
 :ref:`Color<class_Color>` **Color8** **(** :ref:`int<class_int>` r8, :ref:`int<class_int>` g8, :ref:`int<class_int>` b8, :ref:`int<class_int>` a8=255 **)**
 
-Returns a :ref:`Color<class_Color>` constructed from red (``r8``), green (``g8``), blue (``b8``), and optionally alpha (``a8``) integer channels, each divided by ``255.0`` for their final value.
+Returns a :ref:`Color<class_Color>` constructed from red (``r8``), green (``g8``), blue (``b8``), and optionally alpha (``a8``) integer channels, each divided by ``255.0`` for their final value. Using :ref:`Color8<class_@GDScript_method_Color8>` instead of the standard :ref:`Color<class_Color>` constructor is useful when you need to match exact color values in an :ref:`Image<class_Image>`.
 
 ::
 
@@ -720,6 +720,8 @@ Returns a :ref:`Color<class_Color>` constructed from red (``r8``), green (``g8``
     var dark_blue = Color8(0, 0, 51)        # Same as Color(0, 0, 0.2).
     var my_color = Color8(306, 255, 0, 102) # Same as Color(1.2, 1, 0, 0.4).
 
+\ **Note:** Due to the lower precision of :ref:`Color8<class_@GDScript_method_Color8>` compared to the standard :ref:`Color<class_Color>` constructor, a color created with :ref:`Color8<class_@GDScript_method_Color8>` will generally not be equal to the same color created with the standard :ref:`Color<class_Color>` constructor. Use :ref:`Color.is_equal_approx<class_Color_method_is_equal_approx>` for comparisons to avoid issues with floating-point precision error.
+
 .. rst-class:: classref-item-separator
 
 ----
@@ -887,7 +889,7 @@ Examples:
     print(is_instance_of(a, MyClass))
     print(is_instance_of(a, MyClass.InnerClass))
 
-\ **Note:** If ``value`` and/or ``type`` are freed objects (see :ref:`@GlobalScope.is_instance_valid<class_@GlobalScope_method_is_instance_valid>`), or ``type`` is not one of the above options, this method will raise an runtime error.
+\ **Note:** If ``value`` and/or ``type`` are freed objects (see :ref:`@GlobalScope.is_instance_valid<class_@GlobalScope_method_is_instance_valid>`), or ``type`` is not one of the above options, this method will raise a runtime error.
 
 See also :ref:`@GlobalScope.typeof<class_@GlobalScope_method_typeof>`, :ref:`type_exists<class_@GDScript_method_type_exists>`, :ref:`Array.is_same_typed<class_Array_method_is_same_typed>` (and other :ref:`Array<class_Array>` methods).
 
@@ -936,6 +938,8 @@ This function is a simplified version of :ref:`ResourceLoader.load<class_Resourc
 
 \ **Note:** Files have to be imported into the engine first to load them using this function. If you want to load :ref:`Image<class_Image>`\ s at run-time, you may use :ref:`Image.load<class_Image_method_load>`. If you want to import audio files, you can use the snippet described in :ref:`AudioStreamMP3.data<class_AudioStreamMP3_property_data>`.
 
+\ **Note:** If :ref:`ProjectSettings.editor/export/convert_text_resources_to_binary<class_ProjectSettings_property_editor/export/convert_text_resources_to_binary>` is ``true``, :ref:`load<class_@GDScript_method_load>` will not be able to read converted files in an exported project. If you rely on run-time loading of files present within the PCK, set :ref:`ProjectSettings.editor/export/convert_text_resources_to_binary<class_ProjectSettings_property_editor/export/convert_text_resources_to_binary>` to ``false``.
+
 .. rst-class:: classref-item-separator
 
 ----

classes/[email protected]

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/@GlobalScope.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/@GlobalScope.xml.
 
 .. _class_@GlobalScope:
 
@@ -2823,7 +2823,7 @@ Enum value which doesn't correspond to any MIDI message. This is used to initial
 
 :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NOTE_OFF** = ``8``
 
-MIDI note OFF message. See the documentation of :ref:`InputEventMIDI<class_InputEventMIDI>` for information of how to use MIDI inputs.
+MIDI note OFF message. Not all MIDI devices send this event; some send :ref:`MIDI_MESSAGE_NOTE_ON<class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_ON>` with zero velocity instead. See the documentation of :ref:`InputEventMIDI<class_InputEventMIDI>` for information of how to use MIDI inputs.
 
 .. _class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_ON:
 
@@ -2831,7 +2831,7 @@ MIDI note OFF message. See the documentation of :ref:`InputEventMIDI<class_Input
 
 :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NOTE_ON** = ``9``
 
-MIDI note ON message. See the documentation of :ref:`InputEventMIDI<class_InputEventMIDI>` for information of how to use MIDI inputs.
+MIDI note ON message. Some MIDI devices send this event with velocity zero instead of :ref:`MIDI_MESSAGE_NOTE_OFF<class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_OFF>`, but implementations vary. See the documentation of :ref:`InputEventMIDI<class_InputEventMIDI>` for information of how to use MIDI inputs.
 
 .. _class_@GlobalScope_constant_MIDI_MESSAGE_AFTERTOUCH:
 
@@ -3758,7 +3758,7 @@ The property is shown in the :ref:`EditorInspector<class_EditorInspector>` (defa
 
 :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_INTERNAL** = ``8``
 
-
+The property is excluded from the class reference.
 
 .. _class_@GlobalScope_constant_PROPERTY_USAGE_CHECKABLE:
 
@@ -3966,7 +3966,7 @@ The property is read-only in the :ref:`EditorInspector<class_EditorInspector>`.
 
 :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_DEFAULT** = ``6``
 
-Default usage (storage, editor and network).
+Default usage (storage and editor).
 
 .. _class_@GlobalScope_constant_PROPERTY_USAGE_NO_EDITOR:
 
@@ -3974,7 +3974,7 @@ Default usage (storage, editor and network).
 
 :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NO_EDITOR** = ``2``
 
-Default usage but without showing the property in the editor (storage, network).
+Default usage but without showing the property in the editor (storage).
 
 .. rst-class:: classref-item-separator
 
@@ -5114,7 +5114,7 @@ Returns the absolute value of int parameter ``x`` (i.e. positive value).
 
 :ref:`float<class_float>` **acos** **(** :ref:`float<class_float>` x **)**
 
-Returns the arc cosine of ``x`` in radians. Use to get the angle of cosine ``x``. ``x`` must be between ``-1.0`` and ``1.0`` (inclusive), otherwise, :ref:`acos<class_@GlobalScope_method_acos>` will return :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`.
+Returns the arc cosine of ``x`` in radians. Use to get the angle of cosine ``x``. ``x`` will be clamped between ``-1.0`` and ``1.0`` (inclusive), in order to prevent :ref:`acos<class_@GlobalScope_method_acos>` from returning :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`.
 
 ::
 
@@ -5131,7 +5131,7 @@ Returns the arc cosine of ``x`` in radians. Use to get the angle of cosine ``x``
 
 :ref:`float<class_float>` **asin** **(** :ref:`float<class_float>` x **)**
 
-Returns the arc sine of ``x`` in radians. Use to get the angle of sine ``x``. ``x`` must be between ``-1.0`` and ``1.0`` (inclusive), otherwise, :ref:`asin<class_@GlobalScope_method_asin>` will return :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`.
+Returns the arc sine of ``x`` in radians. Use to get the angle of sine ``x``. ``x`` will be clamped between ``-1.0`` and ``1.0`` (inclusive), in order to prevent :ref:`asin<class_@GlobalScope_method_asin>` from returning :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`.
 
 ::
 
@@ -5904,7 +5904,7 @@ Linearly interpolates between two values by the factor defined in ``weight``. To
 
 ::
 
-    lerp(0, 4, 0.75) # Returns 3.0
+    lerpf(0, 4, 0.75) # Returns 3.0
 
 See also :ref:`inverse_lerp<class_@GlobalScope_method_inverse_lerp>` which performs the reverse of this operation. To perform eased interpolation with :ref:`lerp<class_@GlobalScope_method_lerp>`, combine it with :ref:`ease<class_@GlobalScope_method_ease>` or :ref:`smoothstep<class_@GlobalScope_method_smoothstep>`.
 
@@ -5939,9 +5939,9 @@ Converts from linear energy to decibels (audio). This can be used to implement v
 
 :ref:`float<class_float>` **log** **(** :ref:`float<class_float>` x **)**
 
-Returns the natural logarithm of ``x``. This is the amount of time needed to reach a certain level of continuous growth.
+Returns the `natural logarithm <https://en.wikipedia.org/wiki/Natural_logarithm>`__ of ``x`` (base `[i]e[/i] <https://en.wikipedia.org/wiki/E_(mathematical_constant)>`__, with *e* being approximately 2.71828). This is the amount of time needed to reach a certain level of continuous growth.
 
-\ **Note:** This is not the same as the "log" function on most calculators, which uses a base 10 logarithm.
+\ **Note:** This is not the same as the "log" function on most calculators, which uses a base 10 logarithm. To use base 10 logarithm, use ``log(x) / log(10)``.
 
 ::
 
@@ -6208,25 +6208,33 @@ Converts one or more arguments of any type to string in the best way possible an
 
 void **print_rich** **(** ... **)** |vararg|
 
-Converts one or more arguments of any type to string in the best way possible and prints them to the console. The following BBCode tags are supported: b, i, u, s, indent, code, url, center, right, color, bgcolor, fgcolor. Color tags only support named colors such as ``red``, *not* hexadecimal color codes. Unsupported tags will be left as-is in standard output.
+Converts one or more arguments of any type to string in the best way possible and prints them to the console.
+
+The following BBCode tags are supported: ``b``, ``i``, ``u``, ``s``, ``indent``, ``code``, ``url``, ``center``, ``right``, ``color``, ``bgcolor``, ``fgcolor``.
 
-When printing to standard output, the supported subset of BBCode is converted to ANSI escape codes for the terminal emulator to display. Displaying ANSI escape codes is currently only supported on Linux and macOS. Support for ANSI escape codes may vary across terminal emulators, especially for italic and strikethrough.
+Color tags only support the following named colors: ``black``, ``red``, ``green``, ``yellow``, ``blue``, ``magenta``, ``pink``, ``purple``, ``cyan``, ``white``, ``orange``, ``gray``. Hexadecimal color codes are not supported.
+
+URL tags only support URLs wrapped by an URL tag, not URLs with a different title.
+
+When printing to standard output, the supported subset of BBCode is converted to ANSI escape codes for the terminal emulator to display. Support for ANSI escape codes varies across terminal emulators, especially for italic and strikethrough. In standard output, ``code`` is represented with faint text but without any font change. Unsupported tags are left as-is in standard output.
 
 
 .. tabs::
 
  .. code-tab:: gdscript
 
-    print_rich("[code][b]Hello world![/b][/code]") # Prints out: [b]Hello world![/b]
+    print_rich("[color=green][b]Hello world![/b][/color]") # Prints out "Hello world!" in green with a bold font
 
  .. code-tab:: csharp
 
-    GD.PrintRich("[code][b]Hello world![/b][/code]"); // Prints out: [b]Hello world![/b]
+    GD.PrintRich("[color=green][b]Hello world![/b][/color]"); // Prints out "Hello world!" in green with a bold font
 
 
 
 \ **Note:** Consider using :ref:`push_error<class_@GlobalScope_method_push_error>` and :ref:`push_warning<class_@GlobalScope_method_push_warning>` to print error and warning messages instead of :ref:`print<class_@GlobalScope_method_print>` or :ref:`print_rich<class_@GlobalScope_method_print_rich>`. This distinguishes them from print messages used for debugging purposes, while also displaying a stack trace when an error or warning is printed.
 
+\ **Note:** On Windows, only Windows 10 and later correctly displays ANSI escape codes in standard output.
+
 .. rst-class:: classref-item-separator
 
 ----
@@ -6735,9 +6743,9 @@ Returns ``-1.0`` if ``x`` is negative, ``1.0`` if ``x`` is positive, and ``0.0``
 
 ::
 
-    sign(-6.5) # Returns -1.0
-    sign(0.0)  # Returns 0.0
-    sign(6.5)  # Returns 1.0
+    signf(-6.5) # Returns -1.0
+    signf(0.0)  # Returns 0.0
+    signf(6.5)  # Returns 1.0
 
 .. rst-class:: classref-item-separator
 
@@ -6753,9 +6761,9 @@ Returns ``-1`` if ``x`` is negative, ``1`` if ``x`` is positive, and ``0`` if if
 
 ::
 
-    sign(-6) # Returns -1
-    sign(0)  # Returns 0
-    sign(6)  # Returns 1
+    signi(-6) # Returns -1
+    signi(0)  # Returns 0
+    signi(6)  # Returns 1
 
 .. rst-class:: classref-item-separator
 
@@ -6859,8 +6867,8 @@ A type-safe version of :ref:`snapped<class_@GlobalScope_method_snapped>`, return
 
 ::
 
-    snapped(32.0, 2.5)  # Returns 32.5
-    snapped(3.14159, 0.01)  # Returns 3.14
+    snappedf(32.0, 2.5)  # Returns 32.5
+    snappedf(3.14159, 0.01)  # Returns 3.14
 
 .. rst-class:: classref-item-separator
 
@@ -6878,8 +6886,8 @@ A type-safe version of :ref:`snapped<class_@GlobalScope_method_snapped>`, return
 
 ::
 
-    snapped(53, 16)  # Returns 48
-    snapped(4096, 100)  # Returns 4100
+    snappedi(53, 16)  # Returns 48
+    snappedi(4096, 100)  # Returns 4100
 
 .. rst-class:: classref-item-separator
 

classes/class_aabb.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AABB.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AABB.xml.
 
 .. _class_AABB:
 
@@ -502,7 +502,7 @@ Returns ``true`` if the **AABB** is on both sides of a plane.
 
 :ref:`Variant<class_Variant>` **intersects_ray** **(** :ref:`Vector3<class_Vector3>` from, :ref:`Vector3<class_Vector3>` dir **)** |const|
 
-Returns ``true`` if the given ray intersects with this **AABB**. Ray length is infinite.
+Returns the point of intersection of the given ray with this **AABB** or ``null`` if there is no intersection. Ray length is infinite.
 
 .. rst-class:: classref-item-separator
 
@@ -514,7 +514,7 @@ Returns ``true`` if the given ray intersects with this **AABB**. Ray length is i
 
 :ref:`Variant<class_Variant>` **intersects_segment** **(** :ref:`Vector3<class_Vector3>` from, :ref:`Vector3<class_Vector3>` to **)** |const|
 
-Returns ``true`` if the **AABB** intersects the line segment between ``from`` and ``to``.
+Returns the point of intersection between ``from`` and ``to`` with this **AABB** or ``null`` if there is no intersection.
 
 .. rst-class:: classref-item-separator
 
@@ -567,7 +567,7 @@ Operator Descriptions
 
 :ref:`bool<class_bool>` **operator !=** **(** :ref:`AABB<class_AABB>` right **)**
 
-Returns ``true`` if the vectors are not equal.
+Returns ``true`` if the AABBs are not equal.
 
 \ **Note:** Due to floating-point precision errors, consider using :ref:`is_equal_approx<class_AABB_method_is_equal_approx>` instead, which is more reliable.
 

classes/class_acceptdialog.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AcceptDialog.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AcceptDialog.xml.
 
 .. _class_AcceptDialog:
 

classes/class_aescontext.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AESContext.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AESContext.xml.
 
 .. _class_AESContext:
 
@@ -34,27 +34,27 @@ This class provides access to AES encryption/decryption of raw data. Both AES-EC
         var key = "My secret key!!!" # Key must be either 16 or 32 bytes.
         var data = "My secret text!!" # Data size must be multiple of 16 bytes, apply padding if needed.
         # Encrypt ECB
-        aes.start(AESContext.MODE_ECB_ENCRYPT, key.to_utf8())
-        var encrypted = aes.update(data.to_utf8())
+        aes.start(AESContext.MODE_ECB_ENCRYPT, key.to_utf8_buffer())
+        var encrypted = aes.update(data.to_utf8_buffer())
         aes.finish()
         # Decrypt ECB
-        aes.start(AESContext.MODE_ECB_DECRYPT, key.to_utf8())
+        aes.start(AESContext.MODE_ECB_DECRYPT, key.to_utf8_buffer())
         var decrypted = aes.update(encrypted)
         aes.finish()
         # Check ECB
-        assert(decrypted == data.to_utf8())
+        assert(decrypted == data.to_utf8_buffer())
     
         var iv = "My secret iv!!!!" # IV must be of exactly 16 bytes.
         # Encrypt CBC
-        aes.start(AESContext.MODE_CBC_ENCRYPT, key.to_utf8(), iv.to_utf8())
-        encrypted = aes.update(data.to_utf8())
+        aes.start(AESContext.MODE_CBC_ENCRYPT, key.to_utf8_buffer(), iv.to_utf8_buffer())
+        encrypted = aes.update(data.to_utf8_buffer())
         aes.finish()
         # Decrypt CBC
-        aes.start(AESContext.MODE_CBC_DECRYPT, key.to_utf8(), iv.to_utf8())
+        aes.start(AESContext.MODE_CBC_DECRYPT, key.to_utf8_buffer(), iv.to_utf8_buffer())
         decrypted = aes.update(encrypted)
         aes.finish()
         # Check CBC
-        assert(decrypted == data.to_utf8())
+        assert(decrypted == data.to_utf8_buffer())
 
  .. code-tab:: csharp
 
@@ -70,27 +70,27 @@ This class provides access to AES encryption/decryption of raw data. Both AES-EC
             string key = "My secret key!!!"; // Key must be either 16 or 32 bytes.
             string data = "My secret text!!"; // Data size must be multiple of 16 bytes, apply padding if needed.
             // Encrypt ECB
-            _aes.Start(AesContext.Mode.EcbEncrypt, key.ToUtf8());
-            byte[] encrypted = _aes.Update(data.ToUtf8());
+            _aes.Start(AesContext.Mode.EcbEncrypt, key.ToUtf8Buffer());
+            byte[] encrypted = _aes.Update(data.ToUtf8Buffer());
             _aes.Finish();
             // Decrypt ECB
-            _aes.Start(AesContext.Mode.EcbDecrypt, key.ToUtf8());
+            _aes.Start(AesContext.Mode.EcbDecrypt, key.ToUtf8Buffer());
             byte[] decrypted = _aes.Update(encrypted);
             _aes.Finish();
             // Check ECB
-            Debug.Assert(decrypted == data.ToUtf8());
+            Debug.Assert(decrypted == data.ToUtf8Buffer());
     
             string iv = "My secret iv!!!!"; // IV must be of exactly 16 bytes.
             // Encrypt CBC
-            _aes.Start(AesContext.Mode.EcbEncrypt, key.ToUtf8(), iv.ToUtf8());
-            encrypted = _aes.Update(data.ToUtf8());
+            _aes.Start(AesContext.Mode.EcbEncrypt, key.ToUtf8Buffer(), iv.ToUtf8Buffer());
+            encrypted = _aes.Update(data.ToUtf8Buffer());
             _aes.Finish();
             // Decrypt CBC
-            _aes.Start(AesContext.Mode.EcbDecrypt, key.ToUtf8(), iv.ToUtf8());
+            _aes.Start(AesContext.Mode.EcbDecrypt, key.ToUtf8Buffer(), iv.ToUtf8Buffer());
             decrypted = _aes.Update(encrypted);
             _aes.Finish();
             // Check CBC
-            Debug.Assert(decrypted == data.ToUtf8());
+            Debug.Assert(decrypted == data.ToUtf8Buffer());
         }
     }
 

classes/class_animatablebody2d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimatableBody2D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimatableBody2D.xml.
 
 .. _class_AnimatableBody2D:
 
@@ -12,7 +12,7 @@ AnimatableBody2D
 
 **Inherits:** :ref:`StaticBody2D<class_StaticBody2D>` **<** :ref:`PhysicsBody2D<class_PhysicsBody2D>` **<** :ref:`CollisionObject2D<class_CollisionObject2D>` **<** :ref:`Node2D<class_Node2D>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
 
-Physics body for 2D physics which moves only by script or animation. Useful for moving platforms and doors.
+Physics body for 2D physics which moves only by script or animation (while affecting other bodies on its path). Useful for moving platforms and doors.
 
 .. rst-class:: classref-introduction-group
 

classes/class_animatablebody3d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimatableBody3D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimatableBody3D.xml.
 
 .. _class_AnimatableBody3D:
 
@@ -12,7 +12,7 @@ AnimatableBody3D
 
 **Inherits:** :ref:`StaticBody3D<class_StaticBody3D>` **<** :ref:`PhysicsBody3D<class_PhysicsBody3D>` **<** :ref:`CollisionObject3D<class_CollisionObject3D>` **<** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
 
-Physics body for 3D physics which moves only by script or animation. Useful for moving platforms and doors.
+Physics body for 3D physics which moves only by script or animation (while affecting other bodies on its path). Useful for moving platforms and doors.
 
 .. rst-class:: classref-introduction-group
 

classes/class_animatedsprite2d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimatedSprite2D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimatedSprite2D.xml.
 
 .. _class_AnimatedSprite2D:
 

classes/class_animatedsprite3d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimatedSprite3D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimatedSprite3D.xml.
 
 .. _class_AnimatedSprite3D:
 

classes/class_animatedtexture.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimatedTexture.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimatedTexture.xml.
 
 .. _class_AnimatedTexture:
 

classes/class_animation.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/Animation.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/Animation.xml.
 
 .. _class_Animation:
 

classes/class_animationlibrary.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationLibrary.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationLibrary.xml.
 
 .. _class_AnimationLibrary:
 

classes/class_animationnode.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNode.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNode.xml.
 
 .. _class_AnimationNode:
 

classes/class_animationnodeadd2.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeAdd2.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeAdd2.xml.
 
 .. _class_AnimationNodeAdd2:
 

classes/class_animationnodeadd3.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeAdd3.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeAdd3.xml.
 
 .. _class_AnimationNodeAdd3:
 

classes/class_animationnodeanimation.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeAnimation.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeAnimation.xml.
 
 .. _class_AnimationNodeAnimation:
 

classes/class_animationnodeblend2.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeBlend2.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeBlend2.xml.
 
 .. _class_AnimationNodeBlend2:
 

classes/class_animationnodeblend3.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeBlend3.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeBlend3.xml.
 
 .. _class_AnimationNodeBlend3:
 

classes/class_animationnodeblendspace1d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeBlendSpace1D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeBlendSpace1D.xml.
 
 .. _class_AnimationNodeBlendSpace1D:
 

classes/class_animationnodeblendspace2d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeBlendSpace2D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeBlendSpace2D.xml.
 
 .. _class_AnimationNodeBlendSpace2D:
 

classes/class_animationnodeblendtree.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeBlendTree.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeBlendTree.xml.
 
 .. _class_AnimationNodeBlendTree:
 

classes/class_animationnodeoneshot.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeOneShot.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeOneShot.xml.
 
 .. _class_AnimationNodeOneShot:
 

classes/class_animationnodeoutput.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeOutput.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeOutput.xml.
 
 .. _class_AnimationNodeOutput:
 

classes/class_animationnodestatemachine.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeStateMachine.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeStateMachine.xml.
 
 .. _class_AnimationNodeStateMachine:
 

classes/class_animationnodestatemachineplayback.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeStateMachinePlayback.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeStateMachinePlayback.xml.
 
 .. _class_AnimationNodeStateMachinePlayback:
 

classes/class_animationnodestatemachinetransition.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeStateMachineTransition.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeStateMachineTransition.xml.
 
 .. _class_AnimationNodeStateMachineTransition:
 

classes/class_animationnodesync.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeSync.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeSync.xml.
 
 .. _class_AnimationNodeSync:
 

classes/class_animationnodetimescale.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeTimeScale.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeTimeScale.xml.
 
 .. _class_AnimationNodeTimeScale:
 

classes/class_animationnodetimeseek.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeTimeSeek.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeTimeSeek.xml.
 
 .. _class_AnimationNodeTimeSeek:
 

classes/class_animationnodetransition.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationNodeTransition.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationNodeTransition.xml.
 
 .. _class_AnimationNodeTransition:
 

classes/class_animationplayer.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationPlayer.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationPlayer.xml.
 
 .. _class_AnimationPlayer:
 
@@ -308,7 +308,7 @@ Property Descriptions
 - void **set_assigned_animation** **(** :ref:`String<class_String>` value **)**
 - :ref:`String<class_String>` **get_assigned_animation** **(** **)**
 
-If playing, the the current animation's key, otherwise, the animation last played. When set, this changes the animation, but will not play it unless already playing. See also :ref:`current_animation<class_AnimationPlayer_property_current_animation>`.
+If playing, the current animation's key, otherwise, the animation last played. When set, this changes the animation, but will not play it unless already playing. See also :ref:`current_animation<class_AnimationPlayer_property_current_animation>`.
 
 .. rst-class:: classref-item-separator
 

classes/class_animationrootnode.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationRootNode.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationRootNode.xml.
 
 .. _class_AnimationRootNode:
 

classes/class_animationtrackeditplugin.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationTrackEditPlugin.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationTrackEditPlugin.xml.
 
 .. _class_AnimationTrackEditPlugin:
 

classes/class_animationtree.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationTree.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AnimationTree.xml.
 
 .. _class_AnimationTree:
 

classes/class_area2d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/Area2D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/Area2D.xml.
 
 .. _class_Area2D:
 

classes/class_area3d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/Area3D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/Area3D.xml.
 
 .. _class_Area3D:
 
@@ -689,7 +689,7 @@ The magnitude of area-specific wind force.
 - void **set_wind_source_path** **(** :ref:`NodePath<class_NodePath>` value **)**
 - :ref:`NodePath<class_NodePath>` **get_wind_source_path** **(** **)**
 
-The :ref:`Node3D<class_Node3D>` which is used to specify the the direction and origin of an area-specific wind force. The direction is opposite to the z-axis of the :ref:`Node3D<class_Node3D>`'s local transform, and its origin is the origin of the :ref:`Node3D<class_Node3D>`'s local transform.
+The :ref:`Node3D<class_Node3D>` which is used to specify the direction and origin of an area-specific wind force. The direction is opposite to the z-axis of the :ref:`Node3D<class_Node3D>`'s local transform, and its origin is the origin of the :ref:`Node3D<class_Node3D>`'s local transform.
 
 .. rst-class:: classref-section-separator
 

classes/class_array.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/Array.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/Array.xml.
 
 .. _class_Array:
 
@@ -70,8 +70,6 @@ Arrays can be concatenated using the ``+`` operator:
 
 \ **Note:** Erasing elements while iterating over arrays is **not** supported and will result in unpredictable behavior.
 
-\ **Note:** When declaring an array with ``const``, the array itself can still be mutated by defining the values at individual indices or pushing/removing elements. Using ``const`` will only prevent assigning the constant with another value after it was initialized.
-
 .. rst-class:: classref-reftable-group
 
 Constructors
@@ -873,6 +871,18 @@ See also :ref:`filter<class_Array_method_filter>`, :ref:`reduce<class_Array_meth
 
 Returns the maximum value contained in the array if all elements are of comparable types. If the elements can't be compared, ``null`` is returned.
 
+To find the maximum value using a custom comparator, you can use :ref:`reduce<class_Array_method_reduce>`. In this example every array element is checked and the first maximum value is returned:
+
+::
+
+    func _ready():
+        var arr = [Vector2(0, 1), Vector2(2, 0), Vector2(1, 1), Vector2(1, 0), Vector2(0, 2)]
+        # In this example we compare the lengths.
+        print(arr.reduce(func(max, val): return val if is_length_greater(val, max) else max))
+    
+    func is_length_greater(a, b):
+        return a.length() > b.length()
+
 .. rst-class:: classref-item-separator
 
 ----
@@ -885,6 +895,8 @@ Returns the maximum value contained in the array if all elements are of comparab
 
 Returns the minimum value contained in the array if all elements are of comparable types. If the elements can't be compared, ``null`` is returned.
 
+See also :ref:`max<class_Array_method_max>` for an example of using a custom comparator.
+
 .. rst-class:: classref-item-separator
 
 ----

classes/class_arraymesh.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/ArrayMesh.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/ArrayMesh.xml.
 
 .. _class_ArrayMesh:
 

classes/class_arrayoccluder3d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/ArrayOccluder3D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/ArrayOccluder3D.xml.
 
 .. _class_ArrayOccluder3D:
 

classes/class_aspectratiocontainer.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AspectRatioContainer.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AspectRatioContainer.xml.
 
 .. _class_AspectRatioContainer:
 

classes/class_astar2d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AStar2D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AStar2D.xml.
 
 .. _class_AStar2D:
 

classes/class_astar3d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AStar3D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AStar3D.xml.
 
 .. _class_AStar3D:
 

classes/class_astargrid2d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AStarGrid2D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AStarGrid2D.xml.
 
 .. _class_AStarGrid2D:
 

classes/class_atlastexture.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AtlasTexture.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AtlasTexture.xml.
 
 .. _class_AtlasTexture:
 

classes/class_audiobuslayout.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioBusLayout.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioBusLayout.xml.
 
 .. _class_AudioBusLayout:
 

classes/class_audioeffect.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffect.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffect.xml.
 
 .. _class_AudioEffect:
 

classes/class_audioeffectamplify.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectAmplify.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectAmplify.xml.
 
 .. _class_AudioEffectAmplify:
 

classes/class_audioeffectbandlimitfilter.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectBandLimitFilter.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectBandLimitFilter.xml.
 
 .. _class_AudioEffectBandLimitFilter:
 

classes/class_audioeffectbandpassfilter.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectBandPassFilter.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectBandPassFilter.xml.
 
 .. _class_AudioEffectBandPassFilter:
 

classes/class_audioeffectcapture.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectCapture.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectCapture.xml.
 
 .. _class_AudioEffectCapture:
 

classes/class_audioeffectchorus.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectChorus.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectChorus.xml.
 
 .. _class_AudioEffectChorus:
 

classes/class_audioeffectcompressor.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectCompressor.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectCompressor.xml.
 
 .. _class_AudioEffectCompressor:
 

classes/class_audioeffectdelay.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectDelay.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectDelay.xml.
 
 .. _class_AudioEffectDelay:
 

classes/class_audioeffectdistortion.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectDistortion.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectDistortion.xml.
 
 .. _class_AudioEffectDistortion:
 

classes/class_audioeffecteq.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectEQ.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectEQ.xml.
 
 .. _class_AudioEffectEQ:
 

classes/class_audioeffecteq10.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectEQ10.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectEQ10.xml.
 
 .. _class_AudioEffectEQ10:
 

classes/class_audioeffecteq21.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectEQ21.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectEQ21.xml.
 
 .. _class_AudioEffectEQ21:
 

classes/class_audioeffecteq6.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectEQ6.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectEQ6.xml.
 
 .. _class_AudioEffectEQ6:
 

classes/class_audioeffectfilter.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectFilter.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectFilter.xml.
 
 .. _class_AudioEffectFilter:
 

classes/class_audioeffecthighpassfilter.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectHighPassFilter.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectHighPassFilter.xml.
 
 .. _class_AudioEffectHighPassFilter:
 

classes/class_audioeffecthighshelffilter.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectHighShelfFilter.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectHighShelfFilter.xml.
 
 .. _class_AudioEffectHighShelfFilter:
 

classes/class_audioeffectinstance.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectInstance.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectInstance.xml.
 
 .. _class_AudioEffectInstance:
 

classes/class_audioeffectlimiter.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectLimiter.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectLimiter.xml.
 
 .. _class_AudioEffectLimiter:
 

classes/class_audioeffectlowpassfilter.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectLowPassFilter.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectLowPassFilter.xml.
 
 .. _class_AudioEffectLowPassFilter:
 

classes/class_audioeffectlowshelffilter.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectLowShelfFilter.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectLowShelfFilter.xml.
 
 .. _class_AudioEffectLowShelfFilter:
 

classes/class_audioeffectnotchfilter.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectNotchFilter.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectNotchFilter.xml.
 
 .. _class_AudioEffectNotchFilter:
 

classes/class_audioeffectpanner.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectPanner.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectPanner.xml.
 
 .. _class_AudioEffectPanner:
 

classes/class_audioeffectphaser.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectPhaser.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectPhaser.xml.
 
 .. _class_AudioEffectPhaser:
 

classes/class_audioeffectpitchshift.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectPitchShift.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectPitchShift.xml.
 
 .. _class_AudioEffectPitchShift:
 

classes/class_audioeffectrecord.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectRecord.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectRecord.xml.
 
 .. _class_AudioEffectRecord:
 

classes/class_audioeffectreverb.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectReverb.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectReverb.xml.
 
 .. _class_AudioEffectReverb:
 

classes/class_audioeffectspectrumanalyzer.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectSpectrumAnalyzer.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectSpectrumAnalyzer.xml.
 
 .. _class_AudioEffectSpectrumAnalyzer:
 

classes/class_audioeffectspectrumanalyzerinstance.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectSpectrumAnalyzerInstance.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectSpectrumAnalyzerInstance.xml.
 
 .. _class_AudioEffectSpectrumAnalyzerInstance:
 

classes/class_audioeffectstereoenhance.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioEffectStereoEnhance.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioEffectStereoEnhance.xml.
 
 .. _class_AudioEffectStereoEnhance:
 

classes/class_audiolistener2d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioListener2D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioListener2D.xml.
 
 .. _class_AudioListener2D:
 

classes/class_audiolistener3d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioListener3D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioListener3D.xml.
 
 .. _class_AudioListener3D:
 

classes/class_audioserver.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioServer.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioServer.xml.
 
 .. _class_AudioServer:
 

classes/class_audiostream.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStream.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStream.xml.
 
 .. _class_AudioStream:
 

classes/class_audiostreamgenerator.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamGenerator.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamGenerator.xml.
 
 .. _class_AudioStreamGenerator:
 
@@ -12,14 +12,38 @@ AudioStreamGenerator
 
 **Inherits:** :ref:`AudioStream<class_AudioStream>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
 
-Audio stream that generates sounds procedurally.
+An audio stream with utilities for procedural sound generation.
 
 .. rst-class:: classref-introduction-group
 
 Description
 -----------
 
-This audio stream does not play back sounds, but expects a script to generate audio data for it instead. See also :ref:`AudioStreamGeneratorPlayback<class_AudioStreamGeneratorPlayback>`.
+**AudioStreamGenerator** is a type of audio stream that does not play back sounds on its own; instead, it expects a script to generate audio data for it. See also :ref:`AudioStreamGeneratorPlayback<class_AudioStreamGeneratorPlayback>`.
+
+Here's a sample on how to use it to generate a sine wave:
+
+::
+
+    var playback # Will hold the AudioStreamGeneratorPlayback.
+    @onready var sample_hz = $AudioStreamPlayer.stream.mix_rate
+    var pulse_hz = 440.0 # The frequency of the sound wave.
+    
+    func _ready():
+        $AudioStreamPlayer.play()
+        playback = $AudioStreamPlayer.get_stream_playback()
+        fill_buffer()
+    
+    func fill_buffer():
+        var phase = 0.0
+        var increment = pulse_hz / sample_hz
+        var frames_available = playback.get_frames_available()
+    
+        for i in range(frames_available):
+            playback.push_frame(Vector2.ONE * sin(phase * TAU))
+            phase = fmod(phase + increment, 1.0)
+
+In the example above, the "AudioStreamPlayer" node must use an **AudioStreamGenerator** as its stream. The ``fill_buffer`` function provides audio data for approximating a sine wave.
 
 See also :ref:`AudioEffectSpectrumAnalyzer<class_AudioEffectSpectrumAnalyzer>` for performing real-time audio spectrum analysis.
 
@@ -32,8 +56,6 @@ Tutorials
 
 - `Audio Generator Demo <https://godotengine.org/asset-library/asset/526>`__
 
-- `Godot 3.2 will get new audio features <https://godotengine.org/article/godot-32-will-get-new-audio-features>`__
-
 .. rst-class:: classref-reftable-group
 
 Properties

classes/class_audiostreamgeneratorplayback.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamGeneratorPlayback.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamGeneratorPlayback.xml.
 
 .. _class_AudioStreamGeneratorPlayback:
 

classes/class_audiostreammicrophone.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamMicrophone.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamMicrophone.xml.
 
 .. _class_AudioStreamMicrophone:
 

classes/class_audiostreammp3.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/modules/minimp3/doc_classes/AudioStreamMP3.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/modules/minimp3/doc_classes/AudioStreamMP3.xml.
 
 .. _class_AudioStreamMP3:
 

classes/class_audiostreamoggvorbis.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/modules/vorbis/doc_classes/AudioStreamOggVorbis.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/modules/vorbis/doc_classes/AudioStreamOggVorbis.xml.
 
 .. _class_AudioStreamOggVorbis:
 

classes/class_audiostreamplayback.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamPlayback.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamPlayback.xml.
 
 .. _class_AudioStreamPlayback:
 

classes/class_audiostreamplaybackoggvorbis.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/modules/vorbis/doc_classes/AudioStreamPlaybackOggVorbis.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/modules/vorbis/doc_classes/AudioStreamPlaybackOggVorbis.xml.
 
 .. _class_AudioStreamPlaybackOggVorbis:
 

classes/class_audiostreamplaybackpolyphonic.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamPlaybackPolyphonic.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamPlaybackPolyphonic.xml.
 
 .. _class_AudioStreamPlaybackPolyphonic:
 

classes/class_audiostreamplaybackresampled.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamPlaybackResampled.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamPlaybackResampled.xml.
 
 .. _class_AudioStreamPlaybackResampled:
 

classes/class_audiostreamplayer.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamPlayer.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamPlayer.xml.
 
 .. _class_AudioStreamPlayer:
 

classes/class_audiostreamplayer2d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamPlayer2D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamPlayer2D.xml.
 
 .. _class_AudioStreamPlayer2D:
 

classes/class_audiostreamplayer3d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamPlayer3D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamPlayer3D.xml.
 
 .. _class_AudioStreamPlayer3D:
 

classes/class_audiostreampolyphonic.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamPolyphonic.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamPolyphonic.xml.
 
 .. _class_AudioStreamPolyphonic:
 

classes/class_audiostreamrandomizer.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamRandomizer.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamRandomizer.xml.
 
 .. _class_AudioStreamRandomizer:
 

classes/class_audiostreamwav.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AudioStreamWAV.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/AudioStreamWAV.xml.
 
 .. _class_AudioStreamWAV:
 

classes/class_backbuffercopy.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/BackBufferCopy.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/BackBufferCopy.xml.
 
 .. _class_BackBufferCopy:
 

classes/class_basebutton.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/BaseButton.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/BaseButton.xml.
 
 .. _class_BaseButton:
 

classes/class_basematerial3d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/BaseMaterial3D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/BaseMaterial3D.xml.
 
 .. _class_BaseMaterial3D:
 
@@ -2945,7 +2945,7 @@ The method for rendering the specular blob. See :ref:`SpecularMode<enum_BaseMate
 - void **set_feature** **(** :ref:`Feature<enum_BaseMaterial3D_Feature>` feature, :ref:`bool<class_bool>` enable **)**
 - :ref:`bool<class_bool>` **get_feature** **(** :ref:`Feature<enum_BaseMaterial3D_Feature>` feature **)** |const|
 
-If ``true``, subsurface scattering is enabled. Emulates light that penetrates an object's surface, is scattered, and then emerges.
+If ``true``, subsurface scattering is enabled. Emulates light that penetrates an object's surface, is scattered, and then emerges. Subsurface scattering quality is controlled by :ref:`ProjectSettings.rendering/environment/subsurface_scattering/subsurface_scattering_quality<class_ProjectSettings_property_rendering/environment/subsurface_scattering/subsurface_scattering_quality>`.
 
 .. rst-class:: classref-item-separator
 
@@ -2979,7 +2979,7 @@ If ``true``, subsurface scattering will use a special mode optimized for the col
 - void **set_subsurface_scattering_strength** **(** :ref:`float<class_float>` value **)**
 - :ref:`float<class_float>` **get_subsurface_scattering_strength** **(** **)**
 
-The strength of the subsurface scattering effect.
+The strength of the subsurface scattering effect. The depth of the effect is also controlled by :ref:`ProjectSettings.rendering/environment/subsurface_scattering/subsurface_scattering_scale<class_ProjectSettings_property_rendering/environment/subsurface_scattering/subsurface_scattering_scale>`, which is set globally.
 
 .. rst-class:: classref-item-separator
 
@@ -3134,7 +3134,7 @@ Repeat flags for the texture. See :ref:`TextureFilter<enum_BaseMaterial3D_Textur
 - void **set_transparency** **(** :ref:`Transparency<enum_BaseMaterial3D_Transparency>` value **)**
 - :ref:`Transparency<enum_BaseMaterial3D_Transparency>` **get_transparency** **(** **)**
 
-If ``true``, transparency is enabled on the body. Some transparency modes will disable shadow casting. Any transparency mode other than Disabled has a greater performance impact compared to opaque rendering. See also :ref:`blend_mode<class_BaseMaterial3D_property_blend_mode>`.
+The material's transparency mode. Some transparency modes will disable shadow casting. Any transparency mode other than :ref:`TRANSPARENCY_DISABLED<class_BaseMaterial3D_constant_TRANSPARENCY_DISABLED>` has a greater performance impact compared to opaque rendering. See also :ref:`blend_mode<class_BaseMaterial3D_property_blend_mode>`.
 
 .. rst-class:: classref-item-separator
 

classes/class_basis.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/Basis.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/Basis.xml.
 
 .. _class_Basis:
 

classes/class_bitmap.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/BitMap.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/BitMap.xml.
 
 .. _class_BitMap:
 

classes/class_bone2d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/Bone2D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/Bone2D.xml.
 
 .. _class_Bone2D:
 

classes/class_boneattachment3d.rst

@@ -2,8 +2,8 @@
 
 .. DO NOT EDIT THIS FILE!!!
 .. Generated automatically from Godot engine sources.
-.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
-.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/BoneAttachment3D.xml.
+.. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
+.. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/BoneAttachment3D.xml.
 
 .. _class_BoneAttachment3D: