feat: updated engine version to 4.4-rc1

engine/doc/classes/EditorTranslationParserPlugin.xml

@@ -5,8 +5,7 @@
 	</brief_description>
 	<description>
 		[EditorTranslationParserPlugin] is invoked when a file is being parsed to extract strings that require translation. To define the parsing and string extraction logic, override the [method _parse_file] method in script.
-		Add the extracted strings to argument [code]msgids[/code] or [code]msgids_context_plural[/code] if context or plural is used.
-		When adding to [code]msgids_context_plural[/code], you must add the data using the format [code]["A", "B", "C"][/code], where [code]A[/code] represents the extracted string, [code]B[/code] represents the context, and [code]C[/code] represents the plural version of the extracted string. If you want to add only context but not plural, put [code]""[/code] for the plural slot. The idea is the same if you only want to add plural but not context. See the code below for concrete examples.
+		The return value should be an [Array] of [PackedStringArray]s, one for each extracted translatable string. Each entry should contain [code][msgid, msgctxt, msgid_plural, comment][/code], where all except [code]msgid[/code] are optional. Empty strings will be ignored.
 		The extracted strings will be written into a POT file selected by user under "POT Generation" in "Localization" tab in "Project Settings" menu.
 		Below shows an example of a custom parser that extracts strings from a CSV file to write into a POT.
 		[codeblocks]
@@ -14,14 +13,17 @@
 		@tool
 		extends EditorTranslationParserPlugin
 
-		func _parse_file(path, msgids, msgids_context_plural):
+		func _parse_file(path):
+		    var ret: Array[PackedStringArray] = []
 		    var file = FileAccess.open(path, FileAccess.READ)
 		    var text = file.get_as_text()
 		    var split_strs = text.split(",", false)
 		    for s in split_strs:
-		        msgids.append(s)
+		        msgids.append(PackedStringArray([s]))
 		        #print("Extracted string: " + s)
 
+		    return ret
+
 		func _get_recognized_extensions():
 		    return ["csv"]
 		[/gdscript]
@@ -31,49 +33,50 @@
 		[Tool]
 		public partial class CustomParser : EditorTranslationParserPlugin
 		{
-		    public override void _ParseFile(string path, Godot.Collections.Array&lt;string&gt; msgids, Godot.Collections.Array&lt;Godot.Collections.Array&gt; msgidsContextPlural)
+		    public override Godot.Collections.Array&lt;string[]&gt; _ParseFile(string path)
 		    {
+		        Godot.Collections.Array&lt;string[]&gt; ret;
 		        using var file = FileAccess.Open(path, FileAccess.ModeFlags.Read);
 		        string text = file.GetAsText();
 		        string[] splitStrs = text.Split(",", allowEmpty: false);
 		        foreach (string s in splitStrs)
 		        {
-		            msgids.Add(s);
+		            ret.Add([s]);
 		            //GD.Print($"Extracted string: {s}");
 		        }
+		        return ret;
 		    }
 
 		    public override string[] _GetRecognizedExtensions()
 		    {
-		        return new string[] { "csv" };
+		        return ["csv"];
 		    }
 		}
 		[/csharp]
 		[/codeblocks]
-		To add a translatable string associated with context or plural, add it to [code]msgids_context_plural[/code]:
+		To add a translatable string associated with a context, plural, or comment:
 		[codeblocks]
 		[gdscript]
-		# This will add a message with msgid "Test 1", msgctxt "context", and msgid_plural "test 1 plurals".
-		msgids_context_plural.append(["Test 1", "context", "test 1 plurals"])
+		# This will add a message with msgid "Test 1", msgctxt "context", msgid_plural "test 1 plurals", and comment "test 1 comment".
+		ret.append(PackedStringArray(["Test 1", "context", "test 1 plurals", "test 1 comment"]))
 		# This will add a message with msgid "A test without context" and msgid_plural "plurals".
-		msgids_context_plural.append(["A test without context", "", "plurals"])
+		ret.append(PackedStringArray(["A test without context", "", "plurals"]))
 		# This will add a message with msgid "Only with context" and msgctxt "a friendly context".
-		msgids_context_plural.append(["Only with context", "a friendly context", ""])
+		ret.append(PackedStringArray(["Only with context", "a friendly context"]))
 		[/gdscript]
 		[csharp]
-		// This will add a message with msgid "Test 1", msgctxt "context", and msgid_plural "test 1 plurals".
-		msgidsContextPlural.Add(new Godot.Collections.Array{"Test 1", "context", "test 1 Plurals"});
+		// This will add a message with msgid "Test 1", msgctxt "context", msgid_plural "test 1 plurals", and comment "test 1 comment".
+		ret.Add(["Test 1", "context", "test 1 plurals", "test 1 comment"]);
 		// This will add a message with msgid "A test without context" and msgid_plural "plurals".
-		msgidsContextPlural.Add(new Godot.Collections.Array{"A test without context", "", "plurals"});
+		ret.Add(["A test without context", "", "plurals"]);
 		// This will add a message with msgid "Only with context" and msgctxt "a friendly context".
-		msgidsContextPlural.Add(new Godot.Collections.Array{"Only with context", "a friendly context", ""});
+		ret.Add(["Only with context", "a friendly context"]);
 		[/csharp]
 		[/codeblocks]
-		[b]Note:[/b] If you override parsing logic for standard script types (GDScript, C#, etc.), it would be better to load the [code]path[/code] argument using [method ResourceLoader.load]. This is because built-in scripts are loaded as [Resource] type, not [FileAccess] type.
-		For example:
+		[b]Note:[/b] If you override parsing logic for standard script types (GDScript, C#, etc.), it would be better to load the [code]path[/code] argument using [method ResourceLoader.load]. This is because built-in scripts are loaded as [Resource] type, not [FileAccess] type. For example:
 		[codeblocks]
 		[gdscript]
-		func _parse_file(path, msgids, msgids_context_plural):
+		func _parse_file(path):
 		    var res = ResourceLoader.load(path, "Script")
 		    var text = res.source_code
 		    # Parsing logic.
@@ -82,7 +85,7 @@
 		    return ["gd"]
 		[/gdscript]
 		[csharp]
-		public override void _ParseFile(string path, Godot.Collections.Array&lt;string&gt; msgids, Godot.Collections.Array&lt;Godot.Collections.Array&gt; msgidsContextPlural)
+		public override Godot.Collections.Array&lt;string[]&gt; _ParseFile(string path)
 		{
 		    var res = ResourceLoader.Load&lt;Script&gt;(path, "Script");
 		    string text = res.SourceCode;
@@ -91,7 +94,7 @@
 
 		public override string[] _GetRecognizedExtensions()
 		{
-		    return new string[] { "gd" };
+		    return ["gd"];
 		}
 		[/csharp]
 		[/codeblocks]
@@ -107,10 +110,8 @@
 			</description>
 		</method>
 		<method name="_parse_file" qualifiers="virtual">
-			<return type="void" />
+			<return type="PackedStringArray[]" />
 			<param index="0" name="path" type="String" />
-			<param index="1" name="msgids" type="String[]" />
-			<param index="2" name="msgids_context_plural" type="Array[]" />
 			<description>
 				Override this method to define a custom parsing logic to extract the translatable strings.
 			</description>