Merge pull request #68948 from KoBeWi/eeny_meeny_miny_moe

Fill random docs

doc/classes/CanvasGroup.xml

@@ -1,8 +1,11 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="CanvasGroup" inherits="Node2D" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
 	<brief_description>
+		Merges several 2D nodes into a single draw operation.
 	</brief_description>
 	<description>
+		Child [CanvasItem] nodes of a [CanvasGroup] are drawn as a single object. It allows to e.g. draw overlapping translucent 2D nodes without blending (set [member CanvasItem.self_modulate] property of [CanvasGroup] to achieve this effect).
+		[b]Note:[/b] Since [CanvasGroup] and [member CanvasItem.clip_children] both utilize the backbuffer, children of a [CanvasGroup] who have their [member CanvasItem.clip_children] set to anything other than [constant CanvasItem.CLIP_CHILDREN_DISABLED] will not function correctly.
 	</description>
 	<tutorials>
 	</tutorials>

doc/classes/CanvasItem.xml

@@ -672,12 +672,16 @@
 			Represents the size of the [enum TextureRepeat] enum.
 		</constant>
 		<constant name="CLIP_CHILDREN_DISABLED" value="0" enum="ClipChildrenMode">
+			Child draws over parent and is not clipped.
 		</constant>
 		<constant name="CLIP_CHILDREN_ONLY" value="1" enum="ClipChildrenMode">
+			Parent is used for the purposes of clipping only. Child is clipped to the parent's visible area, parent is not drawn.
 		</constant>
 		<constant name="CLIP_CHILDREN_AND_DRAW" value="2" enum="ClipChildrenMode">
+			Parent is used for clipping child, but parent is also drawn underneath child as normal before clipping child to its visible area.
 		</constant>
 		<constant name="CLIP_CHILDREN_MAX" value="3" enum="ClipChildrenMode">
+			Represents the size of the [enum ClipChildrenMode] enum.
 		</constant>
 	</constants>
 </class>

doc/classes/EditorPlugin.xml

@@ -719,44 +719,64 @@
 	</signals>
 	<constants>
 		<constant name="CONTAINER_TOOLBAR" value="0" enum="CustomControlContainer">
+			Main editor toolbar, next to play buttons.
 		</constant>
 		<constant name="CONTAINER_SPATIAL_EDITOR_MENU" value="1" enum="CustomControlContainer">
+			The toolbar that appears when 3D editor is active.
 		</constant>
 		<constant name="CONTAINER_SPATIAL_EDITOR_SIDE_LEFT" value="2" enum="CustomControlContainer">
+			Left sidebar of the 3D editor.
 		</constant>
 		<constant name="CONTAINER_SPATIAL_EDITOR_SIDE_RIGHT" value="3" enum="CustomControlContainer">
+			Right sidebar of the 3D editor.
 		</constant>
 		<constant name="CONTAINER_SPATIAL_EDITOR_BOTTOM" value="4" enum="CustomControlContainer">
+			Bottom panel of the 3D editor.
 		</constant>
 		<constant name="CONTAINER_CANVAS_EDITOR_MENU" value="5" enum="CustomControlContainer">
+			The toolbar that appears when 2D editor is active.
 		</constant>
 		<constant name="CONTAINER_CANVAS_EDITOR_SIDE_LEFT" value="6" enum="CustomControlContainer">
+			Left sidebar of the 2D editor.
 		</constant>
 		<constant name="CONTAINER_CANVAS_EDITOR_SIDE_RIGHT" value="7" enum="CustomControlContainer">
+			Right sidebar of the 2D editor.
 		</constant>
 		<constant name="CONTAINER_CANVAS_EDITOR_BOTTOM" value="8" enum="CustomControlContainer">
+			Bottom panel of the 2D editor.
 		</constant>
 		<constant name="CONTAINER_INSPECTOR_BOTTOM" value="9" enum="CustomControlContainer">
+			Bottom section of the inspector.
 		</constant>
 		<constant name="CONTAINER_PROJECT_SETTING_TAB_LEFT" value="10" enum="CustomControlContainer">
+			Tab of Project Settings dialog, to the left of other tabs.
 		</constant>
 		<constant name="CONTAINER_PROJECT_SETTING_TAB_RIGHT" value="11" enum="CustomControlContainer">
