@@ -15,12 +15,12 @@ import kotlin.coroutines.experimental.*
15
15
* This class implements completion [Continuation], [Job], and [CoroutineScope] interfaces.
16
16
* It stores the result of continuation in the state of the job.
17
17
* This coroutine waits for children coroutines to finish before completing and
18
- * is cancelled through an intermediate _cancelling_ state.
18
+ * fails through an intermediate _failing_ state.
19
19
*
20
20
* The following methods are available for override:
21
21
*
22
22
* * [onStart] is invoked when coroutine is create in not active state and is [started][Job.start].
23
- * * [onCancellation ] is invoked as soon as coroutine is [cancelled][cancel] (becomes _cancelling_)
23
+ * * [onFailing ] is invoked as soon as coroutine is _failing_, or is cancelled,
24
24
* or when it completes for any reason.
25
25
* * [onCompleted] is invoked when coroutine completes with a value.
26
26
* * [onCompletedExceptionally] in invoked when coroutines completes with exception.
@@ -82,10 +82,8 @@ public abstract class AbstractCoroutine<in T>(
82
82
* * Cause is an instance of [CancellationException] when job was cancelled _normally_.
83
83
* **It should not be treated as an error**. In particular, it should not be reported to error logs.
84
84
* * Otherwise, the job had _failed_.
85
- *
86
- * @suppress **Deprecated**: Override [onFailing].
87
85
*/
88
- override fun onFailing (cause : Throwable ? ) {
86
+ protected override fun onFailing (cause : Throwable ? ) {
89
87
onCancellation(cause)
90
88
}
91
89
0 commit comments