diff --git a/doc/classes/Array.xml b/doc/classes/Array.xml
index 0d2381b18aa..61c9fc2d816 100644
--- a/doc/classes/Array.xml
+++ b/doc/classes/Array.xml
@@ -443,7 +443,7 @@
- Returns the element at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]null[/code].
+ Returns the element at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]null[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/BaseMaterial3D.xml b/doc/classes/BaseMaterial3D.xml
index 068e9c92d6c..9893e5c1a81 100644
--- a/doc/classes/BaseMaterial3D.xml
+++ b/doc/classes/BaseMaterial3D.xml
@@ -14,21 +14,21 @@
- Returns [code]true[/code], if the specified [enum Feature] is enabled.
+ Returns [code]true[/code] if the specified [param feature] is enabled.
- Returns [code]true[/code] if the specified flag is enabled.
+ Returns [code]true[/code] if the specified [param flag] is enabled.
- Returns the [Texture2D] associated with the specified [enum TextureParam].
+ Returns the [Texture2D] associated with the specified texture [param param].
@@ -36,7 +36,7 @@
- If [code]true[/code], enables the specified [enum Feature]. Many features that are available in [BaseMaterial3D]s need to be enabled before use. This way the cost for using the feature is only incurred when specified. Features can also be enabled by setting the corresponding member to [code]true[/code].
+ If [param enable] is [code]true[/code], enables the specified [param feature]. Many features that are available in [BaseMaterial3D] need to be enabled before use. This way, the cost for using the feature is only incurred when specified. Features can also be enabled by setting their corresponding property to [code]true[/code].
@@ -44,7 +44,7 @@
- If [code]true[/code], enables the specified flag. Flags are optional behavior that can be turned on and off. Only one flag can be enabled at a time with this function, the flag enumerators cannot be bit-masked together to enable or disable multiple flags at once. Flags can also be enabled by setting the corresponding member to [code]true[/code].
+ If [param enable] is [code]true[/code], enables the specified [param flag]. Flags are optional behavior that can be turned on and off. Only one flag can be enabled at a time with this function, the flag enumerators cannot be bit-masked together to enable or disable multiple flags at once. Flags can also be enabled by setting their corresponding property to [code]true[/code].
diff --git a/doc/classes/Button.xml b/doc/classes/Button.xml
index 501be64881b..7fe236720c4 100644
--- a/doc/classes/Button.xml
+++ b/doc/classes/Button.xml
@@ -66,7 +66,7 @@
Specifies if the icon should be aligned horizontally to the left, right, or center of a button. Uses the same [enum HorizontalAlignment] constants as the text alignment. If centered horizontally and vertically, text will draw on top of the icon.
- Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
The button's text that will be displayed inside the button's area.
diff --git a/doc/classes/Color.xml b/doc/classes/Color.xml
index 9dcede2890a..6884d42e066 100644
--- a/doc/classes/Color.xml
+++ b/doc/classes/Color.xml
@@ -366,14 +366,14 @@
Returns a copy of the color that is encoded using the [url=https://en.wikipedia.org/wiki/SRGB]nonlinear sRGB transfer function[/url]. This method requires the original color to use linear encoding. See also [method srgb_to_linear] which performs the opposite operation.
- [b]Note:[/b] The color's [member a]lpha channel is not affected. The alpha channel is always stored with linear encoding, regardless of the encoding of the other color channels.
+ [b]Note:[/b] The color's alpha channel ([member a]) is not affected. The alpha channel is always stored with linear encoding, regardless of the color space of the other color channels.
Returns a copy of the color that uses linear encoding. This method requires the original color to be encoded using the [url=https://en.wikipedia.org/wiki/SRGB]nonlinear sRGB transfer function[/url]. See also [method linear_to_srgb] which performs the opposite operation.
- [b]Note:[/b] The color's [member a]lpha channel is not affected. The alpha channel is always stored with linear encoding, regardless of the encoding of the other color channels.
+ [b]Note:[/b] The color's alpha channel ([member a]) is not affected. The alpha channel is always stored with linear encoding, regardless of the color space of the other color channels.
diff --git a/doc/classes/Control.xml b/doc/classes/Control.xml
index 8b0166508ed..da2f62a9772 100644
--- a/doc/classes/Control.xml
+++ b/doc/classes/Control.xml
@@ -12,7 +12,7 @@
Input events are propagated through the [SceneTree] from the root node to all child nodes by calling [method Node._input]. For UI elements specifically, it makes more sense to override the virtual method [method _gui_input], which filters out unrelated input events, such as by checking z-order, [member mouse_filter], focus, or if the event was inside of the control's bounding box.
Call [method accept_event] so no other node receives the event. Once you accept an input, it becomes handled so [method Node._unhandled_input] will not process it.
Only one [Control] node can be in focus. Only the node in focus will receive events. To get the focus, call [method grab_focus]. [Control] nodes lose focus when another node grabs it, or if you hide the node in focus. Focus will not be represented visually if gained via mouse/touch input, only appearing with keyboard/gamepad input (for accessibility), or via [method grab_focus].
- Sets [member mouse_filter] to [constant MOUSE_FILTER_IGNORE] to tell a [Control] node to ignore mouse or touch events. You'll need it if you place an icon on top of a button.
+ Set [member mouse_filter] to [constant MOUSE_FILTER_IGNORE] to tell a [Control] node to ignore mouse or touch events. You'll need it if you place an icon on top of a button.
[Theme] resources change the control's appearance. The [member theme] of a [Control] node affects all of its direct and indirect children (as long as a chain of controls is uninterrupted). To override some of the theme items, call one of the [code]add_theme_*_override[/code] methods, like [method add_theme_font_override]. You can also override theme items in the Inspector.
[b]Note:[/b] Theme items are [i]not[/i] [Object] properties. This means you can't access their values using [method Object.get] and [method Object.set]. Instead, use the [code]get_theme_*[/code] and [code]add_theme_*_override[/code] methods provided by this class.
diff --git a/doc/classes/DPITexture.xml b/doc/classes/DPITexture.xml
index c7c803c164a..dbbc75424a2 100644
--- a/doc/classes/DPITexture.xml
+++ b/doc/classes/DPITexture.xml
@@ -16,7 +16,7 @@
- Creates a new [DPITexture] and initializes it by allocating and setting the SVG data from string.
+ Creates a new [DPITexture] and initializes it by allocating and setting the SVG data to [param source].
@@ -28,7 +28,7 @@
- Returns SVG source code.
+ Returns this SVG texture's source code.
@@ -42,7 +42,7 @@
- Sets SVG source code.
+ Sets this SVG texture's source code.
diff --git a/doc/classes/DisplayServer.xml b/doc/classes/DisplayServer.xml
index a7cc0669816..cbcef2fc92b 100644
--- a/doc/classes/DisplayServer.xml
+++ b/doc/classes/DisplayServer.xml
@@ -42,7 +42,7 @@
- Returns the metadata of the accessibility element.
+ Returns the metadata of the accessibility element [param id].
@@ -50,14 +50,14 @@
- Sets the metadata of the accessibility element.
+ Sets the metadata of the accessibility element [param id] to [param meta].
- Frees an object created by [method accessibility_create_element], [method accessibility_create_sub_element], or [method accessibility_create_sub_text_edit_elements].
+ Frees the accessibility element [param id] created by [method accessibility_create_element], [method accessibility_create_sub_element], or [method accessibility_create_sub_text_edit_elements].
@@ -870,7 +870,7 @@
- Returns index of the primary screen.
+ Returns the index of the primary screen.
[b]Note:[/b] This method is implemented on Linux/X11, macOS, and Windows. On other platforms, this method always returns [code]0[/code].
@@ -1752,9 +1752,9 @@
- Returns color of the display pixel at the [param position].
- [b]Note:[/b] This method is implemented on Linux (X11, excluding XWayland), macOS, and Windows. On other platforms, this method always returns [Color].
- [b]Note:[/b] On macOS, this method requires the "Screen Recording" permission. If permission is not granted, this method returns a screenshot that will only contain the desktop wallpaper, the current application's window, and other related UI elements.
+ Returns the color of the pixel at the given screen [param position]. On multi-monitor setups, the screen position is relative to the virtual desktop area.
+ [b]Note:[/b] This method is implemented on Linux (X11, excluding XWayland), macOS, and Windows. On other platforms, this method always returns [code]Color(0, 0, 0, 1)[/code].
+ [b]Note:[/b] On macOS, this method requires the "Screen Recording" permission. If permission is not granted, this method returns a color from a screenshot that will not include other application windows or OS elements not related to the application.
diff --git a/doc/classes/EditorExportPlatform.xml b/doc/classes/EditorExportPlatform.xml
index cb4633e0a45..4fd051cd86d 100644
--- a/doc/classes/EditorExportPlatform.xml
+++ b/doc/classes/EditorExportPlatform.xml
@@ -138,27 +138,27 @@
- Returns message category, for the message with [param index].
+ Returns the message category for the message with the given [param index].
- Returns number of messages in the export log.
+ Returns the number of messages in the export log.
- Returns message text, for the message with [param index].
+ Returns the text for the message with the given [param index].
- Returns message type, for the message with [param index].
+ Returns the type for the message with the given [param index].
diff --git a/doc/classes/EditorSettings.xml b/doc/classes/EditorSettings.xml
index faadd91b69a..107d604075e 100644
--- a/doc/classes/EditorSettings.xml
+++ b/doc/classes/EditorSettings.xml
@@ -1258,7 +1258,7 @@
All update modes will ignore builds with different major versions (e.g. Godot 4 -> Godot 5).
- Determines whether online features are enabled in the editor, such as the Asset Library or update checks. Disabling these online features helps alleviate privacy concerns by preventing the editor from making HTTP requests to the Godot website or third-party platforms hosting assets from the Asset Library.
+ Determines whether online features, such as the Asset Library or update checks, are enabled in the editor. If this is a privacy concern, disabling these online features prevents the editor from making HTTP requests to the Godot website or third-party platforms hosting assets from the Asset Library.
Editor plugins and tool scripts are recommended to follow this setting. However, Godot can't prevent them from violating this rule.
diff --git a/doc/classes/EditorToaster.xml b/doc/classes/EditorToaster.xml
index c30b94c9897..402e18d3107 100644
--- a/doc/classes/EditorToaster.xml
+++ b/doc/classes/EditorToaster.xml
@@ -4,7 +4,7 @@
Manages toast notifications within the editor.
- This object manages the functionality and display of toast notifications within the editor, ensuring timely and informative alerts are presented to users.
+ This object manages the functionality and display of toast notifications within the editor, ensuring immediate and informative alerts are presented to the user.
[b]Note:[/b] This class shouldn't be instantiated directly. Instead, access the singleton using [method EditorInterface.get_editor_toaster].
diff --git a/doc/classes/FileAccess.xml b/doc/classes/FileAccess.xml
index 8d0b80bfb5e..b5b24a1368b 100644
--- a/doc/classes/FileAccess.xml
+++ b/doc/classes/FileAccess.xml
@@ -326,14 +326,14 @@
- Returns file size in bytes, or [code]-1[/code] on error.
+ Returns the size of the file at the given path, in bytes, or [code]-1[/code] on error.
- Returns file UNIX permissions.
+ Returns the UNIX permissions of the file at the given path.
[b]Note:[/b] This method is implemented on iOS, Linux/BSD, and macOS.
diff --git a/doc/classes/FileDialog.xml b/doc/classes/FileDialog.xml
index cc18eb6b8d3..ec6298ba4a0 100644
--- a/doc/classes/FileDialog.xml
+++ b/doc/classes/FileDialog.xml
@@ -107,7 +107,7 @@
- Invalidate and update the current dialog content list.
+ Invalidates and updates this dialog's content list.
[b]Note:[/b] This method does nothing on native file dialogs.
diff --git a/doc/classes/FoldableContainer.xml b/doc/classes/FoldableContainer.xml
index ae200d8c5a9..326172977fa 100644
--- a/doc/classes/FoldableContainer.xml
+++ b/doc/classes/FoldableContainer.xml
@@ -50,7 +50,7 @@
If [code]true[/code], the container will becomes folded and will hide all its children.
- Language code used for text shaping algorithms. If left empty, current locale is used instead.
+ Language code used for text shaping algorithms. If left empty, the current locale is used instead.
diff --git a/doc/classes/GeometryInstance3D.xml b/doc/classes/GeometryInstance3D.xml
index ce2deed0c18..d55a8c6cf4d 100644
--- a/doc/classes/GeometryInstance3D.xml
+++ b/doc/classes/GeometryInstance3D.xml
@@ -31,7 +31,7 @@
- The selected shadow casting flag.
+ The mode used to cast shadows from this instance.
Overrides the bounding box of this node with a custom one. This can be used to avoid the expensive [AABB] recalculation that happens when a skeleton is used with a [MeshInstance3D] or to have precise control over the [MeshInstance3D]'s bounding box. To use the default AABB, set value to an [AABB] with all fields set to [code]0.0[/code]. To avoid frustum culling, set [member custom_aabb] to a very large AABB that covers your entire game world such as [code]AABB(-10000, -10000, -10000, 20000, 20000, 20000)[/code]. To disable all forms of culling (including occlusion culling), call [method RenderingServer.instance_set_ignore_culling] on the [GeometryInstance3D]'s [RID].
diff --git a/doc/classes/GraphEdit.xml b/doc/classes/GraphEdit.xml
index 9ec0bb5dc94..db1c3b6a285 100644
--- a/doc/classes/GraphEdit.xml
+++ b/doc/classes/GraphEdit.xml
@@ -411,7 +411,7 @@
If [code]true[/code], enables snapping.
- [Dictionary] of human readable port type names.
+ [Dictionary] of human-readable port type names.
The current zoom value.
diff --git a/doc/classes/Image.xml b/doc/classes/Image.xml
index 602fdc6748d..23ee287f360 100644
--- a/doc/classes/Image.xml
+++ b/doc/classes/Image.xml
@@ -129,7 +129,7 @@
- Creates an empty image of the given size and format. If [param use_mipmaps] is [code]true[/code], generates mipmaps for this image. See the [method generate_mipmaps].
+ Creates an empty image of the given size and format. If [param use_mipmaps] is [code]true[/code], generates mipmaps for this image (see [method generate_mipmaps]).
@@ -139,7 +139,7 @@
- Creates an empty image of the given size and format. If [param use_mipmaps] is [code]true[/code], generates mipmaps for this image. See the [method generate_mipmaps].
+ Creates an empty image of the given size and format. If [param use_mipmaps] is [code]true[/code], generates mipmaps for this image (see [method generate_mipmaps]).
diff --git a/doc/classes/ItemList.xml b/doc/classes/ItemList.xml
index 27e7b39d0b5..b6b3f8f324b 100644
--- a/doc/classes/ItemList.xml
+++ b/doc/classes/ItemList.xml
@@ -315,7 +315,7 @@
- Sets language code of item's text used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Sets the language code of the text for the item at the given index to [param language]. This is used for line-breaking and text shaping algorithms. If [param language] is empty, the current locale is used.
diff --git a/doc/classes/Label.xml b/doc/classes/Label.xml
index e0bae5cfeb7..bf9c17fcbaa 100644
--- a/doc/classes/Label.xml
+++ b/doc/classes/Label.xml
@@ -68,7 +68,7 @@
A [LabelSettings] resource that can be shared between multiple [Label] nodes. Takes priority over theme properties.
- Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
The number of the lines ignored and not displayed from the start of the [member text] value.
diff --git a/doc/classes/Label3D.xml b/doc/classes/Label3D.xml
index 958566158c9..d30f1fdea51 100644
--- a/doc/classes/Label3D.xml
+++ b/doc/classes/Label3D.xml
@@ -79,7 +79,7 @@
Line fill alignment rules.
- Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
Additional vertical spacing between lines (in pixels), spacing is added to line descent. This value can be negative.
diff --git a/doc/classes/LineEdit.xml b/doc/classes/LineEdit.xml
index 831660fe1f0..40cb3d9f900 100644
--- a/doc/classes/LineEdit.xml
+++ b/doc/classes/LineEdit.xml
@@ -317,7 +317,7 @@
If [code]true[/code], the [LineEdit] will not exit edit mode when text is submitted by pressing [code]ui_text_submit[/code] action (by default: [kbd]Enter[/kbd] or [kbd]Kp Enter[/kbd]).
- Language code used for line-breaking and text shaping algorithms. If left empty, current locale is used instead.
+ Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
Maximum number of characters that can be entered inside the [LineEdit]. If [code]0[/code], there is no limit.
diff --git a/doc/classes/LinkButton.xml b/doc/classes/LinkButton.xml
index 1adabafcaf0..28b13a7d9ba 100644
--- a/doc/classes/LinkButton.xml
+++ b/doc/classes/LinkButton.xml
@@ -15,7 +15,7 @@
- Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
diff --git a/doc/classes/MenuBar.xml b/doc/classes/MenuBar.xml
index d7698f87527..d504a5a26b5 100644
--- a/doc/classes/MenuBar.xml
+++ b/doc/classes/MenuBar.xml
@@ -102,7 +102,7 @@
- Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
If [code]true[/code], [MenuBar] will use system global menu when supported.
diff --git a/doc/classes/Node.xml b/doc/classes/Node.xml
index 17fb8172b46..89457ae36e4 100644
--- a/doc/classes/Node.xml
+++ b/doc/classes/Node.xml
@@ -764,7 +764,7 @@
Prints all orphan nodes (nodes outside the [SceneTree]). Useful for debugging.
- [b]Note:[/b] This method only works in debug builds. Does nothing in a project exported in release mode.
+ [b]Note:[/b] This method only works in debug builds. It does nothing in a project exported in release mode.
diff --git a/doc/classes/Object.xml b/doc/classes/Object.xml
index 42c9cca8d4e..c308aa9d1c3 100644
--- a/doc/classes/Object.xml
+++ b/doc/classes/Object.xml
@@ -530,7 +530,7 @@
A signal can only be connected once to the same [Callable]. If the signal is already connected, this method returns [constant ERR_INVALID_PARAMETER] and generates an error, unless the signal is connected with [constant CONNECT_REFERENCE_COUNTED]. To prevent this, use [method is_connected] first to check for existing connections.
[b]Note:[/b] If the [param callable]'s object is freed, the connection will be lost.
[b]Note:[/b] In GDScript, it is generally recommended to connect signals with [method Signal.connect] instead.
- [b]Note:[/b] This operation (and all other signal related operations) is thread-safe.
+ [b]Note:[/b] This method, and all other signal-related methods, are thread-safe.
diff --git a/doc/classes/PackedByteArray.xml b/doc/classes/PackedByteArray.xml
index 3b77d82c6f7..f373e982f15 100644
--- a/doc/classes/PackedByteArray.xml
+++ b/doc/classes/PackedByteArray.xml
@@ -342,7 +342,7 @@
- Returns the byte at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]0[/code].
+ Returns the byte at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]0[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PackedColorArray.xml b/doc/classes/PackedColorArray.xml
index c47cdedbc25..19a620aba04 100644
--- a/doc/classes/PackedColorArray.xml
+++ b/doc/classes/PackedColorArray.xml
@@ -105,7 +105,7 @@
- Returns the [Color] at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]Color(0, 0, 0, 1)[/code].
+ Returns the [Color] at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]Color(0, 0, 0, 1)[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PackedFloat32Array.xml b/doc/classes/PackedFloat32Array.xml
index 1bd4f560c00..4b0b330d600 100644
--- a/doc/classes/PackedFloat32Array.xml
+++ b/doc/classes/PackedFloat32Array.xml
@@ -105,7 +105,7 @@
- Returns the 32-bit float at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]0.0[/code].
+ Returns the 32-bit float at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]0.0[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PackedFloat64Array.xml b/doc/classes/PackedFloat64Array.xml
index 8bb5c7e5efc..e92502a6954 100644
--- a/doc/classes/PackedFloat64Array.xml
+++ b/doc/classes/PackedFloat64Array.xml
@@ -106,7 +106,7 @@
- Returns the 64-bit float at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]0.0[/code].
+ Returns the 64-bit float at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]0.0[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PackedInt32Array.xml b/doc/classes/PackedInt32Array.xml
index fadeab70350..73c6f3e7fd8 100644
--- a/doc/classes/PackedInt32Array.xml
+++ b/doc/classes/PackedInt32Array.xml
@@ -101,7 +101,7 @@
- Returns the 32-bit integer at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]0[/code].
+ Returns the 32-bit integer at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]0[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PackedInt64Array.xml b/doc/classes/PackedInt64Array.xml
index e512060375a..f3a725f59e3 100644
--- a/doc/classes/PackedInt64Array.xml
+++ b/doc/classes/PackedInt64Array.xml
@@ -102,7 +102,7 @@
- Returns the 64-bit integer at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]0[/code].
+ Returns the 64-bit integer at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]0[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PackedStringArray.xml b/doc/classes/PackedStringArray.xml
index d6a3052dbe0..62828d8e979 100644
--- a/doc/classes/PackedStringArray.xml
+++ b/doc/classes/PackedStringArray.xml
@@ -108,8 +108,8 @@
- Returns the [String] at the given [param index] in the array. Returns an empty string and prints an error if the access is out of bounds. Negative indices are not supported; they will always consider the value to be out of bounds and return an empty string.
- This is similar to using the [code][][/code] operator ([code]array[index][/code]), except that operator supports negative indices and causes a debugger break if out-of-bounds access is performed.
+ Returns the [String] at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns an empty string.
+ This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PackedVector2Array.xml b/doc/classes/PackedVector2Array.xml
index aca043cac7d..6afa7e8b8a1 100644
--- a/doc/classes/PackedVector2Array.xml
+++ b/doc/classes/PackedVector2Array.xml
@@ -110,7 +110,7 @@
- Returns the [Vector2] at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]Vector2(0, 0)[/code].
+ Returns the [Vector2] at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]Vector2(0, 0)[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PackedVector3Array.xml b/doc/classes/PackedVector3Array.xml
index 13c321d92ce..e3c8c24d45b 100644
--- a/doc/classes/PackedVector3Array.xml
+++ b/doc/classes/PackedVector3Array.xml
@@ -109,7 +109,7 @@
- Returns the [Vector3] at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]Vector3(0, 0, 0)[/code].
+ Returns the [Vector3] at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]Vector3(0, 0, 0)[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PackedVector4Array.xml b/doc/classes/PackedVector4Array.xml
index 97cc98a9d10..995ab553b39 100644
--- a/doc/classes/PackedVector4Array.xml
+++ b/doc/classes/PackedVector4Array.xml
@@ -109,7 +109,7 @@
- Returns the [Vector4] at the given [param index] in the array. If [param index] out-of-bounds or negative, this method fails and returns [code]Vector4(0, 0, 0, 0)[/code].
+ Returns the [Vector4] at the given [param index] in the array. If [param index] is out-of-bounds or negative, this method fails and returns [code]Vector4(0, 0, 0, 0)[/code].
This method is similar (but not identical) to the [code][][/code] operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
diff --git a/doc/classes/PopupMenu.xml b/doc/classes/PopupMenu.xml
index d0a1ba88279..b8ae0254dab 100644
--- a/doc/classes/PopupMenu.xml
+++ b/doc/classes/PopupMenu.xml
@@ -541,7 +541,7 @@
- Sets language code of item's text used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Sets the language code of the text for the item at the given index to [param language]. This is used for line-breaking and text shaping algorithms. If [param language] is empty, the current locale is used.
diff --git a/doc/classes/PortableCompressedTexture2D.xml b/doc/classes/PortableCompressedTexture2D.xml
index 1660a163eb0..9010a1f69d2 100644
--- a/doc/classes/PortableCompressedTexture2D.xml
+++ b/doc/classes/PortableCompressedTexture2D.xml
@@ -49,7 +49,7 @@
Sets the compressor parameters for Basis Universal compression. See also the settings in [ResourceImporterTexture].
- [b]Note:[/b] This must be set before [method create_from_image] to take effect.
+ [b]Note:[/b] This method must be called before [method create_from_image] for this to work.
@@ -62,13 +62,12 @@
- When running on the editor, this class will keep the source compressed data in memory. Otherwise, the source compressed data is lost after loading and the resource can't be re saved.
- This flag allows to keep the compressed data in memory if you intend it to persist after loading.
- [b]Note:[/b] This must be set before [method create_from_image] to take effect.
+ If [code]true[/code], when running in the editor, this texture will keep the source-compressed data in memory, allowing the data to persist after loading. Otherwise, the source-compressed data is lost after loading and the texture can't be re-saved.
+ [b]Note:[/b] This property must be set before [method create_from_image] for this to work.
- Allow overriding the texture size (for 2D only).
+ Allows overriding the texture's size (for 2D only).
diff --git a/doc/classes/ProjectSettings.xml b/doc/classes/ProjectSettings.xml
index 6e47df8d017..6fa1fbd6e46 100644
--- a/doc/classes/ProjectSettings.xml
+++ b/doc/classes/ProjectSettings.xml
@@ -3309,15 +3309,15 @@
- [code]d3d12[/code], Direct3D 12 from native drivers. If [member rendering/rendering_device/fallback_to_d3d12] is enabled, this is used as a fallback if Vulkan is not supported.
- If [code]true[/code], the forward renderer will fall back to Direct3D 12 if Vulkan is not supported. The fallback is always attempted regardless of this setting if Vulkan driver support was disabled at compile time.
+ If [code]true[/code], the Forward+ renderer will fall back to Direct3D 12 if Vulkan is not supported. The fallback is always attempted regardless of this setting if Vulkan driver support was disabled at compile time.
[b]Note:[/b] This setting is implemented only on Windows.
- If [code]true[/code], the forward renderer will fall back to OpenGL 3 if Direct3D 12, Metal, and Vulkan are not supported.
+ If [code]true[/code], the Forward+ renderer will fall back to OpenGL 3 if Direct3D 12, Metal, and Vulkan are not supported.
[b]Note:[/b] This setting is implemented on Windows, Android, macOS, iOS, and Linux/X11.
- If [code]true[/code], the forward renderer will fall back to Vulkan if Direct3D 12 (on Windows) or Metal (on macOS x86_64) are not supported. The fallback is always attempted regardless of this setting if Direct3D 12 (Windows) or Metal (macOS) driver support was disabled at compile time.
+ If [code]true[/code], the Forward+ renderer will fall back to Vulkan if Direct3D 12 (on Windows) or Metal (on macOS x86_64) are not supported. The fallback is always attempted regardless of this setting if Direct3D 12 (Windows) or Metal (macOS) driver support was disabled at compile time.
[b]Note:[/b] This setting is implemented on Windows and macOS.
@@ -3443,7 +3443,7 @@
If [code]true[/code], the texture importer will import lossless textures using the PNG format. Otherwise, it will default to using WebP.
- If [code]true[/code], the GPU texture compressor will cache the local RenderingDevice and its resources (shaders and pipelines), allowing for faster subsequent imports at a memory cost.
+ If [code]true[/code], the GPU texture compressor will cache the local RenderingDevice and its resources (shaders and pipelines), making subsequent imports faster at the cost of increased memory usage.
If [code]true[/code], the texture importer will utilize the GPU for compressing textures, improving the import time of large images.
@@ -3498,7 +3498,7 @@
The ratio of [WorkerThreadPool]'s threads that will be reserved for low-priority tasks. For example, if 10 threads are available and this value is set to [code]0.3[/code], 3 of the worker threads will be reserved for low-priority tasks. The actual value won't exceed the number of CPU cores minus one, and if possible, at least one worker thread will be dedicated to low-priority tasks.
- Maximum number of threads to be used by [WorkerThreadPool]. Value of [code]-1[/code] means [code]1[/code] on Web, or a number of [i]logical[/i] CPU cores available on other platforms (see [method OS.get_processor_count]).
+ Maximum number of threads to be used by [WorkerThreadPool]. On Web, a value of [code]-1[/code] means [code]1[/code]. On other platforms, it means all [i]logical[/i] CPU cores available (see [method OS.get_processor_count]).
If [code]true[/code], enables the analog threshold binding modifier if supported by the XR runtime.
@@ -3592,7 +3592,7 @@
If [code]true[/code] and foveation is supported, will automatically adjust foveation level based on framerate up to the level set on [member xr/openxr/foveation_level].
- Applied foveation level if supported: 0 = off, 1 = low, 2 = medium, 3 = high.
+ Applied foveation level if supported.
[b]Note:[/b] On platforms other than Android, if [member rendering/anti_aliasing/quality/msaa_3d] is enabled, this feature will be disabled.
diff --git a/doc/classes/RenderingServer.xml b/doc/classes/RenderingServer.xml
index e1f7a53302b..a0472652e4c 100644
--- a/doc/classes/RenderingServer.xml
+++ b/doc/classes/RenderingServer.xml
@@ -3793,7 +3793,7 @@
Creates a texture based on a native handle that was created outside of Godot's renderer.
- [b]Note:[/b] If using only the rendering device renderer, it's recommend to use [method RenderingDevice.texture_create_from_extension] together with [method RenderingServer.texture_rd_create], rather than this method. It will give you much more control over the texture's format and usage.
+ [b]Note:[/b] If using only the rendering device renderer, it's recommend to use [method RenderingDevice.texture_create_from_extension] together with [method RenderingServer.texture_rd_create], rather than this method. This way, the texture's format and usage can be controlled more effectively.
diff --git a/doc/classes/RichTextLabel.xml b/doc/classes/RichTextLabel.xml
index c0b0fee6284..48ba7a559d7 100644
--- a/doc/classes/RichTextLabel.xml
+++ b/doc/classes/RichTextLabel.xml
@@ -580,7 +580,7 @@
- Adds a [code skip-lint][s][/code] tag to the tag stack. If [param color] alpha value is zero, current font color with alpha multiplied by [theme_item strikethrough_alpha] is used.
+ Adds a [code skip-lint][s][/code] tag to the tag stack. If [param color]'s alpha value is [code]0.0[/code], the current font's color with its alpha multiplied by [theme_item strikethrough_alpha] is used.
@@ -597,7 +597,7 @@
- Adds a [code skip-lint][u][/code] tag to the tag stack. If [param color] alpha value is zero, current font color with alpha multiplied by [theme_item underline_alpha] is used.
+ Adds a [code skip-lint][u][/code] tag to the tag stack. If [param color]'s alpha value is [code]0.0[/code], the current font's color with its alpha multiplied by [theme_item underline_alpha] is used.
@@ -745,13 +745,13 @@
If [code]true[/code], the label underlines hint tags such as [code skip-lint][hint=description]{text}[/hint][/code].
- Controls the text's horizontal alignment. Supports left, center, right, and fill, or justify.
+ Controls the text's horizontal alignment. Supports left, center, right, and fill (also known as justify).
Line fill alignment rules.
- Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
If [code]true[/code], the label underlines meta tags such as [code skip-lint][url]{text}[/url][/code]. These tags can call a function when clicked if [signal meta_clicked] is connected to a function.
diff --git a/doc/classes/RigidBody2D.xml b/doc/classes/RigidBody2D.xml
index c261312e2fc..d2987eeeb69 100644
--- a/doc/classes/RigidBody2D.xml
+++ b/doc/classes/RigidBody2D.xml
@@ -168,11 +168,11 @@
If [code]true[/code], the body is frozen. Gravity and forces are not applied anymore.
See [member freeze_mode] to set the body's behavior when frozen.
- For a body that is always frozen, use [StaticBody2D] or [AnimatableBody2D] instead.
+ [b]Note:[/b] For a body that is always frozen, use [StaticBody2D] or [AnimatableBody2D] instead.
- The body's freeze mode. Can be used to set the body's behavior when [member freeze] is enabled.
- For a body that is always frozen, use [StaticBody2D] or [AnimatableBody2D] instead.
+ The body's freeze mode. Determines the body's behavior when [member freeze] is [code]true[/code].
+ [b]Note:[/b] For a body that is always frozen, use [StaticBody2D] or [AnimatableBody2D] instead.
Multiplies the gravity applied to the body. The body's gravity is calculated from the [member ProjectSettings.physics/2d/default_gravity] project setting and/or any additional gravity vector applied by [Area2D]s.
diff --git a/doc/classes/RigidBody3D.xml b/doc/classes/RigidBody3D.xml
index 75bcfce87ad..4f27d22dec8 100644
--- a/doc/classes/RigidBody3D.xml
+++ b/doc/classes/RigidBody3D.xml
@@ -174,11 +174,11 @@
If [code]true[/code], the body is frozen. Gravity and forces are not applied anymore.
See [member freeze_mode] to set the body's behavior when frozen.
- For a body that is always frozen, use [StaticBody3D] or [AnimatableBody3D] instead.
+ [b]Note:[/b] For a body that is always frozen, use [StaticBody3D] or [AnimatableBody3D] instead.
- The body's freeze mode. Can be used to set the body's behavior when [member freeze] is enabled.
- For a body that is always frozen, use [StaticBody3D] or [AnimatableBody3D] instead.
+ The body's freeze mode. Determines the body's behavior when [member freeze] is [code]true[/code].
+ [b]Note:[/b] For a body that is always frozen, use [StaticBody3D] or [AnimatableBody3D] instead.
This is multiplied by [member ProjectSettings.physics/3d/default_gravity] to produce this body's gravity. For example, a value of [code]1.0[/code] will apply normal gravity, [code]2.0[/code] will apply double the gravity, and [code]0.5[/code] will apply half the gravity to this body.
diff --git a/doc/classes/Script.xml b/doc/classes/Script.xml
index d8d6f4fd211..388802e969f 100644
--- a/doc/classes/Script.xml
+++ b/doc/classes/Script.xml
@@ -87,7 +87,7 @@
- Returns the list of user signals defined in this [Script].
+ Returns the list of signals defined in this [Script].
[b]Note:[/b] The dictionaries returned by this method are formatted identically to those returned by [method Object.get_signal_list].
diff --git a/doc/classes/Sprite2D.xml b/doc/classes/Sprite2D.xml
index 3bb664adb87..482965e3d77 100644
--- a/doc/classes/Sprite2D.xml
+++ b/doc/classes/Sprite2D.xml
@@ -44,8 +44,7 @@
- Returns [code]true[/code], if the pixel at the given position is opaque and [code]false[/code] in other case. The position is in local coordinates.
- [b]Note:[/b] It also returns [code]false[/code], if the sprite's texture is [code]null[/code] or if the given position is invalid.
+ Returns [code]true[/code] if the pixel at the given position is opaque, [code]false[/code] otherwise. Also returns [code]false[/code] if the given position is out of bounds or this sprite's [member texture] is [code]null[/code]. [param pos] is in local coordinates.
diff --git a/doc/classes/StreamPeer.xml b/doc/classes/StreamPeer.xml
index e3fb1e80ac1..c887c37dc2c 100644
--- a/doc/classes/StreamPeer.xml
+++ b/doc/classes/StreamPeer.xml
@@ -44,7 +44,7 @@
- Returns a chunk data with the received bytes. The number of bytes to be received can be requested in the [param bytes] argument. If not enough bytes are available, the function will block until the desired amount is received. This function returns two values, an [enum Error] code and a data array.
+ Returns a chunk data with the received bytes, as an [Array] containing two elements: an [enum Error] constant and a [PackedByteArray]. [param bytes] is the number of bytes to be received. If not enough bytes are available, the function will block until the desired amount is received.
@@ -69,7 +69,7 @@
- Returns a chunk data with the received bytes. The number of bytes to be received can be requested in the [param bytes] argument. If not enough bytes are available, the function will return how many were actually received. This function returns two values: an [enum Error] code and a data array.
+ Returns a chunk data with the received bytes, as an [Array] containing two elements: an [enum Error] constant and a [PackedByteArray]. [param bytes] is the number of bytes to be received. If not enough bytes are available, the function will return how many were actually received.
diff --git a/doc/classes/TabBar.xml b/doc/classes/TabBar.xml
index 9e09a593ae1..fca06cce334 100644
--- a/doc/classes/TabBar.xml
+++ b/doc/classes/TabBar.xml
@@ -204,7 +204,7 @@
- Sets language code of tab title used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Sets the language code of the title for the tab at index [param tab_idx] to [param language]. This is used for line-breaking and text shaping algorithms. If [param language] is empty, the current locale is used.
@@ -246,7 +246,7 @@
If [code]true[/code], tabs overflowing this node's width will be hidden, displaying two navigation buttons instead. Otherwise, this node's minimum size is updated so that all tabs are visible.
- If [code]true[/code], middle clicking on the mouse will fire the [signal tab_close_pressed] signal.
+ If [code]true[/code], middle-clicking on a tab will emit the [signal tab_close_pressed] signal.
The index of the current selected tab. A value of [code]-1[/code] means that no tab is selected and can only be set when [member deselect_enabled] is [code]true[/code] or if all tabs are hidden or disabled.
@@ -274,7 +274,7 @@
If [code]true[/code], hovering over a tab while dragging something will switch to that tab. Does not have effect when hovering another tab to rearrange. The delay for when this happens is dictated by [theme_item hover_switch_wait_msec].
- The position at which tabs will be placed.
+ The horizontal alignment of the tabs.
When the close button will appear on the tabs.
@@ -315,8 +315,8 @@
- Emitted when a tab's close button is pressed or when middle-clicking on a tab, if [member close_with_middle_mouse] is enabled.
- [b]Note:[/b] Tabs are not removed automatically once the close button is pressed, this behavior needs to be programmed manually. For example:
+ Emitted when a tab's close button is pressed or, if [member close_with_middle_mouse] is [code]true[/code], when middle-clicking on a tab.
+ [b]Note:[/b] Tabs are not removed automatically; this behavior needs to be coded manually. For example:
[codeblocks]
[gdscript]
$TabBar.tab_close_pressed.connect($TabBar.remove_tab)
@@ -348,13 +348,13 @@
- Places tabs to the left.
+ Aligns tabs to the left.
- Places tabs in the middle.
+ Aligns tabs in the middle.
- Places tabs to the right.
+ Aligns tabs to the right.
Represents the size of the [enum AlignmentMode] enum.
diff --git a/doc/classes/TabContainer.xml b/doc/classes/TabContainer.xml
index 10777557345..87ab4d93eba 100644
--- a/doc/classes/TabContainer.xml
+++ b/doc/classes/TabContainer.xml
@@ -233,7 +233,7 @@
The focus access mode for the internal [TabBar] node.
- The position of the tab bar.
+ The horizontal alignment of the tabs.
[TabContainer]s with the same rearrange group ID will allow dragging the tabs between them. Enable drag with [member drag_to_rearrange_enabled].
diff --git a/doc/classes/TextEdit.xml b/doc/classes/TextEdit.xml
index 0dc9e35fe8b..0d4b5571e1f 100644
--- a/doc/classes/TextEdit.xml
+++ b/doc/classes/TextEdit.xml
@@ -1350,7 +1350,7 @@
If [code]true[/code], all wrapped lines are indented to the same amount as the unwrapped line.
- Language code used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
If [code]false[/code], using middle mouse button to paste clipboard will be disabled.
diff --git a/doc/classes/TextMesh.xml b/doc/classes/TextMesh.xml
index a4bf9ce17e7..184eeece019 100644
--- a/doc/classes/TextMesh.xml
+++ b/doc/classes/TextMesh.xml
@@ -30,13 +30,13 @@
[b]Note:[/b] Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts. To change the text's size in real-time efficiently, change the node's [member Node3D.scale] instead.
- Controls the text's horizontal alignment. Supports left, center, right, and fill, or justify.
+ Controls the text's horizontal alignment. Supports left, center, right, and fill (also known as justify).
Line fill alignment rules.
- Language code used for text shaping algorithms, if left empty current locale is used instead.
+ Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
Additional vertical spacing between lines (in pixels), spacing is added to line descent. This value can be negative.
diff --git a/doc/classes/TextServer.xml b/doc/classes/TextServer.xml
index 0fb8af1e146..65ba7e8b159 100644
--- a/doc/classes/TextServer.xml
+++ b/doc/classes/TextServer.xml
@@ -214,7 +214,7 @@
- Deprecated. This method always returns [code]1.0[/code].
+ This method does nothing and always returns [code]1.0[/code].
@@ -790,7 +790,7 @@
- Deprecated. This method does nothing.
+ This method does nothing.
@@ -1194,7 +1194,7 @@
- Converts readable feature, variation, script, or language name to OpenType tag.
+ Converts the given readable name of a feature, variation, script, or language to an OpenType tag.
@@ -1930,7 +1930,7 @@
- Returns the string converted to lowercase.
+ Returns the string converted to [code]lowercase[/code].
[b]Note:[/b] Casing is locale dependent and context sensitive if server support [constant FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION] feature (supported by [TextServerAdvanced]).
[b]Note:[/b] The result may be longer or shorter than the original.
@@ -1940,7 +1940,7 @@
- Returns the string converted to title case.
+ Returns the string converted to [code]Title Case[/code].
[b]Note:[/b] Casing is locale dependent and context sensitive if server support [constant FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION] feature (supported by [TextServerAdvanced]).
[b]Note:[/b] The result may be longer or shorter than the original.
@@ -1950,7 +1950,7 @@
- Returns the string converted to uppercase.
+ Returns the string converted to [code]UPPERCASE[/code].
[b]Note:[/b] Casing is locale dependent and context sensitive if server support [constant FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION] feature (supported by [TextServerAdvanced]).
[b]Note:[/b] The result may be longer or shorter than the original.
@@ -1967,7 +1967,7 @@
- Converts OpenType tag to readable feature, variation, script, or language name.
+ Converts the given OpenType tag to the readable name of a feature, variation, script, or language.
diff --git a/doc/classes/TextServerExtension.xml b/doc/classes/TextServerExtension.xml
index 5ceb3a19483..3e4a1ea57b7 100644
--- a/doc/classes/TextServerExtension.xml
+++ b/doc/classes/TextServerExtension.xml
@@ -1161,7 +1161,7 @@
- Converts readable feature, variation, script, or language name to OpenType tag.
+ Converts the given readable name of a feature, variation, script, or language to an OpenType tag.
@@ -1886,7 +1886,7 @@
- Returns the string converted to lowercase.
+ Returns the string converted to [code]lowercase[/code].
@@ -1894,7 +1894,7 @@
- Returns the string converted to title case.
+ Returns the string converted to [code]Title Case[/code].
@@ -1902,7 +1902,7 @@
- Returns the string converted to uppercase.
+ Returns the string converted to [code]UPPERCASE[/code].
@@ -1916,7 +1916,7 @@
- Converts OpenType tag to readable feature, variation, script, or language name.
+ Converts the given OpenType tag to the readable name of a feature, variation, script, or language.
diff --git a/doc/classes/Tree.xml b/doc/classes/Tree.xml
index 1d1ca87693a..1ca786af9ee 100644
--- a/doc/classes/Tree.xml
+++ b/doc/classes/Tree.xml
@@ -326,7 +326,7 @@
- Sets language code of column title used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Sets the language code of the given [param column]'s title to [param language]. This is used for line-breaking and text shaping algorithms. If [param language] is empty, the current locale is used.
diff --git a/doc/classes/TreeItem.xml b/doc/classes/TreeItem.xml
index 6553e86421d..f0c20fae428 100644
--- a/doc/classes/TreeItem.xml
+++ b/doc/classes/TreeItem.xml
@@ -763,7 +763,7 @@
- Sets language code of item's text used for line-breaking and text shaping algorithms, if left empty current locale is used instead.
+ Sets the language code of the given [param column]'s text to [param language]. This is used for line-breaking and text shaping algorithms. If [param language] is empty, the current locale is used.
diff --git a/doc/classes/Viewport.xml b/doc/classes/Viewport.xml
index 7832cc844c8..ed5342dc736 100644
--- a/doc/classes/Viewport.xml
+++ b/doc/classes/Viewport.xml
@@ -169,7 +169,7 @@
- Returns the drag data human-readable description.
+ Returns the human-readable description of the drag data, used for assistive apps.
@@ -208,7 +208,7 @@
- Sets the drag data human-readable description.
+ Sets the human-readable description of the drag data to [param description], used for assistive apps.
@@ -329,10 +329,10 @@
The rendering layers in which this [Viewport] renders [CanvasItem] nodes.
- Sets the default filter mode used by [CanvasItem]s in this Viewport.
+ The default filter mode used by [CanvasItem] nodes in this viewport.
- Sets the default repeat mode used by [CanvasItem]s in this Viewport.
+ The default repeat mode used by [CanvasItem] nodes in this viewport.
The canvas transform of the viewport, useful for changing the on-screen positions of all child [CanvasItem]s. This is relative to the global canvas transform of the viewport.
diff --git a/doc/classes/VoxelGI.xml b/doc/classes/VoxelGI.xml
index 93679cccf6f..c92501a42bc 100644
--- a/doc/classes/VoxelGI.xml
+++ b/doc/classes/VoxelGI.xml
@@ -40,8 +40,8 @@
The [VoxelGIData] resource that holds the data for this [VoxelGI].
- The size of the area covered by the [VoxelGI]. If you make the size larger without increasing the subdivisions with [member subdiv], the size of each cell will increase and result in lower detailed lighting.
- [b]Note:[/b] Size is clamped to 1.0 unit or more on each axis.
+ The size of the area covered by the [VoxelGI]. This must be [code]1.0[/code] or greater on each axis.
+ [b]Note:[/b] If you make the size larger without increasing the number of subdivisions with [member subdiv], the size of each cell will increase and result in less detailed lighting.
Number of times to subdivide the grid that the [VoxelGI] operates on. A higher number results in finer detail and thus higher visual quality, while lower numbers result in better performance.
diff --git a/doc/classes/Window.xml b/doc/classes/Window.xml
index b7baab7b256..c0f9c771017 100644
--- a/doc/classes/Window.xml
+++ b/doc/classes/Window.xml
@@ -362,7 +362,7 @@
- Centers a native window on the current screen and an embedded window on its embedder [Viewport].
+ Centers the window in the current screen. If the window is embedded, it is centered in the embedder [Viewport] instead.
diff --git a/modules/websocket/doc_classes/WebSocketPeer.xml b/modules/websocket/doc_classes/WebSocketPeer.xml
index e1965e34d6e..8c5475a7b10 100644
--- a/modules/websocket/doc_classes/WebSocketPeer.xml
+++ b/modules/websocket/doc_classes/WebSocketPeer.xml
@@ -4,7 +4,7 @@
A WebSocket connection.
- This class represents WebSocket connection, and can be used as a WebSocket client (RFC 6455-compliant) or as a remote peer of a WebSocket server.
+ This class represents WebSocket connection, and can be used as a WebSocket client ([url=https://datatracker.ietf.org/doc/html/rfc6455]RFC 6455[/url]-compliant) or as a remote peer of a WebSocket server.
You can send WebSocket binary frames using [method PacketPeer.put_packet], and WebSocket text frames using [method send] (prefer text frames when interacting with text-based API). You can check the frame type of the last packet via [method was_string_packet].
To start a WebSocket client, first call [method connect_to_url], then regularly call [method poll] (e.g. during [Node] process). You can query the socket state via [method get_ready_state], get the number of pending packets using [method PacketPeer.get_available_packet_count], and retrieve them via [method PacketPeer.get_packet].
[codeblocks]
@@ -50,8 +50,10 @@
- Closes this WebSocket connection. [param code] is the status code for the closure (see RFC 6455 section 7.4 for a list of valid status codes). [param reason] is the human readable reason for closing the connection (can be any UTF-8 string that's smaller than 123 bytes). If [param code] is negative, the connection will be closed immediately without notifying the remote peer.
- [b]Note:[/b] To achieve a clean close, you will need to keep polling until [constant STATE_CLOSED] is reached.
+ Closes this WebSocket connection.
+ [param code] is the status code for the closure (see [url=https://datatracker.ietf.org/doc/html/rfc6455#section-7.4.1]RFC 6455 section 7.4[/url] for a list of valid status codes). If [param code] is negative, the connection will be closed immediately without notifying the remote peer.
+ [param reason] is the human-readable reason for closing the connection. It can be any UTF-8 string that's smaller than 123 bytes.
+ [b]Note:[/b] To achieve a clean closure, you will need to keep polling until [constant STATE_CLOSED] is reached.
[b]Note:[/b] The Web export might not support all status codes. Please refer to browser-specific documentation for more details.