0.7-beta release

Author: elizarov

CHANGES.md

@@ -1,6 +1,13 @@
 # Change log for kotlinx.coroutines 
 
+## Version 0.7-beta
 
+* Buffered and unbuffered channels are introduced: `Channel`, `SendChannel`, and `ReceiveChannel` interfaces,
+  `RendezvousChannel` and `ArrayChannel` implementations, `Channel()` factory function and `buildChannel{}`
+  coroutines builder.
+* `Here` context is renamed to `Unconfined` (the old name is deprecated).
+* A [guide on coroutines](coroutines-guide.md) is expanded: sections on contexts and channels.  
+ 
 ## Version 0.6-beta
 
 * Switched to Kotlin version 1.1.0-beta-37.

README.md

@@ -4,23 +4,8 @@ Library support for Kotlin coroutines. This is a companion version for Kotlin 1.
 
 ## Modules and features
 
-* `kotlinx-coroutines-core` module with core primitives to work with coroutines. It is designed to work on any JDK6+ and Android
-and contains the following main pieces:
-  * `launch(context) {...}` to start a coroutine in the given context and get reference to its `Job`.
-  * `run(context) {...}` to switch to a different context inside a coroutine.
-  * `runBlocking {...}` to use asynchronous Kotlin APIs from a thread-blocking code.  
-  * `defer(context) {...}` and `lazyDefer(context) {...}` to get a deferred result of coroutine execution in a 
-     non-blocking way via a light-weight future interface called `Deferred`.
-  * `delay(...)` for a non-blocking sleep in coroutines and `yield` to release a thread in single-threaded dispatchers.
-  * `withTimeout(timeout) {...}` scope function to easily set coroutine time-limit (deadline),
-     and `NonCancellable` context to avoid it when needed.
-  * `CommonPool` and `Here` contexts, access to `context` of a parent coroutine in its `CoroutineScope`.
-  * `newSingleThreadContext(...)` and `newFixedThreadPoolContext(...)` functions, 
-    `Executor.toCoroutineDispatcher()` extension.
-  * Cancellation support with `Job` interface and `suspendCancellableCoroutine` helper function.
-  * Debugging facilities for coroutines (run JVM with `-ea` or `-Dkotlinx.coroutines.debug` options) and
-    `newCoroutineContext(context)` function to write user-defined coroutine builders that work with these
-     debugging facilities.
+* `kotlinx-coroutines-core` module with core primitives to work with coroutines. 
+   Its functionality is covered by the [guide to kotlinx.coroutines](coroutines-guide.md). 
 
 * `kotlinx-coroutines-jdk8` module with additional libraries for JDK8 (or Android API level 24).
   * `future { ... }` coroutine builder that returns `CompletableFuture` and works in `CommonPool` context by default.
@@ -73,7 +58,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.6-beta</version>
+    <version>0.7-beta</version>
 </dependency>
 ```
 
@@ -100,7 +85,7 @@ repositories {
 Add dependencies (you can also add other modules that you need):
 
 ```groovy
-compile 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.6-beta'
+compile 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.7-beta'
 ```
 
 And make sure that you use the right Kotlin version:

kotlinx-coroutines-core/pom.xml

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

kotlinx-coroutines-javafx/pom.xml

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

kotlinx-coroutines-jdk8/pom.xml

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

kotlinx-coroutines-nio/pom.xml

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

kotlinx-coroutines-rx-example/pom.xml

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

kotlinx-coroutines-rx/pom.xml

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

kotlinx-coroutines-swing/pom.xml

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

pom.xml

@@ -7,7 +7,7 @@
 
     <groupId>org.jetbrains.kotlinx</groupId>
     <artifactId>kotlinx-coroutines</artifactId>
-    <version>0.6-beta-SNAPSHOT</version>
+    <version>0.7-beta-SNAPSHOT</version>
     <packaging>pom</packaging>
 
     <name>Kotlin coroutines libraries</name>