Increase readability of binding docs

Transforms some of the GDScript documentation markup to Rustdoc, using simple de-indentation and replacements. This makes bindings documentation, which has so far been a single huge code block, much more readable. Could be further improved using Regex and Rustdoc links.

Adds the 'unindent' crate, which has no further dependencies.

Author: Bromeon

bindings_generator/Cargo.toml

@@ -20,3 +20,4 @@ proc-macro2 = "1.0.6"
 quote = "1.0.2"
 syn = { version = "1.0", features = ["full", "extra-traits", "visit"] }
 miniserde = "=0.1.13"
+unindent = "0.1.7"

bindings_generator/src/class_docs.rs

@@ -110,18 +110,12 @@ impl GodotXMLDocs {
     }
 
     fn add_fn(&mut self, class: &str, method: &str, desc: &str, default_args: &[(&str, &str)]) {
-        let doc = desc.trim();
+        let mut doc = unindent::unindent(desc.trim());
 
         if doc.is_empty() && default_args.is_empty() {
             return;
         }
 
-        let mut doc = if !doc.is_empty() {
-            format!("```text\n{}\n```\n", doc)
-        } else {
-            String::new()
-        };
-
         if !default_args.is_empty() {
             doc.push_str("\n# Default Arguments");
 
@@ -131,6 +125,18 @@ impl GodotXMLDocs {
         }
 
         self.class_fn_desc
-            .insert((class.into(), method.into()), doc);
+            .insert((class.into(), method.into()), Self::reformat_as_rustdoc(doc));
+    }
+
+    /// Takes the Godot documentation markup and transforms it to Rustdoc.
+    /// Very basic approach with limitations, but already helps readability quite a bit.
+    fn reformat_as_rustdoc(godot_doc: String) -> String {
+        godot_doc
+            .replace("[code]", "`")
+            .replace("[/code]", "`")
+            .replace("[codeblock]", "```gdscript")
+            .replace("[/codeblock]", "```")
+            .replace("[b]", "**")
+            .replace("[/b]", "**")
     }
 }