[Gradle] Deprecate HasCompilerOptions

This DSL is not consistent with other DSL to configuring compiler
options.

^KT-65568 In Progress

libraries/tools/kotlin-gradle-plugin-api/src/common/kotlin/org/jetbrains/kotlin/gradle/plugin/HasCompilerOptions.kt

@@ -8,13 +8,28 @@ package org.jetbrains.kotlin.gradle.plugin
 import org.gradle.api.Action
 import org.jetbrains.kotlin.gradle.dsl.KotlinCommonCompilerOptions
 
+/**
+ * @suppress
+ */
+@Deprecated(
+    message = "Not consistent with other DSL to configure compiler options."
+)
 interface HasCompilerOptions<out CO : KotlinCommonCompilerOptions> {
+    /**
+     * @suppress
+     */
     val options: CO
 
+    /**
+     * @suppress
+     */
     fun configure(configuration: CO.() -> Unit) {
         configuration(options)
     }
 
+    /**
+     * @suppress
+     */
     fun configure(configuration: Action<@UnsafeVariance CO>) {
         configuration.execute(options)
     }

libraries/tools/kotlin-gradle-plugin-api/src/common/kotlin/org/jetbrains/kotlin/gradle/plugin/KotlinCompilation.kt

@@ -59,6 +59,7 @@ interface KotlinCompilation<out T : KotlinCommonOptionsDeprecated> : Named,
 
     val compileKotlinTaskName: String
 
+    @Suppress("DEPRECATION")
     val compilerOptions: HasCompilerOptions<*>
 
     @Deprecated(