Kapt: Keep KDoc comments in Java stubs (KT-21205)

2017-11-14 20:03:12 +09:00
parent af57ab8119
commit 37543deefa
10 changed files with 404 additions and 28 deletions
@@ -0,0 +1,45 @@
+
+/** Test. */
+class Test {
+    /** method(). */
+    fun method() {}
+
+    /** method(int). */
+    fun method(a: Int) {}
+
+    /** method(String). */
+    fun method(a: String) {}
+
+    /** prop. */
+    val prop: String = ""
+
+    /** prop2. */
+    @Anno
+    val prop2: String = ""
+
+    /** prop3. */
+    var prop3: String
+        /** get. */ get() = ""
+        /** set. */ set(v) {}
+}
+
+/**
+ * Test2
+ * Multiline
+ * documentation.
+ */
+class Test2(val a: String)
+
+class Test3 /** constructor. */ protected constructor(val a: String)
+
+/** Obj. */
+object Obj
+
+@Target(AnnotationTarget.PROPERTY)
+annotation class Anno
+
+/* simple comment. */
+class Test4 {
+    // method simple comment
+    fun method() {}
+}
@@ -0,0 +1,195 @@
+@kotlin.Metadata()
+@java.lang.annotation.Target(value = {})
+@java.lang.annotation.Retention(value = java.lang.annotation.RetentionPolicy.RUNTIME)
+@kotlin.annotation.Target(allowedTargets = {kotlin.annotation.AnnotationTarget.PROPERTY})
+@kapt.internal.KaptMetadata()
+public abstract @interface Anno {
+}
+
+////////////////////
+
+
+/**
+ * Obj.
+ */
+@kotlin.Metadata()
+@kapt.internal.KaptMetadata()
+public final class Obj {
+    public static final Obj INSTANCE = null;
+
+    @kapt.internal.KaptSignature(value = "<init>()V")
+    private Obj() {
+        super();
+    }
+}
+
+////////////////////
+
+
+/**
+ * Test.
+ */
+@kotlin.Metadata()
+@kapt.internal.KaptMetadata()
+public final class Test {
+
+    /**
+     * prop.
+     */
+    @org.jetbrains.annotations.NotNull()
+    private final java.lang.String prop = "";
+
+    /**
+     * prop2.
+     */
+    @org.jetbrains.annotations.NotNull()
+    private final java.lang.String prop2 = "";
+
+    /**
+     * method().
+     */
+    @kapt.internal.KaptSignature(value = "method()V")
+    public final void method() {
+    }
+
+    /**
+     * method(int).
+     */
+    @kapt.internal.KaptSignature(value = "method(I)V")
+    public final void method(int a) {
+    }
+
+    /**
+     * method(String).
+     */
+    @kapt.internal.KaptSignature(value = "method(Ljava/lang/String;)V")
+    public final void method(@org.jetbrains.annotations.NotNull()
+    java.lang.String a) {
+    }
+
+    @org.jetbrains.annotations.NotNull()
+    @kapt.internal.KaptSignature(value = "getProp()Ljava/lang/String;")
+    public final java.lang.String getProp() {
+        return null;
+    }
+
+    @Anno()
+    @kapt.internal.KaptSignature(value = "prop2$annotations()V")
+    public static void prop2$annotations() {
+    }
+
+    @org.jetbrains.annotations.NotNull()
+    @kapt.internal.KaptSignature(value = "getProp2()Ljava/lang/String;")
+    public final java.lang.String getProp2() {
+        return null;
+    }
+
+    /**
+     * get.
+     */
+    @org.jetbrains.annotations.NotNull()
+    @kapt.internal.KaptSignature(value = "getProp3()Ljava/lang/String;")
+    public final java.lang.String getProp3() {
+        return null;
+    }
+
+    /**
+     * set.
+     */
+    @kapt.internal.KaptSignature(value = "setProp3(Ljava/lang/String;)V")
+    public final void setProp3(@org.jetbrains.annotations.NotNull()
+    java.lang.String v) {
+    }
+
+    @kapt.internal.KaptSignature(value = "<init>()V")
+    public Test() {
+        super();
+    }
+}
+
+////////////////////
+
+
+/**
+ * * Test2
+ * * Multiline
+ * * documentation.
+ */
+@kotlin.Metadata()
+@kapt.internal.KaptMetadata()
+public final class Test2 {
+    @org.jetbrains.annotations.NotNull()
+    private final java.lang.String a = null;
+
+    @org.jetbrains.annotations.NotNull()
+    @kapt.internal.KaptSignature(value = "getA()Ljava/lang/String;")
+    public final java.lang.String getA() {
+        return null;
+    }
+
+    @kapt.internal.KaptSignature(value = "<init>(Ljava/lang/String;)V")
+    public Test2(@org.jetbrains.annotations.NotNull()
+    java.lang.String a) {
+        super();
+    }
+}
+
+////////////////////
+
+
+/**
+ * constructor.
+ */
+@kotlin.Metadata()
+@kapt.internal.KaptMetadata()
+public final class Test3 {
+    @org.jetbrains.annotations.NotNull()
+    private final java.lang.String a = null;
+
+    @org.jetbrains.annotations.NotNull()
+    @kapt.internal.KaptSignature(value = "getA()Ljava/lang/String;")
+    public final java.lang.String getA() {
+        return null;
+    }
+
+    @kapt.internal.KaptSignature(value = "<init>(Ljava/lang/String;)V")
+    protected Test3(@org.jetbrains.annotations.NotNull()
+    java.lang.String a) {
+        super();
+    }
+}
+
+////////////////////
+
+
+@kotlin.Metadata()
+@kapt.internal.KaptMetadata()
+public final class Test4 {
+
+    @kapt.internal.KaptSignature(value = "method()V")
+    public final void method() {
+    }
+
+    @kapt.internal.KaptSignature(value = "<init>()V")
+    public Test4() {
+        super();
+    }
+}
+
+////////////////////
+
+package kapt.internal;
+
+public @interface KaptMetadata {
+
+    public java.lang.String value();
+}
+
+////////////////////
+
+package kapt.internal;
+
+public @interface KaptSignature {
+
+    public java.lang.String value();
+}