J2K: convert javadoc comments to kdoc

j2k/testData/fileOrElement/docComments/deprecatedDocTag.java

@@ -0,0 +1,6 @@
+/**
+ * This is a deprecated class.
+ * @deprecated do not use
+ */
+class C {
+}

j2k/testData/fileOrElement/docComments/deprecatedDocTag.kt

@@ -0,0 +1,5 @@
+/**
+ * This is a deprecated class.
+ */
+deprecated("do not use")
+class C

j2k/testData/fileOrElement/docComments/docCommentWithParamTag.java

@@ -0,0 +1,4 @@
+/**
+ * @param T This is the <b>parameter</b> of class {@code C}
+ */
+class C<T> {}

j2k/testData/fileOrElement/docComments/docCommentWithParamTag.kt

@@ -0,0 +1,4 @@
+/**
+ * @param T This is the **parameter** of class `C`
+ */
+class C<T>

j2k/testData/fileOrElement/docComments/htmlInDocComment.java

@@ -0,0 +1,16 @@
+/**
+ * We support the following HTML styles: <b>bold</b>, <i>italic</i>, <s>strikethrough</s>, <code>code</code>
+ * <p>Paragraph tags also work.</p>
+ * HTML entities (need to remain as is in Markdown): &amp; &lt; &gt; &quot;
+ * Made by <a href="http://www.jetbrains.com">JetBrains</a>
+ * <ul>
+ *     <li>Kotlin</li>
+ *     <li>Java</li>
+ * </ul>
+ * <ol>
+ *     <li>First</li>
+ *     <li>Second</li>
+ * </ol>
+ */
+public class C {
+}

j2k/testData/fileOrElement/docComments/htmlInDocComment.kt

@@ -0,0 +1,16 @@
+/**
+ * We support the following HTML styles: **bold**, *italic*, ~~strikethrough~~, `code`
+ *
+ * Paragraph tags also work.
+ * HTML entities (need to remain as is in Markdown): & < > "
+ * Made by [JetBrains](http://www.jetbrains.com)
+ *
+ *  * Kotlin
+ *  * Java
+ *
+ *
+ *  1. First
+ *  1. Second
+ *
+ */
+public class C

j2k/testData/fileOrElement/docComments/inlineTagsInDocComment.java

@@ -0,0 +1,5 @@
+/**
+ * {@code A<B}
+ */
+public class C {
+}

j2k/testData/fileOrElement/docComments/inlineTagsInDocComment.kt

@@ -0,0 +1,4 @@
+/**
+ * `A<B`
+ */
+public class C

j2k/testData/fileOrElement/docComments/linkTag.java

@@ -0,0 +1,7 @@
+/**
+ * {@link C#foo(int)}
+ */
+class C {
+    void foo(int i) {
+    }
+}

j2k/testData/fileOrElement/docComments/linkTag.kt

@@ -0,0 +1,7 @@
+/**
+ * [C.foo]
+ */
+class C {
+    fun foo(i: Int) {
+    }
+}

j2k/testData/fileOrElement/docComments/linkTagWithLabel.java

@@ -0,0 +1,7 @@
+/**
+ * {@link C#foo(int) the best foo method ever}
+ */
+class C {
+    void foo(int i) {
+    }
+}

j2k/testData/fileOrElement/docComments/linkTagWithLabel.kt

@@ -0,0 +1,7 @@
+/**
+ * [the best foo method ever][C.foo]
+ */
+class C {
+    fun foo(i: Int) {
+    }
+}

j2k/testData/fileOrElement/docComments/onlyDeprecatedDocTag.java

@@ -0,0 +1,5 @@
+/**
+ * @deprecated do not use
+ */
+class C {
+}

j2k/testData/fileOrElement/docComments/onlyDeprecatedDocTag.kt

@@ -0,0 +1,2 @@
+deprecated("do not use")
+class C

j2k/testData/fileOrElement/docComments/seeTag.java

@@ -0,0 +1,7 @@
+/**
+ * @see C#foo(int)
+ */
+class C {
+    void foo(int i) {
+    }
+}

j2k/testData/fileOrElement/docComments/seeTag.kt

@@ -0,0 +1,7 @@
+/**
+ * @see C.foo
+ */
+class C {
+    fun foo(i: Int) {
+    }
+}