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)
+}