+			Tab of Project Settings dialog, to the right of other tabs.
 		</constant>
 		<constant name="DOCK_SLOT_LEFT_UL" value="0" enum="DockSlot">
+			Dock slot, left side, upper-left (empty in default layout).
 		</constant>
 		<constant name="DOCK_SLOT_LEFT_BL" value="1" enum="DockSlot">
+			Dock slot, left side, bottom-left (empty in default layout).
 		</constant>
 		<constant name="DOCK_SLOT_LEFT_UR" value="2" enum="DockSlot">
+			Dock slot, left side, upper-right (in default layout includes Scene and Import docks).
 		</constant>
 		<constant name="DOCK_SLOT_LEFT_BR" value="3" enum="DockSlot">
+			Dock slot, left side, bottom-right (in default layout includes FileSystem dock).
 		</constant>
 		<constant name="DOCK_SLOT_RIGHT_UL" value="4" enum="DockSlot">
+			Dock slot, right side, upper-left (empty in default layout).
 		</constant>
 		<constant name="DOCK_SLOT_RIGHT_BL" value="5" enum="DockSlot">
+			Dock slot, right side, bottom-left (empty in default layout).
 		</constant>
 		<constant name="DOCK_SLOT_RIGHT_UR" value="6" enum="DockSlot">
+			Dock slot, right side, upper-right (in default layout includes Inspector, Node and History docks).
 		</constant>
 		<constant name="DOCK_SLOT_RIGHT_BR" value="7" enum="DockSlot">
+			Dock slot, right side, bottom-right (empty in default layout).
 		</constant>
 		<constant name="DOCK_SLOT_MAX" value="8" enum="DockSlot">
 			Represents the size of the [enum DockSlot] enum.

doc/classes/HSlider.xml

@@ -29,6 +29,7 @@
 			The background of the area to the left of the grabber.
 		</theme_item>
 		<theme_item name="grabber_area_highlight" data_type="style" type="StyleBox">
+			The background of the area to the left of the grabber that displays when it's being hovered or focused.
 		</theme_item>
 		<theme_item name="slider" data_type="style" type="StyleBox">
 			The background for the whole slider. Determines the height of the [code]grabber_area[/code].

doc/classes/Label.xml

@@ -50,6 +50,7 @@
 			Controls the text's horizontal alignment. Supports left, center, right, and fill, or justify. Set it to one of the [enum HorizontalAlignment] constants.
 		</member>
 		<member name="label_settings" type="LabelSettings" setter="set_label_settings" getter="get_label_settings">
+			A [LabelSettings] resource that can be shared between multiple [Label] nodes. Takes priority over theme properties.
 		</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.
@@ -100,7 +101,7 @@
 			Default text [Color] of the [Label].
 		</theme_item>
 		<theme_item name="font_outline_color" data_type="color" type="Color" default="Color(1, 1, 1, 1)">
-			The tint of text outline.
+			The color of text outline.
 		</theme_item>
 		<theme_item name="font_shadow_color" data_type="color" type="Color" default="Color(0, 0, 0, 0)">
 			[Color] of the text's shadow effect.

doc/classes/LabelSettings.xml

@@ -1,29 +1,40 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="LabelSettings" inherits="Resource" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
 	<brief_description>
+		Collection of common settings to customize label text.
 	</brief_description>
 	<description>
+		[LabelSettings] is a resource that can be assigned to a [Label] node to customize it. It will take priority over the properties defined in theme. The resource can be shared between multiple labels and swapped on the fly, so it's convenient and flexible way to setup text style.
 	</description>
 	<tutorials>
 	</tutorials>
 	<members>
 		<member name="font" type="Font" setter="set_font" getter="get_font">
+			[Font] used for the text.
 		</member>
 		<member name="font_color" type="Color" setter="set_font_color" getter="get_font_color" default="Color(1, 1, 1, 1)">
+			Color of the text.
 		</member>
 		<member name="font_size" type="int" setter="set_font_size" getter="get_font_size" default="16">
+			Size of the text.
 		</member>
 		<member name="line_spacing" type="float" setter="set_line_spacing" getter="get_line_spacing" default="3.0">
+			Vertical space between lines when the text is multiline.
 		</member>
 		<member name="outline_color" type="Color" setter="set_outline_color" getter="get_outline_color" default="Color(1, 1, 1, 1)">
+			The color of the outline.
 		</member>
 		<member name="outline_size" type="int" setter="set_outline_size" getter="get_outline_size" default="0">
