[CLI] Introduce compiler argument to suppress error about API version

...greater than language version.

^KT-63712

compiler/testData/cli/js/jsExtraHelp.out

@@ -132,6 +132,9 @@ where advanced options include:
   -Xself-upper-bound-inference Support inferring type arguments from the self-type upper bounds of the corresponding type parameters.
   -Xskip-metadata-version-check Allow loading classes with bad metadata versions and pre-release classes.
   -Xskip-prerelease-check    Allow loading pre-release classes.
+  -Xsuppress-api-version-greater-than-language-version-error
+                             Suppress error about API version greater than language version.
+                             Warning: This is temporary solution (see KT-63712) intended to be used only for stdlib build.
   -Xsuppress-version-warnings Suppress warnings about outdated, inconsistent, or experimental language or API versions.
   -Xunrestricted-builder-inference
                              Eliminate builder inference restrictions, for example by allowing type variables to be returned from builder inference calls.

compiler/testData/cli/jvm/apiVersionGreaterThanLanguageSuppress.args

@@ -0,0 +1,8 @@
+$TESTDATA_DIR$/apiVersionGreaterThanLanguageSuppress.kt
+-d
+$TEMP_DIR$
+-api-version
+2.0
+-language-version
+1.9
+-Xsuppress-api-version-greater-than-language-version-error

compiler/testData/cli/jvm/apiVersionGreaterThanLanguageSuppress.kt

@@ -0,0 +1,6 @@
+@SinceKotlin("2.0")
+fun new() {}
+
+fun useNew() {
+    new()
+}

compiler/testData/cli/jvm/apiVersionGreaterThanLanguageSuppress.out

@@ -0,0 +1 @@
+OK

compiler/testData/cli/jvm/apiVersionGreaterThanLanguageSuppressUseless.args

@@ -0,0 +1,8 @@
+$TESTDATA_DIR$/apiVersionGreaterThanLanguageSuppress.kt
+-d
+$TEMP_DIR$
+-api-version
+2.0
+-language-version
+2.0
+-Xsuppress-api-version-greater-than-language-version-error

compiler/testData/cli/jvm/apiVersionGreaterThanLanguageSuppressUseless.out

@@ -0,0 +1,2 @@
+warning: useless suppress -Xsuppress-api-version-greater-than-language-version-error
+OK

compiler/testData/cli/jvm/extraHelp.out

@@ -219,6 +219,9 @@ where advanced options include:
   -Xself-upper-bound-inference Support inferring type arguments from the self-type upper bounds of the corresponding type parameters.
   -Xskip-metadata-version-check Allow loading classes with bad metadata versions and pre-release classes.
   -Xskip-prerelease-check    Allow loading pre-release classes.
+  -Xsuppress-api-version-greater-than-language-version-error
+                             Suppress error about API version greater than language version.
+                             Warning: This is temporary solution (see KT-63712) intended to be used only for stdlib build.
   -Xsuppress-version-warnings Suppress warnings about outdated, inconsistent, or experimental language or API versions.
   -Xunrestricted-builder-inference
                              Eliminate builder inference restrictions, for example by allowing type variables to be returned from builder inference calls.