i18n: Sync classref translations with Weblate

(cherry picked from commit af8a02ddafd64f0195956c74c6a60bf389af278f)

1 files changed, 157 insertions, 36 deletions

diff --git a/doc/translations/gl.po b/doc/translations/gl.po
index d8e6533123..03df6b11aa 100644
--- a/doc/translations/gl.po
+++ b/doc/translations/gl.po
@@ -17846,8 +17846,7 @@ msgid ""
 "saved like any other [Resource].\n"
 "They can be used to generate a self-signed [X509Certificate] via [method "
 "Crypto.generate_self_signed_certificate] and as private key in [method "
-"StreamPeerSSL.accept_stream] along with the appropriate certificate.\n"
-"[b]Note:[/b] Not available in HTML5 exports."
+"StreamPeerSSL.accept_stream] along with the appropriate certificate."
 msgstr ""
 
 #: doc/classes/CryptoKey.xml
@@ -19238,7 +19237,7 @@ msgid ""
 "accessing the dictionary with isn't a fixed string (such as a number or "
 "variable).\n"
 "[codeblock]\n"
-"export(string, \"White\", \"Yellow\", \"Orange\") var my_color\n"
+"export(String, \"White\", \"Yellow\", \"Orange\") var my_color\n"
 "var points_dict = {\"White\": 50, \"Yellow\": 75, \"Orange\": 100}\n"
 "func _ready():\n"
 "    # We can't use dot syntax here as `my_color` is a variable.\n"
@@ -25289,7 +25288,7 @@ msgid ""
 "Checks if the two lines ([code]from_a[/code], [code]dir_a[/code]) and "
 "([code]from_b[/code], [code]dir_b[/code]) intersect. If yes, return the "
 "point of intersection as [Vector2]. If no intersection takes place, returns "
-"an empty [Variant].\n"
+"[code]null[/code].\n"
 "[b]Note:[/b] The lines are specified using direction vectors, not end points."
 msgstr ""
 
@@ -25400,8 +25399,8 @@ msgstr ""
 msgid ""
 "Checks if the two segments ([code]from_a[/code], [code]to_a[/code]) and "
 "([code]from_b[/code], [code]to_b[/code]) intersect. If yes, return the point "
-"of intersection as [Vector2]. If no intersection takes place, returns an "
-"empty [Variant]."
+"of intersection as [Vector2]. If no intersection takes place, returns "
+"[code]null[/code]."
 msgstr ""
 
 #: doc/classes/Geometry.xml
@@ -27037,8 +27036,7 @@ msgid ""
 "    var res = ctx.finish()\n"
 "    # Print the result as hex string and array.\n"
 "    printt(res.hex_encode(), Array(res))\n"
-"[/codeblock]\n"
-"[b]Note:[/b] Not available in HTML5 exports."
+"[/codeblock]"
 msgstr ""
 
 #: doc/classes/HashingContext.xml
@@ -37714,8 +37712,8 @@ msgid ""
 "will only be received by nodes with the same [NodePath], including the exact "
 "same node name. Behaviour depends on the RPC configuration for the given "
 "method, see [method rpc_config]. Methods are not exposed to RPCs by default. "
-"See also [method rset] and [method rset_config] for properties. Returns an "
-"empty [Variant].\n"
+"See also [method rset] and [method rset_config] for properties. Returns "
+"[code]null[/code].\n"
 "[b]Note:[/b] You can only safely use RPCs on clients after you received the "
 "[code]connected_to_server[/code] signal from the [SceneTree]. You also need "
 "to keep track of the connection state, either by the [SceneTree] signals "
@@ -37737,21 +37735,20 @@ msgstr ""
 #: doc/classes/Node.xml
 msgid ""
 "Sends a [method rpc] to a specific peer identified by [code]peer_id[/code] "
-"(see [method NetworkedMultiplayerPeer.set_target_peer]). Returns an empty "
-"[Variant]."
+"(see [method NetworkedMultiplayerPeer.set_target_peer]). Returns [code]null[/"
+"code]."
 msgstr ""
 
 #: doc/classes/Node.xml
 msgid ""
-"Sends a [method rpc] using an unreliable protocol. Returns an empty "
-"[Variant]."
+"Sends a [method rpc] using an unreliable protocol. Returns [code]null[/code]."
 msgstr ""
 
 #: doc/classes/Node.xml
 msgid ""
 "Sends a [method rpc] to a specific peer identified by [code]peer_id[/code] "
 "using an unreliable protocol (see [method NetworkedMultiplayerPeer."
-"set_target_peer]). Returns an empty [Variant]."
+"set_target_peer]). Returns [code]null[/code]."
 msgstr ""
 
 #: doc/classes/Node.xml
