Merge pull request #3872 from JetBrains/1-9-20-docs

feat: add Kotlin 1.9.20 release docs
JetBrains · Nov 1, 2023 · 3b06165 · 3b06165
2 parents 5f5adbf + 7eda59a
commit 3b06165
Show file tree

Hide file tree

Showing 109 changed files with 8,855 additions and 7,794 deletions.
diff --git a/.teamcity/builds/kotlinlang/buidTypes/BuildSitePages.kt b/.teamcity/builds/kotlinlang/buidTypes/BuildSitePages.kt
@@ -179,7 +179,7 @@ object BuildSitePages : BuildType({
       }
     }
 
-    artifacts(AbsoluteId("Kotlin_KotlinRelease_190_LibraryReferenceLegacyDocs")) {
+    artifacts(AbsoluteId("Kotlin_KotlinRelease_1920_LibraryReferenceLegacyDocs")) {
       buildRule = tag("publish", """
                 +:<default>
                 +:*

diff --git a/data/releases.yml b/data/releases.yml
@@ -1,6 +1,6 @@
 url: https://github.com/JetBrains/kotlin/releases
 
 latest:
-  version: 1.9.10
-  url: https://github.com/JetBrains/kotlin/releases/tag/v1.9.10
+  version: 1.9.20
+  url: https://github.com/JetBrains/kotlin/releases/tag/v1.9.20
 
diff --git a/docs/images/get-started/native-output-1.png b/docs/images/get-started/native-output-1.png
diff --git a/docs/images/get-started/native-output-2.png b/docs/images/get-started/native-output-2.png
diff --git a/docs/images/get-started/native-output-3.png b/docs/images/get-started/native-output-3.png
diff --git a/docs/images/get-started/native-run-app.png b/docs/images/get-started/native-run-app.png
diff --git a/docs/images/multiplatform-mobile/expect-actual-example.png b/docs/images/multiplatform-mobile/expect-actual-example.png
diff --git a/docs/images/multiplatform/expect-actual-gutter.png b/docs/images/multiplatform/expect-actual-gutter.png
diff --git a/docs/images/multiplatform/expect-actual.png b/docs/images/multiplatform/expect-actual.png
diff --git a/docs/images/multiplatform/multiplatform-create-project-button.png b/docs/images/multiplatform/multiplatform-create-project-button.png
diff --git a/docs/images/multiplatform/multiplatform-web-wizard.png b/docs/images/multiplatform/multiplatform-web-wizard.png
diff --git a/docs/images/multiplatform/project-structure/common-code-diagram.svg b/docs/images/multiplatform/project-structure/common-code-diagram.svg
diff --git a/docs/images/multiplatform/project-structure/compilation-jvm-diagram.svg b/docs/images/multiplatform/project-structure/compilation-jvm-diagram.svg
diff --git a/docs/images/multiplatform/project-structure/intermediate-source-sets-diagram.svg b/docs/images/multiplatform/project-structure/intermediate-source-sets-diagram.svg
diff --git a/docs/images/multiplatform/project-structure/native-executables-diagram.svg b/docs/images/multiplatform/project-structure/native-executables-diagram.svg
diff --git a/docs/images/multiplatform/project-structure/specific-target-diagram.svg b/docs/images/multiplatform/project-structure/specific-target-diagram.svg
diff --git a/docs/images/multiplatform/project-structure/src-directory-diagram.png b/docs/images/multiplatform/project-structure/src-directory-diagram.png
diff --git a/docs/images/multiplatform/project-structure/target-diagram.svg b/docs/images/multiplatform/project-structure/target-diagram.svg
diff --git a/docs/images/multiplatform/project-structure/target-labels-diagram.svg b/docs/images/multiplatform/project-structure/target-labels-diagram.svg
diff --git a/docs/images/multiplatform/project-structure/unresolved-java-reference.png b/docs/images/multiplatform/project-structure/unresolved-java-reference.png
diff --git a/...ls/multiplatform/expect-actual-gutter.png → ...ultiplatform/expect-actual-gutter-sql.png b/...ls/multiplatform/expect-actual-gutter.png → ...ultiplatform/expect-actual-gutter-sql.png
diff --git a/docs/images/tutorials/native/cinterop/native-project-structure.png b/docs/images/tutorials/native/cinterop/native-project-structure.png
diff --git a/docs/kr.tree b/docs/kr.tree
@@ -33,8 +33,9 @@
     </toc-element>
 
     <toc-element toc-title="What's new in Kotlin">
-        <toc-element id="whatsnew19.md" toc-title="Kotlin 1.9.0" accepts-web-file-names="whatsnew.html"/>
-        <toc-element id="whatsnew-eap.md" toc-title="Kotlin 1.9.20-RC2"/>
+        <toc-element id="whatsnew1920.md" toc-title="Kotlin 1.9.20" accepts-web-file-names="whatsnew.html"/>
+        <toc-element id="whatsnew19.md" toc-title="Kotlin 1.9.0"/>
+        <toc-element id="whatsnew-eap.md" toc-title="Kotlin 1.9.20-RC2" hidden="true"/>
         <toc-element toc-title="Earlier versions">
             <toc-element id="whatsnew1820.md" toc-title="Kotlin 1.8.20"/>
             <toc-element id="whatsnew18.md" toc-title="Kotlin 1.8.0"/>
@@ -125,52 +126,32 @@
     </toc-element>
 
     <toc-element toc-title="Multiplatform development">
-        <toc-element toc-title="Kotlin Multiplatform for iOS and Android">
-            <toc-element id="multiplatform-mobile-getting-started.md" accepts-web-file-names="kmm-getting-started.html"/>
-            <toc-element id="multiplatform-mobile-setup.md" accepts-web-file-names="kmm-setup.html" toc-title="1. Set up an environment"/>
-            <toc-element id="multiplatform-mobile-create-first-app.md" accepts-web-file-names="kmm-create-first-app.html" toc-title="2. Create your first cross-platform app"/>
-            <toc-element id="multiplatform-mobile-update-ui.md" toc-title="3. Update UI"/>
-            <toc-element id="multiplatform-mobile-dependencies.md" toc-title="4. Add dependencies"/>
-            <toc-element id="multiplatform-mobile-upgrade-app.md" toc-title="5. Share more logic"/>
-            <toc-element id="multiplatform-mobile-wrap-up.md" toc-title="6. Wrap up your project"/>
-            <toc-element id="multiplatform-mobile-understand-project-structure.md" accepts-web-file-names="kmm-understand-project-structure.html"/>
-            <toc-element id="multiplatform-mobile-integrate-in-existing-app.md" accepts-web-file-names="kmm-integrate-in-existing-app.html"/>
-            <toc-element id="multiplatform-mobile-publish-apps.md" accepts-web-file-names="kmm-publish-apps.html"/>
-            <toc-element id="multiplatform-mobile-ktor-sqldelight.md"/>
-        </toc-element>
-        <toc-element toc-title="Kotlin Multiplatform for other platforms">
-            <toc-element id="multiplatform-get-started.md" accepts-web-file-names="building-mpp-with-gradle.html,intro-to-kotlin-mpp.html,mpp-intro.html,mpp-get-started.html,multiplatform-tutorials.html"/>
-            <toc-element id="multiplatform-discover-project.md" accepts-web-file-names="mpp-discover-project.html"/>
-            <toc-element id="multiplatform-set-up-targets.md" toc-title="Set up targets manually" accepts-web-file-names="mpp-set-up-targets.html"/>
-            <toc-element id="multiplatform-full-stack-app.md" hidden="true"/>
-        </toc-element>
-        <toc-element toc-title="Creating multiplatform libraries">
-            <toc-element id="multiplatform-library.md" accepts-web-file-names="working-with-klib.html,multiplatform-create-lib.html,mpp-create-lib.html"/>
-            <toc-element id="multiplatform-publish-lib.md" accepts-web-file-names="mpp-publish-lib.html"/>
-        </toc-element>
-        <toc-element toc-title="Sharing code principles">
+        <toc-element id="multiplatform-get-started.md" accepts-web-file-names="building-mpp-with-gradle.html,intro-to-kotlin-mpp.html,mpp-intro.html,mpp-get-started.html,multiplatform-tutorials.html"/>
+        <toc-element id="multiplatform-discover-project.md" accepts-web-file-names="mpp-discover-project.html" toc-title="Understand project structure"/>
+        <toc-element id="multiplatform-set-up-targets.md" toc-title="Set up targets" accepts-web-file-names="mpp-set-up-targets.html"/>
+        <toc-element toc-title="Share code">
             <toc-element id="multiplatform-share-on-platforms.md" accepts-web-file-names="mpp-share-on-platforms.html"/>
-            <toc-element id="multiplatform-connect-to-apis.md" accepts-web-file-names="platform-specific-declarations.html,mpp-connect-to-apis.html,kmm-connect-to-platform-specific-apis.html,multiplatform-mobile-connect-to-platform-specific-apis.html"/>
+            <toc-element id="multiplatform-expect-actual.md"/>
             <toc-element id="multiplatform-hierarchy.md" accepts-web-file-names="migrating-multiplatform-project-to-14.html"/>
-            <toc-element id="multiplatform-android-layout.md"/>
         </toc-element>
-        <toc-element toc-title="Adding dependencies">
+        <toc-element toc-title="Add dependencies">
             <toc-element id="multiplatform-add-dependencies.md" toc-title="On multiplatform libraries" accepts-web-file-names="mpp-add-dependencies.html"/>
             <toc-element id="multiplatform-mobile-android-dependencies.md" accepts-web-file-names="kmm-add-dependencies.html,multiplatform-mobile-add-dependencies.html" toc-title="For Android target platforms"/>
             <toc-element id="multiplatform-mobile-ios-dependencies.md" toc-title="For iOS target platforms"/>
         </toc-element>
-        <toc-element id="multiplatform-run-tests.md" toc-title="Running tests" accepts-web-file-names="mpp-run-tests.html"/>
-        <toc-element toc-title="Artifact compilation">
+        <toc-element toc-title="Compile artifacts">
             <toc-element id="multiplatform-configure-compilations.md" accepts-web-file-names="mpp-configure-compilations.html"/>
             <toc-element toc-title="[Experimental DSL] Build final native binaries" id="multiplatform-native-artifacts.md" hidden="true"/>
             <toc-element id="multiplatform-build-native-binaries.md" accepts-web-file-names="mpp-build-native-binaries.html"/>
         </toc-element>
-        <toc-element id="multiplatform-dsl-reference.md" accepts-web-file-names="mpp-dsl-reference.html,mpp-supported-platforms.html,multiplatform-supported-platforms.html"/>
-        <toc-element id="multiplatform-mobile-samples.md" toc-title="Samples" accepts-web-file-names="kmm-samples.html"/>
-        <toc-element id="multiplatform-mobile-faq.md" accepts-web-file-names="kmm-faq.html" toc-title="FAQ"/>
+        <toc-element id="multiplatform-publish-lib.md" accepts-web-file-names="mpp-publish-lib.html" toc-title="Publish libraries"/>
         <toc-element id="multiplatform-mobile-introduce-your-team.md" accepts-web-file-names="kmm-introduce-your-team.html"/>
-        <toc-element id="multiplatform-compatibility-guide.md" toc-title="Compatibility guide"/>
-        <toc-element id="multiplatform-mobile-plugin-releases.md" accepts-web-file-names="kmm-plugin-releases.html"/>
+        <toc-element toc-title="Reference">
+            <toc-element id="multiplatform-dsl-reference.md" accepts-web-file-names="mpp-dsl-reference.html,mpp-supported-platforms.html,multiplatform-supported-platforms.html"/>
+            <toc-element id="multiplatform-android-layout.md"/>
+            <toc-element id="multiplatform-compatibility-guide.md" toc-title="Compatibility guide"/>
+            <toc-element id="multiplatform-mobile-plugin-releases.md" accepts-web-file-names="kmm-plugin-releases.html"/>
+        </toc-element>
     </toc-element>
 
     <toc-element toc-title="Platforms">
@@ -234,12 +215,6 @@
                 <toc-element id="native-memory-manager.md"/>
                 <toc-element id="native-ios-integration.md"/>
                 <toc-element id="native-migration-guide.md" toc-title="Migration guide"/>
-                <toc-element toc-title="Legacy memory manager">
-                    <toc-element id="native-immutability.md" toc-title="Immutability and concurrency" accepts-web-file-names="native-concurrency.html"/>
-                    <toc-element id="multiplatform-mobile-concurrency-overview.md" accepts-web-file-names="kmm-concurrency-overview.html"/>
-                    <toc-element id="multiplatform-mobile-concurrent-mutability.md" accepts-web-file-names="kmm-concurrent-mutability.html"/>
-                    <toc-element id="multiplatform-mobile-concurrency-and-coroutines.md" accepts-web-file-names="kmm-concurrency-and-coroutines.html"/>
-                </toc-element>
             </toc-element>
             <toc-element id="native-debugging.md"/>
             <toc-element id="native-ios-symbolication.md"/>

diff --git a/docs/topics/android-overview.md b/docs/topics/android-overview.md
@@ -35,4 +35,4 @@ on [the Google website for Android developers](https://developer.android.com/kot
 To start using Kotlin for:
 
 * Android development, read [Google's documentation for developing Android apps with Kotlin](https://developer.android.com/kotlin/get-started).
-* Developing cross-platform mobile applications, see [Get started with Kotlin Multiplatform for Android and iOS](multiplatform-mobile-getting-started.md).
+* Developing cross-platform mobile applications, see [Get started with Kotlin Multiplatform for Android and iOS](https://www.jetbrains.com/help/kotlin-multiplatform-dev/multiplatform-getting-started.html).
diff --git a/docs/topics/compiler-reference.md b/docs/topics/compiler-reference.md
@@ -162,15 +162,15 @@ Use a custom JDK home directory to include into the classpath if it differs from
 
 Specify the target version of the generated JVM bytecode. Limit the API of the JDK in the classpath to the specified Java version. 
 Automatically sets [`-jvm-target version`](#jvm-target-version).
-Possible values are `1.8`, `9`, `10`, ..., `20`. The default value is `%defaultJvmTargetVersion%`.
+Possible values are `1.8`, `9`, `10`, ..., `21`. The default value is `%defaultJvmTargetVersion%`.
 
 > This option is [not guaranteed](https://youtrack.jetbrains.com/issue/KT-29974) to be effective for each JDK distribution.
 >
 {type="note"}
 
 ### -jvm-target _version_
 
-Specify the target version of the generated JVM bytecode. Possible values are `1.8`, `9`, `10`, ..., `20`.
+Specify the target version of the generated JVM bytecode. Possible values are `1.8`, `9`, `10`, ..., `21`.
 The default value is `%defaultJvmTargetVersion%`.
 
 ### -java-parameters
@@ -291,10 +291,6 @@ Enable emitting debug information.
 
 Produce an application for running unit tests from the project.
 
-### -generate-worker-test-runner (-trw)
-
-Produce an application for running unit tests in a [worker thread](native-immutability.md#concurrency-in-kotlin-native).
-
 ### -generate-no-exit-test-runner (-trn)
 
 Produce an application for running unit tests without an explicit process exit.