@@ -198,15 +198,18 @@ extension Task {
198
198
///
199
199
/// Task cancellation is cooperative:
200
200
/// a task that supports cancellation
201
- /// checks whether it has been canceled at various points during its work,
202
- /// and may either return early or throw an error in order to
203
- /// finish running earlier than it would if it wasn't cancelled.
201
+ /// checks whether it has been canceled at various points during its work.
202
+ /// You determine what action a canceled task takes,
203
+ /// and whether cancellation does anything to that task.
204
+ /// The task can return early or throw an error
205
+ /// to stop running early.
204
206
///
205
- /// Calling this method only has the effect of setting the cancelled
206
- /// flag on the task (or its child tasks), and unless the tasks itself
207
- /// react on this flag, there is no observable runtime behavior change
208
- /// of the tasks. Specifically, tasks are never "interrupted and stopped"
209
- /// forcefully, and are always allowed to execute code until returning or throwing/
207
+ /// Calling this method has only one effect:
208
+ /// setting the canceled flag on the task or its child tasks.
209
+ /// Unless the tasks react to this flag,
210
+ /// cancellation doesn't change the behavior of the tasks.
211
+ /// Specifically, tasks are never forcefully interrupted or stopped,
212
+ /// and are always allowed to execute code until they return or throw an error.
210
213
///
211
214
/// Likewise, if the task has already run
212
215
/// past the last point where it would stop early,
0 commit comments