@@ -44647,7 +44644,24 @@ msgstr ""
 msgid ""
 "An array specifically designed to hold bytes. Optimized for memory usage, "
 "does not fragment the memory.\n"
-"[b]Note:[/b] This type is passed by value and not by reference."
+"[b]Note:[/b] This type is passed by value and not by reference. This means "
+"that when [i]mutating[/i] a class property of type [PoolByteArray] or "
+"mutating a [PoolByteArray] within an [Array] or [Dictionary], changes will "
+"be lost:\n"
+"[codeblock]\n"
+"var array = [PoolByteArray()]\n"
+"array[0].push_back(123)\n"
+"print(array)  # [[]] (empty PoolByteArray within an empty Array)\n"
+"[/codeblock]\n"
+"Instead, the entire [PoolByteArray] property must be [i]reassigned[/i] with "
+"[code]=[/code] for it to be changed:\n"
+"[codeblock]\n"
+"var array = [PoolByteArray()]\n"
+"var pool_array = array[0]\n"
+"pool_array.push_back(123)\n"
+"array[0] = pool_array\n"
+"print(array)  # [[123]] (PoolByteArray with 1 element inside an Array)\n"
+"[/codeblock]"
 msgstr ""
 
 #: doc/classes/PoolByteArray.xml
@@ -44777,14 +44791,32 @@ msgid ""
 msgstr ""
 
 #: doc/classes/PoolColorArray.xml
-msgid "A pooled array of [Color]."
+msgid "A pooled array of [Color]s."
 msgstr ""
 
 #: doc/classes/PoolColorArray.xml
 msgid ""
 "An array specifically designed to hold [Color]. Optimized for memory usage, "
 "does not fragment the memory.\n"
-"[b]Note:[/b] This type is passed by value and not by reference."
+"[b]Note:[/b] This type is passed by value and not by reference. This means "
+"that when [i]mutating[/i] a class property of type [PoolColorArray] or "
+"mutating a [PoolColorArray] within an [Array] or [Dictionary], changes will "
+"be lost:\n"
+"[codeblock]\n"
+"var array = [PoolColorArray()]\n"
+"array[0].push_back(Color(0.1, 0.2, 0.3, 0.4))\n"
+"print(array)  # [[]] (empty PoolColorArray within an empty Array)\n"
+"[/codeblock]\n"
+"Instead, the entire [PoolColorArray] property must be [i]reassigned[/i] with "
+"[code]=[/code] for it to be changed:\n"
+"[codeblock]\n"
+"var array = [PoolColorArray()]\n"
+"var pool_array = array[0]\n"
+"pool_array.push_back(Color(0.1, 0.2, 0.3, 0.4))\n"
+"array[0] = pool_array\n"
+"print(array)  # [[(0.1, 0.2, 0.3, 0.4)]] (PoolColorArray with 1 element "
+"inside an Array)\n"
+"[/codeblock]"
 msgstr ""
 
 #: doc/classes/PoolColorArray.xml
@@ -44821,7 +44853,24 @@ msgstr ""
 msgid ""
 "An array specifically designed to hold integer values ([int]). Optimized for "
 "memory usage, does not fragment the memory.\n"
-"[b]Note:[/b] This type is passed by value and not by reference.\n"
+"[b]Note:[/b] This type is passed by value and not by reference. This means "
+"that when [i]mutating[/i] a class property of type [PoolIntArray] or "
+"mutating a [PoolIntArray] within an [Array] or [Dictionary], changes will be "
+"lost:\n"
+"[codeblock]\n"
+"var array = [PoolIntArray()]\n"
+"array[0].push_back(1234)\n"
+"print(array)  # [[]] (empty PoolIntArray within an empty Array)\n"
+"[/codeblock]\n"
+"Instead, the entire [PoolIntArray] property must be [i]reassigned[/i] with "
+"[code]=[/code] for it to be changed:\n"
+"[codeblock]\n"
+"var array = [PoolIntArray()]\n"
+"var pool_array = array[0]\n"
+"pool_array.push_back(1234)\n"
+"array[0] = pool_array\n"
+"print(array)  # [[1234]] (PoolIntArray with 1 element inside an Array)\n"
+"[/codeblock]\n"
 "[b]Note:[/b] This type is limited to signed 32-bit integers, which means it "
 "can only take values in the interval [code][-2^31, 2^31 - 1][/code], i.e. "
 "[code][-2147483648, 2147483647][/code]. Exceeding those bounds will wrap "
@@ -44850,14 +44899,31 @@ msgid "Changes the int at the given index."
 msgstr ""
 
 #: doc/classes/PoolRealArray.xml
