Skip to content

Commit a655de8

Browse files
committed
doc: Warn about using Node internal processing
See #43689. Also 'fixed' some spelling for behavior in publicly visible strings. (Sorry en_GB, en_CA, en_AU, and more... Silicon Valley won the tech spelling war.)
1 parent 68ddab5 commit a655de8

File tree

4 files changed

+8
-6
lines changed

4 files changed

+8
-6
lines changed

doc/classes/Node.xml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -782,7 +782,8 @@
782782
<argument index="0" name="enable" type="bool">
783783
</argument>
784784
<description>
785-
Enables or disables internal physics for this node. Internal physics processing happens in isolation from the normal [method _physics_process] calls and is used by some nodes internally to guarantee proper functioning even if the node is paused or physics processing is disabled for scripting ([method set_physics_process]). Only useful for advanced uses to manipulate built-in nodes' behaviour.
785+
Enables or disables internal physics for this node. Internal physics processing happens in isolation from the normal [method _physics_process] calls and is used by some nodes internally to guarantee proper functioning even if the node is paused or physics processing is disabled for scripting ([method set_physics_process]). Only useful for advanced uses to manipulate built-in nodes' behavior.
786+
[b]Warning:[/b] Built-in Nodes rely on the internal processing for their own logic, so changing this value from your code may lead to unexpected behavior. Script access to this internal logic is provided for specific advanced uses, but is unsafe and not supported.
786787
</description>
787788
</method>
788789
<method name="set_process">
@@ -809,7 +810,8 @@
809810
<argument index="0" name="enable" type="bool">
810811
</argument>
811812
<description>
812-
Enables or disabled internal processing for this node. Internal processing happens in isolation from the normal [method _process] calls and is used by some nodes internally to guarantee proper functioning even if the node is paused or processing is disabled for scripting ([method set_process]). Only useful for advanced uses to manipulate built-in nodes' behaviour.
813+
Enables or disabled internal processing for this node. Internal processing happens in isolation from the normal [method _process] calls and is used by some nodes internally to guarantee proper functioning even if the node is paused or processing is disabled for scripting ([method set_process]). Only useful for advanced uses to manipulate built-in nodes' behavior.
814+
[b]Warning:[/b] Built-in Nodes rely on the internal processing for their own logic, so changing this value from your code may lead to unexpected behavior. Script access to this internal logic is provided for specific advanced uses, but is unsafe and not supported.
813815
</description>
814816
</method>
815817
<method name="set_process_unhandled_input">

drivers/unix/net_socket_posix.cpp

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -348,11 +348,11 @@ Error NetSocketPosix::open(Type p_sock_type, IP::Type &ip_type) {
348348
// recv/recvfrom and an ICMP reply was received from a previous send/sendto.
349349
unsigned long disable = 0;
350350
if (ioctlsocket(_sock, SIO_UDP_CONNRESET, &disable) == SOCKET_ERROR) {
351-
print_verbose("Unable to turn off UDP WSAECONNRESET behaviour on Windows");
351+
print_verbose("Unable to turn off UDP WSAECONNRESET behavior on Windows");
352352
}
353353
if (ioctlsocket(_sock, SIO_UDP_NETRESET, &disable) == SOCKET_ERROR) {
354354
// This feature seems not to be supported on wine.
355-
print_verbose("Unable to turn off UDP WSAENETRESET behaviour on Windows");
355+
print_verbose("Unable to turn off UDP WSAENETRESET behavior on Windows");
356356
}
357357
}
358358
#endif

modules/visual_script/doc_classes/VisualScriptLists.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
A Visual Script virtual class for in-graph editable nodes.
55
</brief_description>
66
<description>
7-
A Visual Script virtual class that defines the shape and the default behaviour of the nodes that have to be in-graph editable nodes.
7+
A Visual Script virtual class that defines the shape and the default behavior of the nodes that have to be in-graph editable nodes.
88
</description>
99
<tutorials>
1010
</tutorials>

scene/3d/soft_body_3d.cpp

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -725,7 +725,7 @@ void SoftBody3D::_update_cache_pin_points_datas() {
725725
w[i].spatial_attachment = Object::cast_to<Node3D>(get_node(w[i].spatial_attachment_path));
726726
}
727727
if (!w[i].spatial_attachment) {
728-
ERR_PRINT("Node3D node not defined in the pinned point, Softbody undefined behaviour!");
728+
ERR_PRINT("Node3D node not defined in the pinned point, this is undefined behavior for SoftBody3D!");
729729
}
730730
}
731731
}

0 commit comments

Comments
 (0)