+			Text outline size.
 		</member>
 		<member name="shadow_color" type="Color" setter="set_shadow_color" getter="get_shadow_color" default="Color(0, 0, 0, 0)">
+			Color of the shadow effect. If alpha is [code]0[/code], no shadow will be drawn.
 		</member>
 		<member name="shadow_offset" type="Vector2" setter="set_shadow_offset" getter="get_shadow_offset" default="Vector2(1, 1)">
+			Offset of the shadow effect, in pixels.
 		</member>
 		<member name="shadow_size" type="int" setter="set_shadow_size" getter="get_shadow_size" default="1">
+			Size of the shadow effect.
 		</member>
 	</members>
 </class>

doc/classes/NodePath.xml

@@ -187,12 +187,14 @@
 			<return type="bool" />
 			<param index="0" name="right" type="NodePath" />
 			<description>
+				Returns [code]true[/code] if two node paths are not equal.
 			</description>
 		</operator>
 		<operator name="operator ==">
 			<return type="bool" />
 			<param index="0" name="right" type="NodePath" />
 			<description>
+				Returns [code]true[/code] if two node paths are equal, i.e. all node names in the path are the same and in the same order.
 			</description>
 		</operator>
 	</operators>

doc/classes/PopupMenu.xml

@@ -544,6 +544,7 @@
 		</signal>
 		<signal name="menu_changed">
 			<description>
+				Emitted when any item is added, modified or removed.
 			</description>
 		</signal>
 	</signals>
@@ -576,8 +577,10 @@
 			Width of the single indentation level.
 		</theme_item>
 		<theme_item name="item_end_padding" data_type="constant" type="int" default="2">
+			Horizontal padding to the right of the items (or left, in RTL layout).
 		</theme_item>
 		<theme_item name="item_start_padding" data_type="constant" type="int" default="2">
+			Horizontal padding to the left of the items (or right, in RTL layout).
 		</theme_item>
 		<theme_item name="outline_size" data_type="constant" type="int" default="0">
 			The size of the item text outline.

doc/classes/ProjectSettings.xml

@@ -839,6 +839,7 @@
 			[b]Note:[/b] Default [code]ui_*[/code] actions cannot be removed as they are necessary for the internal logic of several [Control]s. The events assigned to the action can however be modified.
 		</member>
 		<member name="input/ui_swap_input_direction" type="Dictionary" setter="" getter="">
+			Default [InputEventAction] to swap input direction, i.e. change between left-to-right to right-to-left modes. Affects text-editting controls ([LineEdit], [TextEdit]).
 		</member>
 		<member name="input/ui_text_add_selection_for_next_occurrence" type="Dictionary" setter="" getter="">
 			If a selection is currently active with the last caret in text fields, searches for the next occurrence of the selection, adds a caret and selects the next occurrence.

doc/classes/ScrollContainer.xml

@@ -49,6 +49,7 @@
 			Controls whether horizontal scrollbar can be used and when it should be visible. See [enum ScrollMode] for options.
 		</member>
 		<member name="scroll_deadzone" type="int" setter="set_deadzone" getter="get_deadzone" default="0">
+			Deadzone for touch scrolling. Lower deadzone makes the scrolling more sensitive.
 		</member>
 		<member name="scroll_horizontal" type="int" setter="set_h_scroll" getter="get_h_scroll" default="0">
 			The current horizontal scroll value.

doc/classes/Signal.xml

@@ -4,6 +4,8 @@
 		Class representing a signal defined in an object.
 	</brief_description>
 	<description>
+		Signals can be connected to [Callable]s and emitted. When a signal is emitted, all connected callables are called.
+		Usually signals are accessed as properties of objects, but it's also possible to assign them to variables and pass them around, allowing for more dynamic connections.
 	</description>
 	<tutorials>
 		<link title="Using Signals">$DOCS_URL/getting_started/step_by_step/signals.html</link>
@@ -95,6 +97,7 @@
 		<method name="is_null" qualifiers="const">
 			<return type="bool" />
 			<description>
+				Returns [code]true[/code] if either object or signal name are not valid.
 			</description>
 		</method>
 	</methods>
@@ -103,12 +106,14 @@
 			<return type="bool" />
 			<param index="0" name="right" type="Signal" />
 			<description>