-msgid "A pooled array of reals ([float])."
+msgid "A pooled array of real numbers ([float])."
 msgstr ""
 
 #: doc/classes/PoolRealArray.xml
 msgid ""
 "An array specifically designed to hold floating-point values. Optimized for "
 "memory usage, does not fragment the memory.\n"
-"[b]Note:[/b] This type is passed by value and not by reference.\n"
+"[b]Note:[/b] This type is passed by value and not by reference. This means "
+"that when [i]mutating[/i] a class property of type [PoolRealArray] or "
+"mutating a [PoolRealArray] within an [Array] or [Dictionary], changes will "
+"be lost:\n"
+"[codeblock]\n"
+"var array = [PoolRealArray()]\n"
+"array[0].push_back(12.34)\n"
+"print(array)  # [[]] (empty PoolRealArray within an empty Array)\n"
+"[/codeblock]\n"
+"Instead, the entire [PoolRealArray] property must be [i]reassigned[/i] with "
+"[code]=[/code] for it to be changed:\n"
+"[codeblock]\n"
+"var array = [PoolRealArray()]\n"
+"var pool_array = array[0]\n"
+"pool_array.push_back(12.34)\n"
+"array[0] = pool_array\n"
+"print(array)  # [[12.34]] (PoolRealArray with 1 element inside an Array)\n"
+"[/codeblock]\n"
 "[b]Note:[/b] Unlike primitive [float]s which are 64-bit, numbers stored in "
 "[PoolRealArray] are 32-bit floats. This means values stored in "
 "[PoolRealArray] have lower precision compared to primitive [float]s. If you "
@@ -44882,14 +44948,31 @@ msgid "Changes the float at the given index."
 msgstr ""
 
 #: doc/classes/PoolStringArray.xml
-msgid "A pooled array of [String]."
+msgid "A pooled array of [String]s."
 msgstr ""
 
 #: doc/classes/PoolStringArray.xml
 msgid ""
 "An array specifically designed to hold [String]s. Optimized for memory "
 "usage, does not fragment the memory.\n"
-"[b]Note:[/b] This type is passed by value and not by reference."
+"[b]Note:[/b] This type is passed by value and not by reference. This means "
+"that when [i]mutating[/i] a class property of type [PoolStringArray] or "
+"mutating a [PoolStringArray] within an [Array] or [Dictionary], changes will "
+"be lost:\n"
+"[codeblock]\n"
+"var array = [PoolStringArray()]\n"
+"array[0].push_back(\"hello\")\n"
+"print(array)  # [[]] (empty PoolStringArray within an empty Array)\n"
+"[/codeblock]\n"
+"Instead, the entire [PoolStringArray] property must be [i]reassigned[/i] "
+"with [code]=[/code] for it to be changed:\n"
+"[codeblock]\n"
+"var array = [PoolStringArray()]\n"
+"var pool_array = array[0]\n"
+"pool_array.push_back(\"hello\")\n"
+"array[0] = pool_array\n"
+"print(array)  # [[hello]] (PoolStringArray with 1 element inside an Array)\n"
+"[/codeblock]"
 msgstr ""
 
 #: doc/classes/PoolStringArray.xml
@@ -44917,14 +45000,32 @@ msgid "Changes the [String] at the given index."
 msgstr ""
 
 #: doc/classes/PoolVector2Array.xml
-msgid "A pooled array of [Vector2]."
+msgid "A pooled array of [Vector2]s."
 msgstr ""
 
 #: doc/classes/PoolVector2Array.xml
 msgid ""
 "An array specifically designed to hold [Vector2]. Optimized for memory "
 "usage, does not fragment the memory.\n"
-"[b]Note:[/b] This type is passed by value and not by reference."
+"[b]Note:[/b] This type is passed by value and not by reference. This means "
+"that when [i]mutating[/i] a class property of type [PoolVector2Array] or "
+"mutating a [PoolVector2Array] within an [Array] or [Dictionary], changes "
+"will be lost:\n"
+"[codeblock]\n"
+"var array = [PoolVector2Array()]\n"
+"array[0].push_back(Vector2(12, 34))\n"
+"print(array)  # [[]] (empty PoolVector2Array within an empty Array)\n"
+"[/codeblock]\n"
+"Instead, the entire [PoolVector2Array] property must be [i]reassigned[/i] "
+"with [code]=[/code] for it to be changed:\n"
+"[codeblock]\n"
+"var array = [PoolVector2Array()]\n"
+"var pool_array = array[0]\n"
+"pool_array.push_back(Vector2(12, 34))\n"
+"array[0] = pool_array\n"
+"print(array)  # [[(12, 34)]] (PoolVector2Array with 1 element inside an "
+"Array)\n"
+"[/codeblock]"
 msgstr ""
 
 #: doc/classes/PoolVector2Array.xml doc/classes/TileMap.xml
