Merge pull request #4756 from JetBrains/2-1-20-doc-update

feat: Kotlin 2.1.20 release

Author: danil-pavlov

data/releases.yml

@@ -1,5 +1,5 @@
 url: https://github.com/JetBrains/kotlin/releases
 
 latest:
-  version: 2.1.10
-  url: https://github.com/JetBrains/kotlin/releases/tag/v2.1.10
+  version: 2.1.20
+  url: https://github.com/JetBrains/kotlin/releases/tag/v2.1.20

docs/images/wasm/wasm-gradle-task-window.png

@@ -23,8 +23,9 @@
 		<toc-element topic="competitive-programming.md"/>
 	</toc-element>
 	<toc-element toc-title="What's new in Kotlin">
-		<toc-element toc-title="Kotlin 2.1.0" accepts-web-file-names="whatsnew.html" topic="whatsnew21.md"/>
-		<toc-element toc-title="Kotlin 2.1.20-RC3" topic="whatsnew-eap.md"/>
+		<toc-element toc-title="Kotlin 2.1.20" accepts-web-file-names="whatsnew.html" topic="whatsnew2120.md"/>
+		<toc-element toc-title="Kotlin 2.1.0" topic="whatsnew21.md"/>
+		<toc-element toc-title="Kotlin 2.1.20-RC3" topic="whatsnew-eap.md" hidden="true"/>
 		<toc-element toc-title="Earlier versions">
 			<toc-element toc-title="Kotlin 2.0.20" topic="whatsnew2020.md"/>
 			<toc-element toc-title="Kotlin 2.0.0" topic="whatsnew20.md"/>

docs/kr.tree