+				Returns [code]true[/code] if two signals are not equal.
 			</description>
 		</operator>
 		<operator name="operator ==">
 			<return type="bool" />
 			<param index="0" name="right" type="Signal" />
 			<description>
+				Returns [code]true[/code] if two signals are equal, i.e. their object and name are the same.
 			</description>
 		</operator>
 	</operators>

doc/classes/SpinBox.xml

@@ -46,6 +46,7 @@
 	</methods>
 	<members>
 		<member name="alignment" type="int" setter="set_horizontal_alignment" getter="get_horizontal_alignment" enum="HorizontalAlignment" default="0">
+			Changes the alignment of the underlying [LineEdit].
 		</member>
 		<member name="custom_arrow_step" type="float" setter="set_custom_arrow_step" getter="get_custom_arrow_step" default="0.0">
 			If not [code]0[/code], [code]value[/code] will always be rounded to a multiple of [code]custom_arrow_step[/code] when interacting with the arrow buttons of the [SpinBox].

doc/classes/Sprite3D.xml

@@ -19,6 +19,7 @@
 			The number of columns in the sprite sheet.
 		</member>
 		<member name="region_enabled" type="bool" setter="set_region_enabled" getter="is_region_enabled" default="false">
+			If [code]true[/code], the sprite will use [member region_rect] and display only the specified part of its texture.
 		</member>
 		<member name="region_rect" type="Rect2" setter="set_region_rect" getter="get_region_rect" default="Rect2(0, 0, 0, 0)">
 			The region of the atlas texture to display. [member region_enabled] must be [code]true[/code].

doc/classes/TextureProgressBar.xml

@@ -13,6 +13,7 @@
 			<return type="int" />
 			<param index="0" name="margin" type="int" enum="Side" />
 			<description>
+				Returns the stretch margin with the specified index. See [member stretch_margin_bottom] and related properties.
 			</description>
 		</method>
 		<method name="set_stretch_margin">
@@ -20,6 +21,7 @@
 			<param index="0" name="margin" type="int" enum="Side" />
 			<param index="1" name="value" type="int" />
 			<description>
+				Sets the stretch margin with the specified index. See [member stretch_margin_bottom] and related properties.
 			</description>
 		</method>
 	</methods>

doc/classes/TileData.xml

@@ -1,8 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="TileData" inherits="Object" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
 	<brief_description>
+		Settings for a single tile in a [TileSet].
 	</brief_description>
 	<description>
+		[TileData] object represents a single tile in a [TileSet]. It is usually edited using the tileset editor, but it can be modified at runtime using [method TileMap._tile_data_runtime_update].
 	</description>
 	<tutorials>
 	</tutorials>
@@ -196,32 +198,43 @@
 	</methods>
 	<members>
 		<member name="flip_h" type="bool" setter="set_flip_h" getter="get_flip_h" default="false">
+			If [code]true[/code], the tile will have its texture flipped horizontally.
 		</member>
 		<member name="flip_v" type="bool" setter="set_flip_v" getter="get_flip_v" default="false">
+			If [code]true[/code], the tile will have its texture flipped vertically.
 		</member>
 		<member name="material" type="Material" setter="set_material" getter="get_material">
 			The [Material] to use for this [TileData]. This can be a [CanvasItemMaterial] to use the default shader, or a [ShaderMaterial] to use a custom shader.
 		</member>
 		<member name="modulate" type="Color" setter="set_modulate" getter="get_modulate" default="Color(1, 1, 1, 1)">
+			Color modulation of the tile.
 		</member>
 		<member name="probability" type="float" setter="set_probability" getter="get_probability" default="1.0">
+			Relative probability of this tile being selected when drawing a pattern of random tiles.
 		</member>
 		<member name="terrain" type="int" setter="set_terrain" getter="get_terrain" default="-1">
+			ID of the terrain from the terrain set that the tile uses.
 		</member>
 		<member name="terrain_set" type="int" setter="set_terrain_set" getter="get_terrain_set" default="-1">
+			ID of the terrain set that the tile uses.
 		</member>
 		<member name="texture_offset" type="Vector2i" setter="set_texture_offset" getter="get_texture_offset" default="Vector2i(0, 0)">
+			Offsets the position of where the tile is drawn.
 		</member>
 		<member name="transpose" type="bool" setter="set_transpose" getter="get_transpose" default="false">