@@ -44958,7 +45059,25 @@ msgstr ""
 msgid ""
 "An array specifically designed to hold [Vector3]. Optimized for memory "
 "usage, does not fragment the memory.\n"
-"[b]Note:[/b] This type is passed by value and not by reference."
+"[b]Note:[/b] This type is passed by value and not by reference. This means "
+"that when [i]mutating[/i] a class property of type [PoolVector3Array] or "
+"mutating a [PoolVector3Array] within an [Array] or [Dictionary], changes "
+"will be lost:\n"
+"[codeblock]\n"
+"var array = [PoolVector3Array()]\n"
+"array[0].push_back(Vector3(12, 34, 56))\n"
+"print(array)  # [[]] (empty PoolVector3Array within an empty Array)\n"
+"[/codeblock]\n"
+"Instead, the entire [PoolVector3Array] property must be [i]reassigned[/i] "
+"with [code]=[/code] for it to be changed:\n"
+"[codeblock]\n"
+"var array = [PoolVector3Array()]\n"
+"var pool_array = array[0]\n"
+"pool_array.push_back(Vector3(12, 34, 56))\n"
+"array[0] = pool_array\n"
+"print(array)  # [[(12, 34, 56)]] (PoolVector3Array with 1 element inside an "
+"Array)\n"
+"[/codeblock]"
 msgstr ""
 
 #: doc/classes/PoolVector3Array.xml
@@ -51385,7 +51504,8 @@ msgstr ""
 
 #: doc/classes/RigidBody.xml
 msgid ""
-"Damps RigidBody's rotational forces.\n"
+"Damps RigidBody's rotational forces. If this value is different from -1.0 it "
+"will be added to any linear damp derived from the world or areas.\n"
 "See [member ProjectSettings.physics/3d/default_angular_damp] for more "
 "details about damping."
 msgstr ""
@@ -51484,8 +51604,8 @@ msgstr ""
 #: doc/classes/RigidBody.xml
 msgid ""
 "The body's linear damp. Cannot be less than -1.0. If this value is different "
-"from -1.0, any linear damp derived from the world or areas will be "
-"overridden.\n"
+"from -1.0 it will be added to any linear damp derived from the world or "
+"areas.\n"
 "See [member ProjectSettings.physics/3d/default_linear_damp] for more details "
 "about damping."
 msgstr ""
@@ -51699,7 +51819,8 @@ msgstr ""
 msgid ""
 "Damps the body's [member angular_velocity]. If [code]-1[/code], the body "
 "will use the [b]Default Angular Damp[/b] defined in [b]Project > Project "
-"Settings > Physics > 2d[/b].\n"
+"Settings > Physics > 2d[/b]. If greater than [code]-1[/code] it will be "
+"added to the default project value.\n"
 "See [member ProjectSettings.physics/2d/default_angular_damp] for more "
 "details about damping."
 msgstr ""
@@ -51781,7 +51902,8 @@ msgstr ""
 msgid ""
 "Damps the body's [member linear_velocity]. If [code]-1[/code], the body will "
 "use the [b]Default Linear Damp[/b] in [b]Project > Project Settings > "
-"Physics > 2d[/b].\n"
+"Physics > 2d[/b]. If greater than [code]-1[/code] it will be added to the "
+"default project value.\n"
 "See [member ProjectSettings.physics/2d/default_linear_damp] for more details "
 "about damping."
 msgstr ""
@@ -63127,7 +63249,7 @@ msgstr ""
 msgid ""
 "Resets a tween to its initial value (the one given, not the one before the "
 "tween), given its object and property/method pair. By default, all tweens "
-"are removed, unless [code]key[/code] is specified."
+"are reset, unless [code]key[/code] is specified."
 msgstr ""
 
 #: doc/classes/Tween.xml
@@ -68744,8 +68866,8 @@ msgstr ""
 
 #: doc/classes/VisualServer.xml
 msgid ""
-"Returns the default value for the param if available. Otherwise returns an "
-"empty [Variant]."
+"Returns the default value for the param if available. Returns [code]null[/"
+"code] otherwise."
 msgstr ""
 
 #: doc/classes/VisualServer.xml
@@ -73720,8 +73842,7 @@ msgid ""
 "They can be used as the server certificate in [method StreamPeerSSL."
 "accept_stream] (along with the proper [CryptoKey]), and to specify the only "
 "certificate that should be accepted when connecting to an SSL server via "
-"[method StreamPeerSSL.connect_to_stream].\n"
-"[b]Note:[/b] Not available in HTML5 exports."
+"[method StreamPeerSSL.connect_to_stream]."
 msgstr ""
 
 #: doc/classes/X509Certificate.xml