Sort XML blocks for deterministic output; update expected XML

Author: Bromeon

godot-core/src/docs.rs

@@ -174,7 +174,11 @@ pub fn gather_xml_docs() -> impl Iterator<Item = String> {
     })
 }
 
-fn wrap_in_xml_block(tag: &str, blocks: Vec<&'static str>) -> String {
+fn wrap_in_xml_block(tag: &str, mut blocks: Vec<&'static str>) -> String {
+    // We sort the blocks for deterministic output. No need to sort individual methods/signals/constants, this is already done by Godot.
+    // See https://github.com/godot-rust/gdext/pull/1391 for more information.
+    blocks.sort();
+
     let content = String::from_iter(blocks);
 
     if content.is_empty() {

itest/rust/src/register_tests/res/registered_docs.xml

@@ -25,6 +25,22 @@ public class Player : Node2D
   </description>
 </method>
 
+<method name="secondary_but_documented">
+  <return type="()" />
+  <param index="0" name="smth" type="i64" />
+  <description>
+  Documented method in godot_api secondary block
+  </description>
+</method>
+
+<method name="tertiary_but_documented">
+  <return type="()" />
+  <param index="0" name="smth" type="i64" />
+  <description>
+  Documented method in other godot_api secondary block
+  </description>
+</method>
+
 <method name="ye">
   <return type="f32" />
 
@@ -72,22 +88,6 @@ public class Player : Node2D
   ????? probably
   </description>
 </method>
-
-<method name="secondary_but_documented">
-  <return type="()" />
-  <param index="0" name="smth" type="i64" />
-  <description>
-  Documented method in godot_api secondary block
-  </description>
-</method>
-
-<method name="tertiary_but_documented">
-  <return type="()" />
-  <param index="0" name="smth" type="i64" />
-  <description>
-  Documented method in other godot_api secondary block
-  </description>
-</method>
 </methods>
 <constants><constant name="RANDOM" value="4">Documentation.</constant><constant name="A" value="128" deprecated="Did you know that constants can be deprecated?">Hmmmm</constant><constant name="B" value="128" experimental="Did you know that constants can be experimental?">Who would know that!</constant><constant name="XML" value="1">this docstring has &lt; a special character</constant></constants>
 <signals>