+			If [code]true[/code], the tile will display transposed, i.e. with horizontal and vertical texture UVs swapped.
 		</member>
 		<member name="y_sort_origin" type="int" setter="set_y_sort_origin" getter="get_y_sort_origin" default="0">
+			Vertical point of the tile used for determining y-sorted order.
 		</member>
 		<member name="z_index" type="int" setter="set_z_index" getter="get_z_index" default="0">
+			Ordering index of this tile, relative to [TileMap].
 		</member>
 	</members>
 	<signals>
 		<signal name="changed">
 			<description>
+				Emitted when any of the properties are changed.
 			</description>
 		</signal>
 	</signals>

doc/classes/Tree.xml

@@ -84,6 +84,7 @@
 			<return type="int" />
 			<param index="0" name="column" type="int" />
 			<description>
+				Returns the expand ratio assigned to the column.
 			</description>
 		</method>
 		<method name="get_column_title" qualifiers="const">
@@ -223,12 +224,14 @@
 			<return type="bool" />
 			<param index="0" name="column" type="int" />
 			<description>
+				Returns [code]true[/code] if the column has enabled clipping (see [method set_column_clip_content]).
 			</description>
 		</method>
 		<method name="is_column_expanding" qualifiers="const">
 			<return type="bool" />
 			<param index="0" name="column" type="int" />
 			<description>
+				Returns [code]true[/code] if the column has enabled expanding (see [method set_column_expand]).
 			</description>
 		</method>
 		<method name="scroll_to_item">
@@ -244,6 +247,7 @@
 			<param index="0" name="column" type="int" />
 			<param index="1" name="enable" type="bool" />
 			<description>
+				Allows to enable clipping for column's content, making the content size ignored.
 			</description>
 		</method>
 		<method name="set_column_custom_minimum_width">
@@ -259,7 +263,7 @@
 			<param index="0" name="column" type="int" />
 			<param index="1" name="expand" type="bool" />
 			<description>
-				If [code]true[/code], the column will have the "Expand" flag of [Control]. Columns that have the "Expand" flag will use their "min_width" in a similar fashion to [member Control.size_flags_stretch_ratio].
+				If [code]true[/code], the column will have the "Expand" flag of [Control]. Columns that have the "Expand" flag will use their expand ratio in a similar fashion to [member Control.size_flags_stretch_ratio] (see [method set_column_expand_ratio]).
 			</description>
 		</method>
 		<method name="set_column_expand_ratio">
@@ -267,6 +271,7 @@
 			<param index="0" name="column" type="int" />
 			<param index="1" name="ratio" type="int" />
 			<description>
+				Sets the relative expand ratio for a column. See [method set_column_expand].
 			</description>
 		</method>
 		<method name="set_column_title">

doc/classes/VSlider.xml

@@ -33,7 +33,7 @@
 			The background of the area below the grabber.
 		</theme_item>
 		<theme_item name="grabber_area_highlight" data_type="style" type="StyleBox">
-			The background of the area below the grabber, to the left of the grabber.
+			The background of the area below the grabber that displays when it's being hovered or focused.
 		</theme_item>
 		<theme_item name="slider" data_type="style" type="StyleBox">
 			The background for the whole slider. Determines the width of the [code]grabber_area[/code].

modules/gridmap/doc_classes/GridMap.xml

@@ -25,12 +25,14 @@
 		<method name="clear_baked_meshes">
 			<return type="void" />
 			<description>
+				Clears all baked meshes. See [method make_baked_meshes].
 			</description>
 		</method>
 		<method name="get_bake_mesh_instance">
 			<return type="RID" />
 			<param index="0" name="idx" type="int" />
 			<description>
+				Returns [RID] of a baked mesh with the given [param idx].
 			</description>
 		</method>
 		<method name="get_bake_meshes">
@@ -133,6 +135,7 @@
 			<param index="0" name="gen_lightmap_uv" type="bool" default="false" />
 			<param index="1" name="lightmap_uv_texel_size" type="float" default="0.1" />
 			<description>
+				Bakes lightmap data for all meshes in the assigned [MeshLibrary].
 			</description>
 		</method>
 		<method name="map_to_local" qualifiers="const">
@@ -146,6 +149,7 @@
 			<return type="void" />
 			<param index="0" name="resource" type="Resource" />
 			<description>
+				Notifies the [GridMap] about changed resource and recreates octant data.
 			</description>
 		</method>
 		<method name="set_cell_item">