mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
Update the diagostic docs so that they can be built with docc:
* Add technologyroot (diagnostics.md) to aggregate all markdown files
* Fixed warnings in a few diagnostics docs
This allows the creation of docc documentation with a single
invocation of docc. It will generate the landing page from
diagnostics.md and include all of the diagnostics as subarticles.
The subarticles are accessible via the name of the markdown file,
which is being used as the ID for these diagnostics.
E.g. existential-any.
The docc docs for these documents can be generated locally with the
following command:
>docc preview --allow-arbitrary-catalog-directories userdocs/diagnostics
16 lines
731 B
Markdown
16 lines
731 B
Markdown
# `AsyncCallerExecution`
|
|
|
|
This feature changes the behavior of nonisolated async
|
|
functions to run on the actor to which the caller is isolated (if any) by
|
|
default, and provides an explicit way to express the execution semantics for
|
|
these functions.
|
|
|
|
This feature was proposed in [SE-0461](https://github.com/swiftlang/swift-evolution/blob/main/proposals/0461-async-function-isolation.md)
|
|
|
|
* The `@execution(concurrent)` attribute specifies that a function must always
|
|
switch off of an actor to run.
|
|
This is the default behavior without `AsyncCallerExecution`.
|
|
* The `@execution(caller)` attribute specifies that a function must always
|
|
run on the caller's actor.
|
|
This is the default behavior with `AsyncCallerExecution`.
|