[webkit-changes] [WebKit/WebKit] 1bab35: Improve NativePromise documentation

[Jean-Yves Avenard]

  Branch: refs/heads/main
  Home:   https://github.com/WebKit/WebKit
  Commit: 1bab3553165e685945efdfe37a29bd42fe490874
      https://github.com/WebKit/WebKit/commit/1bab3553165e685945efdfe37a29bd42fe490874
  Author: Jean-Yves Avenard <jya at apple.com>
  Date:   2023-10-14 (Sat, 14 Oct 2023)

  Changed paths:
    M Source/WTF/wtf/NativePromise.h
    M Tools/TestWebKitAPI/Tests/WTF/NativePromise.cpp

  Log Message:
  -----------
  Improve NativePromise documentation
https://bugs.webkit.org/show_bug.cgi?id=262996
rdar://116788669

Reviewed by Eric Carlson.

Add example for hypothetical scenario.
Improve readability of the API tests by using more descriptive variable
names.

* Source/WTF/wtf/NativePromise.h:
* Tools/TestWebKitAPI/Tests/WTF/NativePromise.cpp:
(TestWebKitAPI::TEST):
(TestWebKitAPI::AVCaptureMethod::captureImage):
(TestWebKitAPI::PhotoProducer::create):
(TestWebKitAPI::PhotoProducer::takePhoto const):
(TestWebKitAPI::PhotoProducer::PhotoProducer):
(TestWebKitAPI::PhotoProducer::takePhotoImpl const):

Canonical link: https://commits.webkit.org/269339@main