Merge branch 'master' into develop

Author: qwwdfsad

CHANGES.md

@@ -1,5 +1,12 @@
 # Change log for kotlinx.coroutines
 
+## Version 1.0.0
+
+  * All Kotlin dependencies updated to 1.3 release version.
+  * Fixed potential memory leak in `HandlerDispatcher.scheduleResumeAfterDelay`, thanks @cbeyls.
+  * `yield` support for `Unconfined` and immediate dispatchers (#737).
+  * Various documentation improvements.
+
 ## Version 1.0.0-RC1
 
  * Coroutines API is updated to Kotlin 1.3.

COMPATIBILITY.md

@@ -20,6 +20,6 @@ In order to migrate `kotlinx.coroutines` to `1.0.0`, follow these steps:
 
 1. Update `kotlinx.coroutines` to `0.30.2` version.
 2. Inspect compiler warnings about deprecated API and migrate it to a proposed alternative. Most of deprecated API has a corresponding   replacement which can be applied from IDEA with quickfix.
-3. Update Kotlin version to `1.3.0` or to the latest `1.3.0-rc` and `kotlinx.coroutines` to version `0.30.2-eap13`. Then just get rid of `experimental` suffix in all imports.
+3. Update Kotlin version to `1.3.0` and `kotlinx.coroutines` to version `0.30.2-eap13`. Then just get rid of `experimental` suffix in all imports.
 4. Update `kotlinx.coroutines` to version `1.0.0` or to the corresponding release candidate of it).
 

README.md

