Mapping of JavaDoc deprecated to Kotlin Deprecated + a pair of tests

compiler/testData/diagnostics/tests/deprecated/javaDocDeprecated.kt

@@ -0,0 +1,20 @@
+// !DIAGNOSTICS: -NO_VALUE_FOR_PARAMETER
+// FILE: A.java
+
+/**
+ * @deprecated
+ */
+public class A {
+    /**
+     * @deprecated
+     */
+    public String getFoo(String text) {
+        return text;
+    }
+}
+
+// FILE: B.kt
+
+class B(private val foo: String) : <!DEPRECATED_SYMBOL_WITH_MESSAGE!>A<!>() {
+    override fun getFoo(text: String): String = super.<!DEPRECATED_SYMBOL_WITH_MESSAGE!>getFoo<!>(text + foo)
+}

compiler/testData/diagnostics/tests/deprecated/javaDocDeprecated.txt

@@ -0,0 +1,18 @@
+package
+
+kotlin.deprecated(value = "Deprecated in Java") public open class A {
+    public constructor A()
+    public open override /*1*/ /*fake_override*/ fun equals(/*0*/ other: kotlin.Any?): kotlin.Boolean
+    kotlin.deprecated(value = "Deprecated in Java") public open fun getFoo(/*0*/ text: kotlin.String!): kotlin.String!
+    public open override /*1*/ /*fake_override*/ fun hashCode(): kotlin.Int
+    public open override /*1*/ /*fake_override*/ fun toString(): kotlin.String
+}
+
+internal final class B : A {
+    public constructor B(/*0*/ foo: kotlin.String)
+    private final val foo: kotlin.String
+    public open override /*1*/ /*fake_override*/ fun equals(/*0*/ other: kotlin.Any?): kotlin.Boolean
+    public open override /*1*/ fun getFoo(/*0*/ text: kotlin.String): kotlin.String
+    public open override /*1*/ /*fake_override*/ fun hashCode(): kotlin.Int
+    public open override /*1*/ /*fake_override*/ fun toString(): kotlin.String
+}