@@ -198,15 +198,18 @@ extension Task {
198198 ///
199199 /// Task cancellation is cooperative:
200200 /// 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.
204206 ///
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.
210213 ///
211214 /// Likewise, if the task has already run
212215 /// past the last point where it would stop early,
0 commit comments