From 50a240916a397c588ef307eb7335beec7b5dcad6 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" (cherry picked from commit 9b5cd8e2400ac305b3e47229a8981327c22823f0) --- 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 6f4dc47fb94..076c637ac6f 100644 --- a/doc/classes/CanvasItem.xml +++ b/doc/classes/CanvasItem.xml @@ -522,7 +522,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. @@ -562,7 +562,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 14e84b40e63..62fa213d2bf 100644 --- a/doc/classes/FlowContainer.xml +++ b/doc/classes/FlowContainer.xml @@ -39,10 +39,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 d660b94ef9d..58f46310e0b 100644 --- a/doc/classes/Node.xml +++ b/doc/classes/Node.xml @@ -933,7 +933,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. @@ -1170,13 +1170,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. @@ -1200,10 +1200,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. diff --git a/doc/classes/PackedScene.xml b/doc/classes/PackedScene.xml index a8cfc288f34..6101b640f40 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 2a629abc0db..f014f0dad2f 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 b3a92645690..aba50b9c8c3 100644 --- a/doc/classes/TabContainer.xml +++ b/doc/classes/TabContainer.xml @@ -201,7 +201,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 b6a407e0421..58c5fe0c54b 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 5f6b1960b78..243c246fd7d 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 184ced43123..6aae34332bc 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.