Improve embedded document for dlang codegen (#630)

Author: tom-tan

schema_salad/dlang_codegen.py

@@ -35,18 +35,30 @@ def __init__(
 
     def prologue(self) -> None:
         """Trigger to generate the prolouge code."""
-        self.target.write(
-            f"""/**
- * Generated by schema-salad code generator
- *
- * Date: {datetime.date.today().isoformat()}
-"""
-        )
+
+        module_comment = []
+
+        if self.parser_info:
+            module_comment.append(self.parser_info + "\n")
+
+        module_comment += [
+            "This module was generated using schema-salad code generator.",
+            "",
+            "The embedded document is subject to the license of the original schema.",
+        ]
+
         if self.copyright:
-            self.target.write(f" * Copyright: {self.copyright}\n")
+            module_comment.append(f"The original schema is {self.copyright}.")
+
+        module_comment += [
+            "",
+            "License: Apache-2.0",
+            f"Date: {datetime.date.today().isoformat()}",
+        ]
+
+        self.target.write(self.to_doc_comment(module_comment))
         self.target.write(
-            f""" */
-module {self.package};
+            f"""module {self.package};
 
 import salad.meta.dumper : genDumper;
 import salad.meta.impl : genCtor, genIdentifier, genOpEq;
@@ -121,7 +133,15 @@ def to_doc_comment(self, doc: Union[None, str, List[str]]) -> str:
         else:
             lines = sum((d.split("\n") for d in doc), [])
 
-        doc_lines = "\n".join((f" * {line}" for line in lines if line))
+        if not lines[-1]:
+            lines = lines[0:-1]
+
+        lines = [
+            line.replace("`(`", "`$(LPAREN)`").replace("`)`", "`$(RPAREN)`")
+            for line in lines
+        ]
+
+        doc_lines = "\n".join((f" * {line}" for line in lines))
 
         return f"""/**
 {doc_lines}
@@ -248,11 +268,12 @@ def parse_enum(self, stype: Dict[str, Any]) -> str:
             return "\n///\npublic import salad.primitives : Expression;"
 
         classname = self.safe_name(name)
-        syms = [
-            f'        s{i} = "{shortname(sym)}"'
-            for i, sym in enumerate(stype["symbols"])
-        ]
-        syms_def = ",\n".join(syms)
+        syms = "\n".join(
+            (
+                f'        s{i} = "{shortname(sym)}", ///'
+                for i, sym in enumerate(stype["symbols"])
+            )
+        )
 
         if stype.get("documentRoot", False):
             doc_root_annotation = "@documentRoot "
@@ -268,9 +289,10 @@ def parse_enum(self, stype: Dict[str, Any]) -> str:
         return f"""
 {doc_comment}{doc_root_annotation}class {classname} : SchemaBase
 {{
+    ///
     enum Symbol
     {{
-{syms_def}
+{syms}
     }}
 
     Symbol value;