@@ -1,8 +1,8 @@
 [//]: # (title: Configure your build for EAP)
 
 <tldr>
-    <!-- <p>No preview versions are currently available</p> -->
-    <p>Latest Kotlin EAP release: <strong>%kotlinEapVersion%</strong></p>
+    <p>No preview versions are currently available</p>
+    <!-- <p>Latest Kotlin EAP release: <strong>%kotlinEapVersion%</strong></p> -->
     <p><a href="eap.md#build-details">Explore Kotlin EAP release details</a></p>
 </tldr>
 
@@ -152,4 +152,4 @@ In the sample Maven project definition, replace `KOTLIN-EAP-VERSION` with the ac
 
 * Report an issue to [our issue tracker, YouTrack](https://kotl.in/issue).
 * Find help in the [#eap channel in Kotlin Slack](https://app.slack.com/client/T09229ZC6/C0KLZSCHF) ([get an invite](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up)).
-* Roll back to the latest stable version: [change it in your build script file](configure-build-for-eap.md#adjust-the-kotlin-version).
+* Roll back to the latest stable version: [change it in your build script file](#adjust-the-kotlin-version).

docs/topics/configure-build-for-eap.md

@@ -1,8 +1,10 @@
 [//]: # (title: Participate in the Kotlin Early Access Preview)
 
+<!--
 <tldr>
     <p>Latest Kotlin EAP release: <strong>%kotlinEapVersion%</strong></p>
 </tldr>
+-->
 
 You can participate in the Kotlin Early Access Preview (EAP) to try out the latest Kotlin features before they are released.
 
@@ -35,8 +37,9 @@ In this channel, you can also get notifications about new EAP builds.
 
 ## Build details
 
-<!-- _No preview versions are currently available._ -->  
+_No preview versions are currently available._  
 
+<!--
 <table>
     <tr>
         <th>Build info</th>
@@ -52,4 +55,5 @@ In this channel, you can also get notifications about new EAP builds.
             <p>For more details, please refer to the <a href="https://github.com/JetBrains/kotlin/releases/tag/v2.1.20-RC3">changelog</a> or <a href="whatsnew-eap.md">What's new in Kotlin 2.1.20-RC3</a>.</p>
         </td>
     </tr>
-</table>
+</table>
+-->

docs/topics/eap.md

@@ -48,23 +48,24 @@ plugins {
 When configuring your project, check the Kotlin Gradle plugin (KGP) compatibility with available Gradle versions. 
 In the following table, there are the minimum and maximum **fully supported** versions of Gradle and Android Gradle plugin (AGP):
 
-| KGP version   | Gradle min and max versions            | AGP min and max versions                            |
-|---------------|----------------------------------------|-----------------------------------------------------|
-| 2.1.0         | %minGradleVersion%–%maxGradleVersion%* | %minAndroidGradleVersion%–%maxAndroidGradleVersion% |
-| 2.0.20–2.0.21 | 6.8.3–8.8*                             | 7.1.3–8.5                                           |
-| 2.0.0         | 6.8.3–8.5                              | 7.1.3–8.3.1                                         |
-| 1.9.20–1.9.25 | 6.8.3–8.1.1                            | 4.2.2–8.1.0                                         |
-| 1.9.0–1.9.10  | 6.8.3–7.6.0                            | 4.2.2–7.4.0                                         |
-| 1.8.20–1.8.22 | 6.8.3–7.6.0                            | 4.1.3–7.4.0                                         |      
-| 1.8.0–1.8.11  | 6.8.3–7.3.3                            | 4.1.3–7.2.1                                         |   
-| 1.7.20–1.7.22 | 6.7.1–7.1.1                            | 3.6.4–7.0.4                                         |
-| 1.7.0–1.7.10  | 6.7.1–7.0.2                            | 3.4.3–7.0.2                                         |
-| 1.6.20–1.6.21 | 6.1.1–7.0.2                            | 3.4.3–7.0.2                                         |
-
-> *Kotlin 2.0.20–2.0.21 and Kotlin 2.1.0 are fully compatible with Gradle up to 8.6.
+| KGP version   | Gradle min and max versions           | AGP min and max versions                            |
+|---------------|---------------------------------------|-----------------------------------------------------|
+| 2.1.20        | %minGradleVersion%–%maxGradleVersion% | %minAndroidGradleVersion%–%maxAndroidGradleVersion% |
+| 2.1.0–2.1.10  | 7.6.3–8.10*                           | 7.3.1–8.7.2                                         |
+| 2.0.20–2.0.21 | 6.8.3–8.8*                            | 7.1.3–8.5                                           |
+| 2.0.0         | 6.8.3–8.5                             | 7.1.3–8.3.1                                         |
+| 1.9.20–1.9.25 | 6.8.3–8.1.1                           | 4.2.2–8.1.0                                         |
+| 1.9.0–1.9.10  | 6.8.3–7.6.0                           | 4.2.2–7.4.0                                         |
+| 1.8.20–1.8.22 | 6.8.3–7.6.0                           | 4.1.3–7.4.0                                         |      
+| 1.8.0–1.8.11  | 6.8.3–7.3.3                           | 4.1.3–7.2.1                                         |   
+| 1.7.20–1.7.22 | 6.7.1–7.1.1                           | 3.6.4–7.0.4                                         |
+| 1.7.0–1.7.10  | 6.7.1–7.0.2                           | 3.4.3–7.0.2                                         |
+| 1.6.20–1.6.21 | 6.1.1–7.0.2                           | 3.4.3–7.0.2                                         |
+
+> *Kotlin 2.0.20–2.0.21 and Kotlin 2.1.0–2.1.10 are fully compatible with Gradle up to 8.6.
 > Gradle versions 8.7–8.10 are also supported, with only one exception: If you use the Kotlin Multiplatform Gradle plugin,
-> you may see deprecation warnings in your multiplatform projects calling the [`withJava()` function in the JVM target](multiplatform-dsl-reference.md#jvm-targets).
-> For more information, see the issue in [YouTrack](https://youtrack.jetbrains.com/issue/KT-66542/Gradle-JVM-target-with-withJava-produces-a-deprecation-warning).
+> you may see deprecation warnings in your multiplatform projects calling the `withJava()` function in the JVM target.
+> For more information, see [Java source sets created by default](multiplatform-compatibility-guide.md#java-source-sets-created-by-default).
 >
 {style="warning"}
 

docs/topics/gradle/gradle-configure-project.md

@@ -16,7 +16,7 @@ Currently, there are the following variants of the Kotlin Gradle plugin:
 | Variant's name | Corresponding Gradle versions |
 |----------------|-------------------------------|
 | `main`         | 7.6.0–7.6.3                   |
-| `gradle80`     | 8.0                           |
+| `gradle80`     | 8.0–8.0.2                     |
 | `gradle81`     | 8.1.1                         |
 | `gradle82`     | 8.2.1–8.4                     |
 | `gradle85`     | 8.5 and higher                |

docs/topics/gradle/gradle-plugin-variants.md

@@ -29,7 +29,7 @@
         <misc>
             <cards narrow="false">
                 <title>Featured topics</title>
-                <a href="whatsnew21.md" summary="New language features and other updates">What's new in Kotlin 2.1.0</a>
+                <a href="whatsnew2120.md" summary="New experimental features, performance improvements, and bug fixes">What's new in Kotlin 2.1.20</a>
                 <a href="releases.md" summary="The latest Kotlin releases and instructions on how to update to them">Kotlin releases</a>
                 <a href="https://kotlinlang.org/api/latest/jvm/stdlib/" summary="Living essentials for everyday work with Kotlin: IO, files, threading, collections, and much more">Standard library API reference</a>
                 <a href="basic-types.md" summary="Kotlin type system: numbers, strings, arrays, and other built-in types">Basic types</a>

docs/topics/home.topic

@@ -272,33 +272,33 @@ Once an npm dependency is installed, you can use its API in your code as describ
 
 ## run task
 
-The Kotlin Multiplatform Gradle plugin provides a `jsRun` task that lets you run pure Kotlin/JS projects without additional configuration.
+The Kotlin Multiplatform Gradle plugin provides a `jsBrowserDevelopmentRun` task that lets you run pure Kotlin/JS projects without additional configuration.
 
 For running Kotlin/JS projects in the browser, this task is an alias for the `browserDevelopmentRun` task (which is also
 available in Kotlin multiplatform projects). It uses the [webpack-dev-server](https://webpack.js.org/configuration/dev-server/)
 to serve your JavaScript artifacts.
 If you want to customize the configuration used by `webpack-dev-server`, for example, adjust the port the server runs on,
 use the [webpack configuration file](#webpack-bundling).
 
-For running Kotlin/JS projects targeting Node.js, use the `jsRun` task that is an alias for the `nodeRun` task.
+For running Kotlin/JS projects targeting Node.js, use the `jsBrowserDevelopmentRun` task that is an alias for the `nodeRun` task.
 
-To run a project, execute the standard lifecycle `jsRun` task, or the alias to which it corresponds:
+To run a project, execute the standard lifecycle `jsBrowserDevelopmentRun` task, or the alias to which it corresponds:
 
 ```bash
-./gradlew jsRun
+./gradlew jsBrowserDevelopmentRun
 ```
 
 To automatically trigger a re-build of your application after making changes to the source files, use the Gradle
 [continuous build](https://docs.gradle.org/current/userguide/command_line_interface.html#sec:continuous_build) feature:
 
 ```bash
-./gradlew jsRun --continuous
+./gradlew jsBrowserDevelopmentRun --continuous
 ```
 
 or 
 
 ```bash
-./gradlew jsRun -t
+./gradlew jsBrowserDevelopmentRun -t
 ```
 
 Once the build of your project has succeeded, the `webpack-dev-server` will automatically refresh the browser page.

docs/topics/js/js-project-setup.md

@@ -14,14 +14,14 @@ Depending on the target platform, some platform-specific extra setup might be re
 
 ## Run the Node.js target
 
-When targeting Node.js with Kotlin/JS, you can simply execute the `jsRun` Gradle task. This can be done for example via the
+When targeting Node.js with Kotlin/JS, you can simply execute the `jsBrowserDevelopmentRun` Gradle task. This can be done for example via the
 command line, using the Gradle wrapper:
 
 ```bash
-./gradlew jsRun
+./gradlew jsBrowserDevelopmentRun
 ```
 
-If you're using IntelliJ IDEA, you can find the `jsRun` action in the Gradle tool window:
+If you're using IntelliJ IDEA, you can find the `jsBrowserDevelopmentRun` action in the Gradle tool window:
 
 ![Gradle Run task in IntelliJ IDEA](run-gradle-task.png){width=700}
 
@@ -57,10 +57,10 @@ After making these adjustments, start the integrated development server. You can
 Gradle wrapper:
 
 ```bash
-./gradlew jsRun
+./gradlew jsBrowserDevelopmentRun
 ```
 
-When working from IntelliJ IDEA, you can find the `jsRun` action in the Gradle tool window.
+When working from IntelliJ IDEA, you can find the `jsBrowserDevelopmentRun` action in the Gradle tool window.
 
 After the project has been built, the embedded `webpack-dev-server` will start running, and will open a (seemingly empty)
 browser window pointing to the HTML file you specified previously. To validate that your program is running correctly,

docs/topics/js/running-kotlin-js.md

@@ -336,10 +336,10 @@ guided by pragmatic design.
 
 <!-- the first td element should have the width="200" attribute -->
 
-<tr filter="in-preview">
+<tr filter="stable">
 <td>
 
-**In preview**
+**Stable**
 
 </td>
 <td>

docs/topics/kotlin-language-features-and-proposals.md

@@ -14,27 +14,20 @@ plugins {
 }
 
 kotlin {
-    jvm {
-        withJava()
-    }
-    linuxX64() {
+    jvm()
+    linuxX64 {
         binaries {
             executable()
         }
     }
-    sourceSets {
-        val commonMain by getting
-        val linuxX64Main by getting
-        val linuxX64Test by getting
-    }
 }
 
 dependencies {
     add("kspCommonMainMetadata", project(":test-processor"))
     add("kspJvm", project(":test-processor"))
     add("kspJvmTest", project(":test-processor")) // Not doing anything because there's no test source set for JVM
     // There is no processing for the Linux x64 main source set, because kspLinuxX64 isn't specified
-    add("kspLinuxX64Test", project(":test-processor"))
+    // add("kspLinuxX64Test", project(":test-processor"))
 }
 ```
 

docs/topics/ksp/ksp-multiplatform.md

@@ -19,17 +19,16 @@ Learn more about [how to configure the Lombok compiler plugin](#using-the-lombok
 
 The plugin supports the following annotations:
 * `@Getter`, `@Setter`
-* `@Builder`
+* `@Builder`, `@SuperBuilder`
 * `@NoArgsConstructor`, `@RequiredArgsConstructor`, and `@AllArgsConstructor`
 * `@Data`
 * `@With`
 * `@Value`
 
 We're continuing to work on this plugin. To find out the detailed current state, visit the [Lombok compiler plugin's README](https://github.com/JetBrains/kotlin/tree/master/plugins/lombok).
 
-Currently, we don't have plans to support the `@SuperBuilder` and `@Tolerate` annotations. However, we can consider this if you vote
-for [@SuperBuilder](https://youtrack.jetbrains.com/issue/KT-53563/Kotlin-Lombok-Support-SuperBuilder) and 
-[@Tolerate](https://youtrack.jetbrains.com/issue/KT-53564/Kotlin-Lombok-Support-Tolerate) in YouTrack.
+Currently, we don't have plans to support the `@Tolerate` annotation. However, we can consider this if you vote
+for the [@Tolerate issue](https://youtrack.jetbrains.com/issue/KT-53564/Kotlin-Lombok-Support-Tolerate) in YouTrack.
 
 > Kotlin compiler ignores Lombok annotations if you use them in Kotlin code.
 >
@@ -45,7 +44,7 @@ Apply the `kotlin-plugin-lombok` Gradle plugin in the `build.gradle(.kts)` file:
 ```kotlin
 plugins {
     kotlin("plugin.lombok") version "%kotlinVersion%"
-    id("io.freefair.lombok") version "8.10"
+    id("io.freefair.lombok") version "%lombokVersion%"
 }
 ```
 
@@ -55,7 +54,7 @@ plugins {
 ```groovy
 plugins {
     id 'org.jetbrains.kotlin.plugin.lombok' version '%kotlinVersion%'
-    id 'io.freefair.lombok' version '8.10'
+    id 'io.freefair.lombok' version '%lombokVersion%'
 }
 ```