0.7-beta release

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>