mirror of
https://github.com/KhronosGroup/OpenCL-CTS.git
synced 2026-03-25 16:29:03 +00:00
Initial open source release of OpenCL 1.2 CTS.
This commit is contained in:
26
test_conformance/headers/README.txt
Normal file
26
test_conformance/headers/README.txt
Normal file
@@ -0,0 +1,26 @@
|
||||
test_conformance/headers README
|
||||
===============================
|
||||
|
||||
The test_headers.c test is designed to make sure that the various
|
||||
cl_typen types work and conform to expectation for recent versions
|
||||
of cl_platform.h. Conforming to these expectations make use of
|
||||
these types practical for developers writing portable code.
|
||||
|
||||
The various tests ending in .h.c are there to verify that the various
|
||||
OpenCL headers can compile stand alone. That is to ensure that they
|
||||
may be used a la carte. This provides developers a lifeline in the case
|
||||
that some unneeded part of OpenCL (e.g. cl/gl sharing) brings in a pile
|
||||
of symbols (e.g. all of OpenGL) that collides with other headers needed
|
||||
by the application. It is also poor form to require headers to be
|
||||
included in a particular order, especially if multiple systems require
|
||||
they be included in mutually incompatible order. So, here we require
|
||||
that each header can be used standalone so that the order is irrelevant.
|
||||
|
||||
In the .h.c tests, we also check to make sure that the headers don't
|
||||
cause spurious warnings. These tests are intended to be compiled using
|
||||
the most stringent compiler flags available for the platform, within
|
||||
reason. All warnings should be errors and extra warnings that it is
|
||||
expected developers are likely to use should be turned on. The current
|
||||
Makefile includes such flags for a GCC compiler. Implementors are
|
||||
expected to modify these flags and make system as necessary to conform
|
||||
to the local build environment.
|
||||
Reference in New Issue
Block a user