KhronosGroup / KhronosGroup/OpenCL-Docs

Refine thread safety language and track as part of XML

Open
#1,394 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
420
Forks
131
Avg merge
5d 13h
Merged PRs (30d)
11

Description

This issue follows on from discussion on [command-buffers and thread safety](https://github.com/KhronosGroup/OpenCL-Docs/issues/1323#issuecomment-2749777068) where it was decided that a better way to specify the thread-safety of OpenCL objects/entry-points was by:
* Moving the description of thread-safety from [the appendix](https://registry.khronos.org/OpenCL/specs/3.0-unified/html/OpenCL_API.html#_multiple_host_threads) into the main spec
* Adopt a more precise term like "externally synchronized"
* Record this information in the XML file

Contributor guide

Open the contributing guide

Research direction

Start by reading the discussion in issue 1323 and the current “Multiple Host Threads” appendix in the OpenCL specification. Identify where the thread-safety description should move in the main spec and how the XML records object or entry-point metadata. Done means the terminology is made precise, the main specification contains the guidance, and the XML tracks it consistently.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.