KhronosGroup / KhronosGroup/KSCAF_DocRequirements

Parallel execution of threads: no confusing disclaimers

Open
#31 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
CSS
Stars
4
Forks
2
PR merge metrics
No merged PRs in 30d

Description

API disclaimers such as “client API commands are not guaranteed to be atomic” are confusing in the context of parallel execution of threads. For example, since API users cannot know whether ‘eglMakeCurrent’ causes any client API operations, they cannot know whether call ‘eglMakeCurrent(dpy, EGL_NO_CONTEXT, EGL_NO_SURFACE, EGL_NO_SURFACE)’ at the very end of a thread will finish before call to ‘eglMakeCurent(dpy, draw, read, ctx)’ at the very start of the next thread, where ‘ctx’ was bound to ‘draw’ and ‘read’ in the first thread. In this example, standard should include guidance whether it is up to the implementation or the user to manage effects of parallel calls to specific functions.

For reference, general issue "Parallel execution of threads" is defined as issue #29.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing issue #29 and the quoted API disclaimer about atomicity, then examine how parallel execution and eglMakeCurrent are addressed in the standard. Done means the standard contains clear guidance on whether implementations or users manage effects of parallel calls to specific functions.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.