Version 0.8-beta

Author: elizarov

CHANGES.md

@@ -1,5 +1,21 @@
 # Change log for kotlinx.coroutines 
 
+## Version 0.8-beta
+
+* `defer` coroutine builder is renamed to `async`.
+* `lazyDefer` is deprecated, `async` has an optional `start` parameter instead.
+* `LazyDeferred` interface is deprecated, lazy start functionality is integrated into `Job` interface.
+* `launch` has an optional `start` parameter for lazily started coroutines.
+* `Job.start` and `Job.isCompleted` are introduced.
+* `Deferred.isCompletedExceptionally` and `Deferred.isCancelled` are introduced.
+* `Job.getInactiveCancellationException` is renamed to `getCompletionException`.
+* `Job.join` is now a member function.
+* Internal `JobSupport` state machine is enhanced to support _new_ (not-started-yet) state.
+  So, lazy coroutines do not need a separate state variable to track their started/not-started (new/active) status.
+* Exception transparency in `Job.cancel` (original cause is rethrown).
+* Clarified possible states for `Job`/`CancellableContinuation`/`Deferred` in docs.
+* Example on async-style functions and links to API reference site from [coroutines guide](coroutines-guide.md).
+
 ## Version 0.7-beta
 
 * Buffered and unbuffered channels are introduced: `Channel`, `SendChannel`, and `ReceiveChannel` interfaces,

README.md

@@ -49,7 +49,7 @@ Add dependencies (you can also add other modules that you need):
 <dependency>
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kotlinx-coroutines-core</artifactId>
-    <version>0.7-beta</version>
+    <version>0.8-beta</version>
 </dependency>
 ```
 
@@ -76,7 +76,7 @@ repositories {
 Add dependencies (you can also add other modules that you need):
 
 ```groovy
-compile 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.7-beta'
+compile 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.8-beta'
 ```
 
 And make sure that you use the right Kotlin version:

kotlinx-coroutines-core/pom.xml

@@ -22,7 +22,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.7-beta-SNAPSHOT</version>
+        <version>0.8-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-core</artifactId>

kotlinx-coroutines-javafx/pom.xml

@@ -22,7 +22,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.7-beta-SNAPSHOT</version>
+        <version>0.8-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-javafx</artifactId>

kotlinx-coroutines-jdk8/pom.xml

@@ -22,7 +22,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.7-beta-SNAPSHOT</version>
+        <version>0.8-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-jdk8</artifactId>

kotlinx-coroutines-nio/pom.xml

@@ -22,7 +22,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.7-beta-SNAPSHOT</version>
+        <version>0.8-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-nio</artifactId>

kotlinx-coroutines-rx-example/pom.xml

@@ -22,7 +22,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.7-beta-SNAPSHOT</version>
+        <version>0.8-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-rx-example</artifactId>

kotlinx-coroutines-rx/pom.xml

@@ -22,7 +22,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.7-beta-SNAPSHOT</version>
+        <version>0.8-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-rx</artifactId>

kotlinx-coroutines-swing/pom.xml

@@ -22,7 +22,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.7-beta-SNAPSHOT</version>
+        <version>0.8-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-swing</artifactId>

pom.xml

@@ -23,7 +23,7 @@
 
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kotlinx-coroutines</artifactId>
-    <version>0.7-beta-SNAPSHOT</version>
+    <version>0.8-beta-SNAPSHOT</version>
     <packaging>pom</packaging>
 
     <description>Coroutines support libraries for Kotlin 1.1</description>

site/pom.xml

@@ -22,7 +22,7 @@
     <parent>
         <groupId>org.jetbrains.kotlinx</groupId>
         <artifactId>kotlinx-coroutines</artifactId>
-        <version>0.7-beta-SNAPSHOT</version>
+        <version>0.8-beta-SNAPSHOT</version>
     </parent>
 
     <artifactId>kotlinx-coroutines-site</artifactId>