[Generator] Rename additionalDoc, put its content before annotations

generators/builtins/primitives/CharGenerator.kt

@@ -419,7 +419,7 @@ class JsCharGenerator(writer: PrintWriter) : CharGenerator(writer) {
     }
 
     override fun MethodBuilder.modifyGeneratedToString() {
-        additionalDoc = "TODO implicit usages of toString and valueOf must be covered in DCE"
+        additionalComments = "TODO implicit usages of toString and valueOf must be covered in DCE"
         annotations += "Suppress(\"JS_NAME_PROHIBITED_FOR_OVERRIDE\")"
         annotations += "JsName(\"toString\")"
         "return js(\"String\").fromCharCode(value).unsafeCast<String>()".addAsMultiLineBody()

generators/builtins/primitives/JsPrimitivesGenerator.kt

@@ -146,7 +146,7 @@ class JsPrimitivesGenerator(writer: PrintWriter) : BasePrimitivesGenerator(write
 
         if (thisKind == PrimitiveType.LONG) {
             method {
-                additionalDoc = """
+                additionalComments = """
                     This method is used by JavaScript to convert objects of type Long to primitives.
                     This is essential for the JavaScript interop.
                     JavaScript functions that expect `number` are imported in Kotlin as expecting `kotlin.Number`

generators/builtins/primitives/WasmPrimitivesGenerator.kt

@@ -120,7 +120,7 @@ class WasmPrimitivesGenerator(writer: PrintWriter) : BasePrimitivesGenerator(wri
 
     override fun MethodBuilder.modifyGeneratedUnaryOperation(thisKind: PrimitiveType) {
         if (thisKind == PrimitiveType.INT && methodName == "dec") {
-            additionalDoc = "TODO: Fix test compiler/testData/codegen/box/functions/invoke/invoke.kt with inline dec"
+            additionalComments = "TODO: Fix test compiler/testData/codegen/box/functions/invoke/invoke.kt with inline dec"
         } else {
             modifySignature { isInline = true }
         }

generators/builtins/primitives/builders.kt

@@ -40,7 +40,7 @@ internal interface PrimitiveBuilder {
 internal abstract class AnnotatedAndDocumented {
     private var doc: String? = null
     val annotations: MutableList<String> = mutableListOf()
-    var additionalDoc: String? = null
+    var additionalComments: String? = null
 
     fun appendDoc(doc: String) {
         if (this.doc == null) {
@@ -55,15 +55,15 @@ internal abstract class AnnotatedAndDocumented {
             appendLine(doc!!.printAsDoc(forceMultiLineDoc))
         }
 
-        if (annotations.isNotEmpty()) {
-            appendLine(annotations.joinToString(separator = END_LINE) { "@$it" })
-        }
-
-        if (additionalDoc != null) {
-            additionalDoc!!.lines().forEach { line ->
+        if (additionalComments != null) {
+            additionalComments!!.lines().forEach { line ->
                 appendLine("// $line")
             }
         }
+
+        if (annotations.isNotEmpty()) {
+            appendLine(annotations.joinToString(separator = END_LINE) { "@$it" })
+        }
     }
 
     private fun String.printAsDoc(forceMultiLine: Boolean = false): String {