@@ -21,7 +21,7 @@ import kotlinx.coroutines.experimental.intrinsics.*
21
21
import kotlin.coroutines.experimental.*
22
22
23
23
/* *
24
- * Defines start option for coroutines builders.
24
+ * Defines start options for coroutines builders.
25
25
* It is used in `start` parameter of [launch], [async], and other coroutine builder functions.
26
26
*
27
27
* The summary of coroutine start options is:
@@ -42,7 +42,7 @@ public enum class CoroutineStart {
42
42
* function, so starting coroutine with [Unconfined] dispatcher by [DEFAULT] is the same as using [UNDISPATCHED].
43
43
*
44
44
* If coroutine [Job] is cancelled before it even had a chance to start executing, then it will not start its
45
- * execution at all, but complete with an exception.
45
+ * execution at all, but will complete with an exception.
46
46
*
47
47
* Cancellability of coroutine at suspension points depends on the particular implementation details of
48
48
* suspending functions. Use [suspendCancellableCoroutine] to implement cancellable suspending functions.
@@ -56,12 +56,12 @@ public enum class CoroutineStart {
56
56
* (like [launch] and [async]).
57
57
*
58
58
* If coroutine [Job] is cancelled before it even had a chance to start executing, then it will not start its
59
- * execution at all, but complete with an exception.
59
+ * execution at all, but will complete with an exception.
60
60
*/
61
61
LAZY ,
62
62
63
63
/* *
64
- * Atomically (in non-cancellable way) schedules coroutine for execution according to its context.
64
+ * Atomically (i.e., in a non-cancellable way) schedules coroutine for execution according to its context.
65
65
* This is similar to [DEFAULT], but the coroutine cannot be cancelled before it starts executing.
66
66
*
67
67
* Cancellability of coroutine at suspension points depends on the particular implementation details of
@@ -70,12 +70,12 @@ public enum class CoroutineStart {
70
70
ATOMIC ,
71
71
72
72
/* *
73
- * Immediately executes coroutine until its first suspension point _in the current thread_ as if it the
73
+ * Immediately executes coroutine until its first suspension point _in the current thread_ as if the
74
74
* coroutine was started using [Unconfined] dispatcher. However, when coroutine is resumed from suspension
75
75
* it is dispatched according to the [CoroutineDispatcher] in its context.
76
76
*
77
77
* This is similar to [ATOMIC] in the sense that coroutine starts executing even if it was already cancelled,
78
- * but the difference is that it start executing in the same thread.
78
+ * but the difference is that it starts executing in the same thread.
79
79
*
80
80
* Cancellability of coroutine at suspension points depends on the particular implementation details of
81
81
* suspending functions as in [DEFAULT].
0 commit comments