From 9b5cd8e2400ac305b3e47229a8981327c22823f0 Mon Sep 17 00:00:00 2001
From: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
Date: Tue, 27 Feb 2024 17:20:24 +0100
Subject: [PATCH] [Doc] Fix some incorrect uses of "children"
---
doc/classes/AnimationNode.xml | 4 ++--
doc/classes/AnimationNodeTimeScale.xml | 2 +-
doc/classes/CanvasItem.xml | 4 ++--
doc/classes/FlowContainer.xml | 4 ++--
doc/classes/GridContainer.xml | 4 ++--
doc/classes/Node.xml | 12 ++++++------
doc/classes/PackedScene.xml | 2 +-
doc/classes/Skeleton3D.xml | 2 +-
doc/classes/TabContainer.xml | 2 +-
doc/classes/Viewport.xml | 2 +-
doc/classes/Window.xml | 2 +-
modules/gltf/doc_classes/GLTFNode.xml | 2 +-
12 files changed, 21 insertions(+), 21 deletions(-)
diff --git a/doc/classes/AnimationNode.xml b/doc/classes/AnimationNode.xml
index a028d0bb4f4..d7fb735b4d4 100644
--- a/doc/classes/AnimationNode.xml
+++ b/doc/classes/AnimationNode.xml
@@ -27,7 +27,7 @@
- When inheriting from [AnimationRootNode], implement this virtual method to return all children animation nodes in order as a [code]name: node[/code] dictionary.
+ When inheriting from [AnimationRootNode], implement this virtual method to return all child animation nodes in order as a [code]name: node[/code] dictionary.
@@ -115,7 +115,7 @@
- Blend another animation node (in case this animation node contains children animation nodes). This function is only useful if you inherit from [AnimationRootNode] instead, else editors will not display your animation node for addition.
+ Blend another animation node (in case this animation node contains child animation nodes). This function is only useful if you inherit from [AnimationRootNode] instead, otherwise editors will not display your animation node for addition.
diff --git a/doc/classes/AnimationNodeTimeScale.xml b/doc/classes/AnimationNodeTimeScale.xml
index d7d48145065..4cb8ccb962b 100644
--- a/doc/classes/AnimationNodeTimeScale.xml
+++ b/doc/classes/AnimationNodeTimeScale.xml
@@ -4,7 +4,7 @@
A time-scaling animation node used in [AnimationTree].
- Allows to scale the speed of the animation (or reverse it) in any children [AnimationNode]s. Setting it to [code]0.0[/code] will pause the animation.
+ Allows to scale the speed of the animation (or reverse it) in any child [AnimationNode]s. Setting it to [code]0.0[/code] will pause the animation.
$DOCS_URL/tutorials/animation/animation_tree.html
diff --git a/doc/classes/CanvasItem.xml b/doc/classes/CanvasItem.xml
index 608a47d4169..3cb74a9cc98 100644
--- a/doc/classes/CanvasItem.xml
+++ b/doc/classes/CanvasItem.xml
@@ -528,7 +528,7 @@
Moves this node to display on top of its siblings.
- Internally, the node is moved to the bottom of parent's children list. The method has no effect on nodes without a parent.
+ Internally, the node is moved to the bottom of parent's child list. The method has no effect on nodes without a parent.
@@ -568,7 +568,7 @@
- Allows the current node to clip children nodes, essentially acting as a mask.
+ Allows the current node to clip child nodes, essentially acting as a mask.
The rendering layers in which this [CanvasItem] responds to [Light2D] nodes.
diff --git a/doc/classes/FlowContainer.xml b/doc/classes/FlowContainer.xml
index e70e76f1918..5e767acf7db 100644
--- a/doc/classes/FlowContainer.xml
+++ b/doc/classes/FlowContainer.xml
@@ -43,10 +43,10 @@
- The horizontal separation of children nodes.
+ The horizontal separation of child nodes.
- The vertical separation of children nodes.
+ The vertical separation of child nodes.
diff --git a/doc/classes/GridContainer.xml b/doc/classes/GridContainer.xml
index cd96bd49d95..d69f4a10d27 100644
--- a/doc/classes/GridContainer.xml
+++ b/doc/classes/GridContainer.xml
@@ -18,10 +18,10 @@
- The horizontal separation of children nodes.
+ The horizontal separation of child nodes.
- The vertical separation of children nodes.
+ The vertical separation of child nodes.
diff --git a/doc/classes/Node.xml b/doc/classes/Node.xml
index 29e144e4b95..b786b679331 100644
--- a/doc/classes/Node.xml
+++ b/doc/classes/Node.xml
@@ -977,7 +977,7 @@
Set the process thread group for this node (basically, whether it receives [constant NOTIFICATION_PROCESS], [constant NOTIFICATION_PHYSICS_PROCESS], [method _process] or [method _physics_process] (and the internal versions) on the main thread or in a sub-thread.
By default, the thread group is [constant PROCESS_THREAD_GROUP_INHERIT], which means that this node belongs to the same thread group as the parent node. The thread groups means that nodes in a specific thread group will process together, separate to other thread groups (depending on [member process_thread_group_order]). If the value is set is [constant PROCESS_THREAD_GROUP_SUB_THREAD], this thread group will occur on a sub thread (not the main thread), otherwise if set to [constant PROCESS_THREAD_GROUP_MAIN_THREAD] it will process on the main thread. If there is not a parent or grandparent node set to something other than inherit, the node will belong to the [i]default thread group[/i]. This default group will process on the main thread and its group order is 0.
During processing in a sub-thread, accessing most functions in nodes outside the thread group is forbidden (and it will result in an error in debug mode). Use [method Object.call_deferred], [method call_thread_safe], [method call_deferred_thread_group] and the likes in order to communicate from the thread groups to the main thread (or to other thread groups).
- To better understand process thread groups, the idea is that any node set to any other value than [constant PROCESS_THREAD_GROUP_INHERIT] will include any children (and grandchildren) nodes set to inherit into its process thread group. this means that the processing of all the nodes in the group will happen together, at the same time as the node including them.
+ To better understand process thread groups, the idea is that any node set to any other value than [constant PROCESS_THREAD_GROUP_INHERIT] will include any child (and grandchild) nodes set to inherit into its process thread group. This means that the processing of all the nodes in the group will happen together, at the same time as the node including them.
Change the process thread group order. Groups with a lesser order will process before groups with a greater order. This is useful when a large amount of nodes process in sub thread and, afterwards, another group wants to collect their result in the main thread, as an example.
@@ -1220,13 +1220,13 @@
Never process. Completely disables processing, ignoring [member SceneTree.paused]. This is the inverse of [constant PROCESS_MODE_ALWAYS].
- If the [member process_thread_group] property is sent to this, the node will belong to any parent (or grandparent) node that has a thread group mode that is not inherit. See [member process_thread_group] for more information.
+ Process this node based on the thread group mode of the first parent (or grandparent) node that has a thread group mode that is not inherit. See [member process_thread_group] for more information.
- Process this node (and children nodes set to inherit) on the main thread. See [member process_thread_group] for more information.
+ Process this node (and child nodes set to inherit) on the main thread. See [member process_thread_group] for more information.
- Process this node (and children nodes set to inherit) on a sub-thread. See [member process_thread_group] for more information.
+ Process this node (and child nodes set to inherit) on a sub-thread. See [member process_thread_group] for more information.
Allows this node to process threaded messages created with [method call_deferred_thread_group] right before [method _process] is called.
@@ -1253,10 +1253,10 @@
The node will not be internal.
- The node will be placed at the beginning of the parent's children list, before any non-internal sibling.
+ The node will be placed at the beginning of the parent's children, before any non-internal sibling.
- The node will be placed at the end of the parent's children list, after any non-internal sibling.
+ The node will be placed at the end of the parent's children, after any non-internal sibling.
Inherits [member auto_translate_mode] from the node's parent. This is the default for any newly created node.
diff --git a/doc/classes/PackedScene.xml b/doc/classes/PackedScene.xml
index fc9ef7ddb8c..9324f995356 100644
--- a/doc/classes/PackedScene.xml
+++ b/doc/classes/PackedScene.xml
@@ -106,7 +106,7 @@
A dictionary representation of the scene contents.
- Available keys include "rnames" and "variants" for resources, "node_count", "nodes", "node_paths" for nodes, "editable_instances" for base scene children overrides, "conn_count" and "conns" for signal connections, and "version" for the format style of the PackedScene.
+ Available keys include "rnames" and "variants" for resources, "node_count", "nodes", "node_paths" for nodes, "editable_instances" for paths to overridden nodes, "conn_count" and "conns" for signal connections, and "version" for the format style of the PackedScene.
diff --git a/doc/classes/Skeleton3D.xml b/doc/classes/Skeleton3D.xml
index b6be0e92a31..31c608f3a13 100644
--- a/doc/classes/Skeleton3D.xml
+++ b/doc/classes/Skeleton3D.xml
@@ -62,7 +62,7 @@
- Returns an array containing the bone indexes of all the children node of the passed in bone, [param bone_idx].
+ Returns an array containing the bone indexes of all the child node of the passed in bone, [param bone_idx].
diff --git a/doc/classes/TabContainer.xml b/doc/classes/TabContainer.xml
index 0c1feae6e0e..a07ffe76bfa 100644
--- a/doc/classes/TabContainer.xml
+++ b/doc/classes/TabContainer.xml
@@ -209,7 +209,7 @@
If [code]true[/code], tabs are visible. If [code]false[/code], tabs' content and titles are hidden.
- If [code]true[/code], children [Control] nodes that are hidden have their minimum size take into account in the total, instead of only the currently visible one.
+ If [code]true[/code], child [Control] nodes that are hidden have their minimum size take into account in the total, instead of only the currently visible one.
diff --git a/doc/classes/Viewport.xml b/doc/classes/Viewport.xml
index 7c593fefd9b..d5dc92e16ae 100644
--- a/doc/classes/Viewport.xml
+++ b/doc/classes/Viewport.xml
@@ -4,7 +4,7 @@
Abstract base class for viewports. Encapsulates drawing and interaction with a game world.
- A Viewport creates a different view into the screen, or a sub-view inside another viewport. Children 2D Nodes will display on it, and children Camera3D 3D nodes will render on it too.
+ A [Viewport] creates a different view into the screen, or a sub-view inside another viewport. Child 2D nodes will display on it, and child Camera3D 3D nodes will render on it too.
Optionally, a viewport can have its own 2D or 3D world, so it doesn't share what it draws with other viewports.
Viewports can also choose to be audio listeners, so they generate positional audio depending on a 2D or 3D camera child of it.
Also, viewports can be assigned to different screens in case the devices have multiple screens.
diff --git a/doc/classes/Window.xml b/doc/classes/Window.xml
index 7a60c23e58a..9bb2466fc41 100644
--- a/doc/classes/Window.xml
+++ b/doc/classes/Window.xml
@@ -97,7 +97,7 @@
- Returns the combined minimum size from the child [Control] nodes of the window. Use [method child_controls_changed] to update it when children nodes have changed.
+ Returns the combined minimum size from the child [Control] nodes of the window. Use [method child_controls_changed] to update it when child nodes have changed.
The value returned by this method can be overridden with [method _get_contents_minimum_size].
diff --git a/modules/gltf/doc_classes/GLTFNode.xml b/modules/gltf/doc_classes/GLTFNode.xml
index 7f33310c0b0..4a7570e4bc5 100644
--- a/modules/gltf/doc_classes/GLTFNode.xml
+++ b/modules/gltf/doc_classes/GLTFNode.xml
@@ -35,7 +35,7 @@
If this GLTF node is a camera, the index of the [GLTFCamera] in the [GLTFState] that describes the camera's properties. If -1, this node is not a camera.
- The indices of the children nodes in the [GLTFState]. If this GLTF node has no children, this will be an empty array.
+ The indices of the child nodes in the [GLTFState]. If this GLTF node has no children, this will be an empty array.
How deep into the node hierarchy this node is. A root node will have a height of 0, its children will have a height of 1, and so on. If -1, the height has not been calculated.