diff --git a/docs/topics/compatibility-guides/compatibility-guide-20.md b/docs/topics/compatibility-guides/compatibility-guide-20.md index b7eb4105d44..8c6a5de557f 100644 --- a/docs/topics/compatibility-guides/compatibility-guide-20.md +++ b/docs/topics/compatibility-guides/compatibility-guide-20.md @@ -688,4 +688,21 @@ perspective > **Deprecation cycle**: > > - 1.3: the platform plugin IDs are deprecated -> - 2.0.0: the platform plugin IDs are no longer supported \ No newline at end of file +> - 2.0.0: the platform plugin IDs are no longer supported + +### Remove outputFile JavaScript compiler option + +> **Issue**: [KT-61116](https://youtrack.jetbrains.com/issue/KT-61116) +> +> **Component**: Gradle +> +> **Incompatible change type**: source +> +> **Short summary**: The `outputFile` JavaScript compiler option has been removed. Instead, you can use the `destinationDirectory` +> property of the `Kotlin2JsCompile` task to specify the directory where the compiled JavaScript output files +> are written. +> +> **Deprecation cycle**: +> +> - 1.9.25: the `outputFile` compiler option is deprecated +> - 2.0.0: the `outputFile` compiler option is removed \ No newline at end of file diff --git a/docs/topics/gradle/gradle-compiler-options.md b/docs/topics/gradle/gradle-compiler-options.md index 4935a9c7973..4d181dc50dd 100644 --- a/docs/topics/gradle/gradle-compiler-options.md +++ b/docs/topics/gradle/gradle-compiler-options.md @@ -192,6 +192,9 @@ Note that with the Gradle Kotlin DSL, you should get the task from the project's Use the `Kotlin2JsCompile` and `KotlinCompileCommon` types for JS and common targets, respectively. +You can see the list of JavaScript compilation tasks by running the `gradlew tasks --all` command in the terminal +and searching for `compile*KotlinJS` task names in the `Other tasks` group. + ## All Kotlin compilation tasks It is also possible to configure all the Kotlin compilation tasks in the project: @@ -367,7 +370,6 @@ Also, see [Types for compiler options](#types-for-compiler-options). | `main` | Define whether the `main` function should be called upon execution | "call", "noCall". Also, see [Types for compiler options](#types-for-compiler-options) | "call" | | `metaInfo` | Generate .meta.js and .kjsm files with metadata. Use to create a library | | true | | `moduleKind` | The kind of JS module generated by the compiler | "umd", "commonjs", "amd", "plain", "es". Also, see [Types for compiler options](#types-for-compiler-options) | "umd" | -| `outputFile` | Destination *.js file for the compilation result | | "<buildDir>/js/packages//kotlin/.js" | | `sourceMap` | Generate source map | | true | | `sourceMapEmbedSources` | Embed source files into the source map | "never", "always", "inlining". Also, see [Types for compiler options](#types-for-compiler-options) | | | `sourceMapNamesPolicy` | Add variable and function names that you declared in Kotlin code into the source map. For more information on the behavior, see our [compiler reference](compiler-reference.md#source-map-names-policy-simple-names-fully-qualified-names-no). | "simple-names", "fully-qualified-names", "no". Also, see [Types for compiler options](#types-for-compiler-options) | "simple-names" |