Merge pull request #38654 from DougGregor/task-yield-again

Author: swift-ci

stdlib/public/Concurrency/SourceCompatibilityShims.swift

@@ -29,6 +29,12 @@ extension Task where Success == Never, Failure == Never {
   public static func CancellationError() -> _Concurrency.CancellationError {
     return _Concurrency.CancellationError()
   }
+
+  @available(*, deprecated, renamed: "yield()")
+  @_alwaysEmitIntoClient
+  public static func suspend() async {
+    await yield()
+  }
 }
 
 @available(SwiftStdlib 5.5, *)

stdlib/public/Concurrency/Task.swift

@@ -627,7 +627,10 @@ extension Task where Success == Never, Failure == Never {
   /// if the task is the highest-priority task in the system, it might go
   /// immediately back to executing.
   ///
-  @available(*, deprecated, renamed: "suspend()")
+  /// If this task is the highest-priority task in the system,
+  /// the executor immediately resumes execution of the same task.
+  /// As such,
+  /// this method isn't necessarily a way to avoid resource starvation.
   public static func yield() async {
     let currentTask = Builtin.getCurrentAsyncTask()
     let priority = getJobFlags(currentTask).priority ?? Task.currentPriority._downgradeUserInteractive
@@ -637,11 +640,6 @@ extension Task where Success == Never, Failure == Never {
       _enqueueJobGlobal(job)
     }
   }
-
-  @_alwaysEmitIntoClient
-  public static func suspend() async {
-    await yield()
-  }
 }
 
 // ==== UnsafeCurrentTask ------------------------------------------------------