Skip to content

Commit d0c82eb

Browse files
authored
docs(Dispatchers.common): Improve & fix grammar (#3209)
1 parent 5841eff commit d0c82eb

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

kotlinx-coroutines-core/common/src/Dispatchers.common.kt

+6-6
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@ public expect object Dispatchers {
2626
*
2727
* Access to this property may throw an [IllegalStateException] if no main dispatchers are present in the classpath.
2828
*
29-
* Depending on platform and classpath it can be mapped to different dispatchers:
29+
* Depending on platform and classpath, it can be mapped to different dispatchers:
3030
* - On JS and Native it is equivalent to the [Default] dispatcher.
31-
* - On JVM it either the Android main thread dispatcher, JavaFx or Swing EDT dispatcher. It is chosen by the
31+
* - On JVM it is either the Android main thread dispatcher, JavaFx or Swing EDT dispatcher. It is chosen by the
3232
* [`ServiceLoader`](https://docs.oracle.com/javase/8/docs/api/java/util/ServiceLoader.html).
3333
*
3434
* In order to work with the `Main` dispatcher, the following artifact should be added to the project runtime dependencies:
@@ -48,7 +48,7 @@ public expect object Dispatchers {
4848
* stack overflows.
4949
*
5050
* ### Event loop
51-
* Event loop semantics is a purely internal concept and have no guarantees on the order of execution
51+
* Event loop semantics is a purely internal concept and has no guarantees on the order of execution
5252
* except that all queued coroutines will be executed on the current thread in the lexical scope of the outermost
5353
* unconfined coroutine.
5454
*
@@ -63,11 +63,11 @@ public expect object Dispatchers {
6363
* }
6464
* println("Done")
6565
* ```
66-
* Can print both "1 2 3" and "1 3 2", this is an implementation detail that can be changed.
67-
* But it is guaranteed that "Done" will be printed only when both `withContext` calls are completed.
66+
* Can print both "1 2 3" and "1 3 2". This is an implementation detail that can be changed.
67+
* However, it is guaranteed that "Done" will be printed only when both `withContext` calls are completed.
6868
*
6969
* If you need your coroutine to be confined to a particular thread or a thread-pool after resumption,
70-
* but still want to execute it in the current call-frame until its first suspension, then you can use
70+
* but still want to execute it in the current call-frame until its first suspension, you can use
7171
* an optional [CoroutineStart] parameter in coroutine builders like
7272
* [launch][CoroutineScope.launch] and [async][CoroutineScope.async] setting it to
7373
* the value of [CoroutineStart.UNDISPATCHED].

0 commit comments

Comments
 (0)