@@ -2,10 +2,10 @@
 
 [![official JetBrains project](http://jb.gg/badges/official.svg)](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)
 [![GitHub license](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg?style=flat)](http://www.apache.org/licenses/LICENSE-2.0)
-[![Download](https://api.bintray.com/packages/kotlin/kotlinx/kotlinx.coroutines/images/download.svg?version=1.0.0-RC1) ](https://bintray.com/kotlin/kotlinx/kotlinx.coroutines/1.0.0-RC1)
+[![Download](https://api.bintray.com/packages/kotlin/kotlinx/kotlinx.coroutines/images/download.svg?version=1.0.0) ](https://bintray.com/kotlin/kotlinx/kotlinx.coroutines/1.0.0)
 
 Library support for Kotlin coroutines with [multiplatform](#multiplatform) support.
-This is a companion version for Kotlin `1.3.0-rc-146` release.
+This is a companion version for Kotlin `1.3.0` release.
 
 **NOTE**: `0.30.2` was the last release with Kotlin 1.2 and experimental coroutines.
 See [COMPATIBILITY.md](COMPATIBILITY.md) for details of migration onto the stable Kotlin 1.3 coroutines.
@@ -69,35 +69,33 @@ Add dependencies (you can also add other modules that you need):
 <dependency>
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kotlinx-coroutines-core</artifactId>
-    <version>1.0.0-RC1</version>
+    <version>1.0.0</version>
 </dependency>
 ```
 
 And make sure that you use the latest Kotlin version:
 
 ```xml
 <properties>
-    <kotlin.version>1.3.0-rc-146</kotlin.version>
+    <kotlin.version>1.3.0</kotlin.version>
 </properties>
 ```
 
-While Kotlin 1.3 is still in release candidate status, in order to depend on it you should add eap repository: `https://dl.bintray.com/kotlin/kotlin-eap`.
-
 ### Gradle
 
 Add dependencies (you can also add other modules that you need):
 
 ```groovy
 dependencies {
-    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.0.0-RC1'
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.0.0'
 }
 ```
 
 And make sure that you use the latest Kotlin version:
 
 ```groovy
 buildscript {
-    ext.kotlin_version = '1.3.0-rc-146'
+    ext.kotlin_version = '1.3.0'
 }
 ```
 
@@ -115,27 +113,19 @@ Add dependencies (you can also add other modules that you need):
 
 ```groovy
 dependencies {
-    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.0.0-RC1")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.0.0")
 }
 ```
 
 And make sure that you use the latest Kotlin version:
 
 ```groovy
 plugins {
-    kotlin("jvm") version "1.3.0-rc-146"
+    kotlin("jvm") version "1.3.0"
 }
 ```
 
 Make sure that you have either `jcenter()` or `mavenCentral()` in the list of repositories.
-For Kotlin EAP builds you also may need `kotlin-eap` repository:
-
-```
-repository {
-    jcenter()
-    maven { url "https://kotlin.bintray.com/kotlin-eap" }
-}
-```
 
 ### Multiplatform
 
@@ -151,7 +141,7 @@ Add [`kotlinx-coroutines-android`](ui/kotlinx-coroutines-android)
 module as dependency when using `kotlinx.coroutines` on Android:
 
 ```groovy
-implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.0.0-RC1'
+implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.0.0'
 ```
 This gives you access to Android [Dispatchers.Main](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-android/kotlinx.coroutines.android/kotlinx.coroutines.-dispatchers/index.html)
 coroutine dispatcher and also makes sure that in case of crashed coroutine with unhandled exception this

build.gradle

@@ -62,6 +62,7 @@ allprojects {
             google()
         }
         jcenter()
+        maven { url "https://kotlin.bintray.com/kotlin-dev" }
         maven { url "https://kotlin.bintray.com/kotlin-eap" }
         maven { url "https://kotlin.bintray.com/kotlinx" }
     }

gradle.properties

@@ -1,12 +1,12 @@
 # Kotlin
-version=1.0.0-RC1-SNAPSHOT
+version=1.0.0-SNAPSHOT
 group=org.jetbrains.kotlinx
-kotlin_version=1.3.0-rc-146
-kotlin_native_version=1.3.0-rc-146
+kotlin_version=1.3.0
+kotlin_native_version=1.3.0-rc-208
 
 # Dependencies
 junit_version=4.12
-atomicFU_version=0.11.11
+atomicFU_version=0.11.12
 html_version=0.6.8
 lincheck_version=1.9
 dokka_version=0.9.16-rdev-2-mpp-hacks

native/README.md

@@ -42,7 +42,7 @@ repositories {
 }
 
 dependencies {
-    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core-native:1.0.0-RC1'
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core-native:1.0.0'
 }
 
 sourceSets {

ui/coroutines-guide-ui.md

@@ -165,7 +165,7 @@ Add dependencies on `kotlinx-coroutines-android` module to the `dependencies { .
 `app/build.gradle` file:
 
 ```groovy
-compile "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.0.0-RC1"
+compile "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.0.0"
 ```
 
 You can clone [kotlinx.coroutines](https://github.com/Kotlin/kotlinx.coroutines) project from GitHub onto your 
@@ -556,7 +556,7 @@ suspend fun CoroutineScope.launchInIO() = launch(Dispatchers.IO) {
 Parent-child relation between jobs forms a hierarchy. A coroutine that performs some background job on behalf of
 the view and in its context can create further children coroutines. The whole tree of coroutines gets cancelled
 when the parent job is cancelled. An example of that is shown in the
-["Children of a coroutine"](../docs/coroutines-guide.md#children-of-a-coroutine) section of the guide to coroutines.
+["Children of a coroutine"](../docs/coroutine-context-and-dispatchers.md#children-of-a-coroutine) section of the guide to coroutines.
 <!--- CLEAR -->
 
 ### Blocking operations

ui/kotlinx-coroutines-android/animation-app/gradle.properties

@@ -18,6 +18,6 @@ org.gradle.jvmargs=-Xmx1536m
 
 kotlin.coroutines=enable
 
-kotlin_version=1.3.0-rc-146
-coroutines_version=1.0.0-RC1
+kotlin_version=1.3.0
+coroutines_version=1.0.0
 

ui/kotlinx-coroutines-android/example-app/gradle.properties

@@ -18,6 +18,6 @@ org.gradle.jvmargs=-Xmx1536m
 
 kotlin.coroutines=enable
 
-kotlin_version=1.3.0-rc-146
-coroutines_version=1.0.0-RC1
+kotlin_version=1.3.0
+coroutines_version=1.0.0