Skip to content

Commit 7397b44

Browse files
committed
additional clean up for the custom devices glossary entry
1 parent 678d289 commit 7397b44

3 files changed

Lines changed: 23 additions & 22 deletions

File tree

api/embedded_profile.asciidoc

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -263,19 +263,21 @@ Device Queries>> table.
263263
The minimum value is 1 KB.
264264
| {CL_DEVICE_COMPILER_AVAILABLE}
265265
| {cl_bool_TYPE}
266-
| Is {CL_FALSE} if the implementation does not have a compiler available
267-
to compile the program source.
266+
| Is {CL_TRUE} if a compiler is available to compile programs created from
267+
source or IL, or {CL_FALSE} if the implementation does not have a
268+
compiler available.
268269

269-
Is {CL_TRUE} if the compiler is available.
270-
This can be {CL_FALSE} for the embedded platform profile only.
270+
This can be {CL_FALSE} for devices supporting the embedded profile.
271+
272+
When an online compiler is not available, OpenCL programs may still be
273+
created from binaries or built-in kernels supported by the device.
271274
| {CL_DEVICE_LINKER_AVAILABLE}
272275
| {cl_bool_TYPE}
273-
| Is {CL_FALSE} if the implementation does not have a linker available.
274-
Is {CL_TRUE} if the linker is available.
275-
276-
This can be {CL_FALSE} for the embedded platform profile only.
276+
| Is {CL_TRUE} if a linker is available to link compiled programs, or
277+
{CL_FALSE} if the implementation does not have a linker available.
277278

278-
This must be {CL_TRUE} if {CL_DEVICE_COMPILER_AVAILABLE} is {CL_TRUE}.
279+
This can be {CL_FALSE} for devices supporting the embedded profile, but
280+
must be {CL_TRUE} if {CL_DEVICE_COMPILER_AVAILABLE} is {CL_TRUE}.
279281
| {CL_DEVICE_QUEUE_ON_DEVICE_MAX_SIZE}
280282
| {cl_uint_TYPE}
281283
| The max. size of the device queue in bytes.

api/glossary.asciidoc

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -173,9 +173,6 @@ Custom Device ::
173173
OpenCL runtime APIs for directed tasks but is not OpenCL conformant.
174174
A _custom device_ must implement all of the OpenCL runtime APIs, but may
175175
return implementation-defined error codes for unsupported functionality.
176-
_Custom devices_ may support an online compiler.
177-
When an online compiler is not available, OpenCL _programs_ may be created
178-
from binaries or for _built-in kernels_ supported by the device.
179176
See also _Device_.
180177

181178
Data Parallel Programming Model ::

api/opencl_platform_layer.asciidoc

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1140,7 +1140,7 @@ include::{generated}/api/version-notes/CL_DEVICE_PROFILING_TIMER_RESOLUTION.asci
11401140
include::{generated}/api/version-notes/CL_DEVICE_ENDIAN_LITTLE.asciidoc[]
11411141
| {cl_bool_TYPE}
11421142
| Is {CL_TRUE} if the OpenCL device is a little endian device and
1143-
{CL_FALSE} otherwise
1143+
{CL_FALSE} otherwise.
11441144
| {CL_DEVICE_AVAILABLE_anchor}
11451145

11461146
include::{generated}/api/version-notes/CL_DEVICE_AVAILABLE.asciidoc[]
@@ -1152,21 +1152,23 @@ include::{generated}/api/version-notes/CL_DEVICE_AVAILABLE.asciidoc[]
11521152

11531153
include::{generated}/api/version-notes/CL_DEVICE_COMPILER_AVAILABLE.asciidoc[]
11541154
| {cl_bool_TYPE}
1155-
| Is {CL_FALSE} if the implementation does not have a compiler available
1156-
to compile the program source.
1155+
| Is {CL_TRUE} if a compiler is available to compile programs created from
1156+
source or IL, or {CL_FALSE} if the implementation does not have a
1157+
compiler available.
11571158

1158-
Is {CL_TRUE} if the compiler is available.
1159-
This can be {CL_FALSE} for the embedded platform profile only.
1159+
This must be {CL_TRUE} for devices supporting the full profile.
1160+
1161+
When an online compiler is not available, OpenCL programs may still be
1162+
created from binaries or built-in kernels supported by the device.
11601163
| {CL_DEVICE_LINKER_AVAILABLE_anchor}
11611164

11621165
include::{generated}/api/version-notes/CL_DEVICE_LINKER_AVAILABLE.asciidoc[]
11631166
| {cl_bool_TYPE}
1164-
| Is {CL_FALSE} if the implementation does not have a linker available.
1165-
Is {CL_TRUE} if the linker is available.
1166-
1167-
This can be {CL_FALSE} for the embedded platform profile only.
1167+
| Is {CL_TRUE} if a linker is available to link compiled programs, or
1168+
{CL_FALSE} if the implementation does not have a linker available.
11681169

1169-
This must be {CL_TRUE} if {CL_DEVICE_COMPILER_AVAILABLE} is {CL_TRUE}.
1170+
This must be {CL_TRUE} for devices supporting the full profile or if
1171+
{CL_DEVICE_COMPILER_AVAILABLE} is {CL_TRUE}.
11701172
| {CL_DEVICE_EXECUTION_CAPABILITIES_anchor}
11711173

11721174
include::{generated}/api/version-notes/CL_DEVICE_EXECUTION_CAPABILITIES.asciidoc[]

0 commit comments

Comments
 (0)