KhronosGroup / KhronosGroup/KSCAF_DocRequirements
Parallel execution of threads: no confusing disclaimers
- 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