Skip to content

Commit

Permalink
Reword description of default context
Browse files Browse the repository at this point in the history
Reword to address comments from WG.

I also noticed that we never state anything about the async error
handler of the default context object.  I'm pretty sure our intent
is that the default `context` object has no async error handler, so
I added words to this effect.
  • Loading branch information
gmlueck committed Oct 7, 2024
1 parent 9075baa commit 2d63525
Showing 1 changed file with 6 additions and 2 deletions.
8 changes: 6 additions & 2 deletions adoc/chapters/programming_interface.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -969,8 +969,12 @@ The [code]#platform# class also provides constructors, but constructing a new
[code]#platform# instance merely creates a new object that is a copy of one of
the objects returned by [api]#platform::get_platforms#.

Each platform has a single context object which is used as its default context.
That context object contains all of the devices in the platform.
Each platform has a default context which contains all of the devices in the
platform and has no associated asynchronous error handler.
Applications can retrieve a copy of this default `context` object, for example,
by constructing a `queue`.
These copies follow the common reference semantics, as though they are all copies
of a single internal `context` object that is held by each platform.

The [code]#platform# class provides the common reference semantics as defined in
<<sec:reference-semantics>>.
Expand Down

0 comments on commit 2d63525

Please sign in to comment.