Fix miscellaneous oddities around the class reference (part 6)

Author: Mickeon

doc/classes/Array.xml

@@ -435,7 +435,7 @@
 			<return type="Variant" />
 			<param index="0" name="index" type="int" />
 			<description>
-				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.
 			</description>
 		</method>

doc/classes/BaseMaterial3D.xml

@@ -14,37 +14,37 @@
 			<return type="bool" />
 			<param index="0" name="feature" type="int" enum="BaseMaterial3D.Feature" />
 			<description>
-				Returns [code]true[/code], if the specified [enum Feature] is enabled.
+				Returns [code]true[/code] if the specified [param feature] is enabled.
 			</description>
 		</method>
 		<method name="get_flag" qualifiers="const">
 			<return type="bool" />
 			<param index="0" name="flag" type="int" enum="BaseMaterial3D.Flags" />
 			<description>
-				Returns [code]true[/code] if the specified flag is enabled.
+				Returns [code]true[/code] if the specified [param flag] is enabled.
 			</description>
 		</method>
 		<method name="get_texture" qualifiers="const">
 			<return type="Texture2D" />
 			<param index="0" name="param" type="int" enum="BaseMaterial3D.TextureParam" />
 			<description>
-				Returns the [Texture2D] associated with the specified [enum TextureParam].
+				Returns the [Texture2D] associated with the specified texture [param param].
 			</description>
 		</method>
 		<method name="set_feature">
 			<return type="void" />
 			<param index="0" name="feature" type="int" enum="BaseMaterial3D.Feature" />
 			<param index="1" name="enable" type="bool" />
 			<description>
-				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].
 			</description>
 		</method>
 		<method name="set_flag">
 			<return type="void" />
 			<param index="0" name="flag" type="int" enum="BaseMaterial3D.Flags" />
 			<param index="1" name="enable" type="bool" />
 			<description>
-				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].
 			</description>
 		</method>
 		<method name="set_texture">

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.
 		</member>
 		<member name="language" type="String" setter="set_language" getter="get_language" default="&quot;&quot;">
-			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.
 		</member>
 		<member name="text" type="String" setter="set_text" getter="get_text" default="&quot;&quot;">
 			The button's text that will be displayed inside the button's area.

doc/classes/Color.xml

@@ -365,14 +365,14 @@
 			<return type="Color" />
 			<description>
 				Returns the color converted to the [url=https://en.wikipedia.org/wiki/SRGB]sRGB[/url] color space. This method assumes the original color is in the linear color space. 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 color space 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.
 			</description>
 		</method>
 		<method name="srgb_to_linear" qualifiers="const">
 			<return type="Color" />
 			<description>
 				Returns the color converted to the linear color space. This method assumes the original color already is in the sRGB color space. 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 color space 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.
 			</description>
 		</method>
 		<method name="to_abgr32" qualifiers="const">

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.
-		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.
 	</description>

doc/classes/DisplayServer.xml

@@ -42,22 +42,22 @@
 			<return type="Variant" />
 			<param index="0" name="id" type="RID" />
 			<description>
-				Returns the metadata of the accessibility element.
+				Returns the metadata of the accessibility element [param id].
 			</description>
 		</method>
 		<method name="accessibility_element_set_meta">
 			<return type="void" />
 			<param index="0" name="id" type="RID" />
 			<param index="1" name="meta" type="Variant" />
 			<description>
-				Sets the metadata of the accessibility element.
+				Sets the metadata of the accessibility element [param id] to [param meta].
 			</description>
 		</method>
 		<method name="accessibility_free_element">
 			<return type="void" />
 			<param index="0" name="id" type="RID" />
 			<description>
-				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].
 			</description>
 		</method>
 		<method name="accessibility_get_window_root" qualifiers="const">
@@ -870,7 +870,7 @@
 		<method name="get_primary_screen" qualifiers="const">
 			<return type="int" />
 			<description>
-				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].
 			</description>
 		</method>
@@ -1752,9 +1752,9 @@
 			<return type="Color" />
 			<param index="0" name="position" type="Vector2i" />
 			<description>
-				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.
 			</description>
 		</method>
 		<method name="screen_get_position" qualifiers="const">

doc/classes/EditorExportPlatform.xml

@@ -138,27 +138,27 @@
 			<return type="String" />
 			<param index="0" name="index" type="int" />
 			<description>
-				Returns message category, for the message with [param index].
+				Returns the message category for the message with the given [param index].
 			</description>
 		</method>
 		<method name="get_message_count" qualifiers="const">
 			<return type="int" />
 			<description>
-				Returns number of messages in the export log.
+				Returns the number of messages in the export log.
 			</description>
 		</method>
 		<method name="get_message_text" qualifiers="const">
 			<return type="String" />
 			<param index="0" name="index" type="int" />
 			<description>
-				Returns message text, for the message with [param index].
+				Returns the text for the message with the given [param index].
 			</description>
 		</method>
 		<method name="get_message_type" qualifiers="const">
 			<return type="int" enum="EditorExportPlatform.ExportMessageType" />
 			<param index="0" name="index" type="int" />
 			<description>
-				Returns message type, for the message with [param index].
+				Returns the type for the message with the given [param index].
 			</description>
 		</method>
 		<method name="get_os_name" qualifiers="const">

doc/classes/EditorSettings.xml

@@ -1154,7 +1154,7 @@
 			All update modes will ignore builds with different major versions (e.g. Godot 4 -> Godot 5).
 		</member>
 		<member name="network/connection/network_mode" type="int" setter="" getter="">
-			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.
 		</member>
 		<member name="network/debug/remote_host" type="String" setter="" getter="">
 			The address to listen to when starting the remote debugger. This can be set to this device's local IP address to allow external clients to connect to the remote debugger (instead of restricting the remote debugger to connections from [code]localhost[/code]).

doc/classes/EditorToaster.xml

@@ -4,7 +4,7 @@
 		Manages toast notifications within the editor.
 	</brief_description>
 	<description>
-		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].
 	</description>
 	<tutorials>

doc/classes/FileAccess.xml

@@ -293,14 +293,14 @@
 			<return type="int" />
 			<param index="0" name="file" type="String" />
 			<description>
-				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.
 			</description>
 		</method>
 		<method name="get_unix_permissions" qualifiers="static">
 			<return type="int" enum="FileAccess.UnixPermissionFlags" is_bitfield="true" />
 			<param index="0" name="file" type="String" />
 			<description>
-				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.
 			</description>
 		</method>