Clarify behavior of unsupported properties

Author: gmlueck

sycl/doc/extensions/experimental/sycl_ext_oneapi_kernel_compiler.asciidoc

@@ -228,6 +228,8 @@ _Throws:_
 
 * An `exception` with the `errc::invalid` error code if the source language
   `lang` is not supported by any device contained by the context `ctxt`.
+* An `exception` with the `errc::invalid` error code if the source language
+  `lang` does not support one of the properties in `PropertyListT`.
 * Overload (1) throws an `exception` with the `errc::invalid` error code if the
   source language `lang` is binary format.
 * Overload (2) throws an `exception` with the `errc::invalid` error code if the
@@ -296,8 +298,10 @@ _Throws:_
   `devs` does not support compilation of kernels in the source language of
   `sourceBundle`.
 
-* An `exception` with the `errc::invalid` error code if `props` contains an
-  `options` property that specifies an invalid option.
+* An `exception` with the `errc::invalid` error code if the source language
+  `lang` does not support one of the properties in `PropertyListT` or if
+  `props` contains a `build_options` property that contains an option that is
+  not supported by `lang`.
 
 * An `exception` with the `errc::build` error code if the compilation or
   linking operations fail.
@@ -419,10 +423,8 @@ struct is_property_key<build_options_key> : std::true_type {};
 
 This property provides build options that may affect the compilation or linking
 of the kernel, where each build option is a string.
-There are no standard build options that are common across all source
-languages.
-Instead, each source language specification defines its own set of build
-options.
+All source languages support the `build_options` property, but each source
+language defines the specific options that it supports.
 The `source_language::sycl` language does not define any standard build
 options, but an implementation may support implementation-defined options.
 
@@ -466,8 +468,8 @@ provides a description of the error.
 Instead, the `save_log` property provides information about a build operation
 that succeeds.
 This might include warning messages or other diagnostics.
-Each source language specification can define specific information that is
-provided in the log.
+All source languages support the `save_log` property, but each source language
+defines the specific information that is provided in the log.
 The `source_language::sycl` language does not define any specific information
 that is provided in the log, so implementations are free to provide any
 information they choose here.

sycl/doc/extensions/experimental/sycl_ext_oneapi_kernel_compiler_opencl.asciidoc

@@ -114,11 +114,15 @@ As a result, the application must use the overload of
 `create_kernel_bundle_from_source` taking `std::string` when creating a kernel
 bundle from this language.
 
-=== Build options
+=== Supported properties
 
-The `build_options` property accepts any of the compiler or linker options
-defined by the OpenCL specification, except for those that are specific to
-creating an OpenCL library.
+The `opencl` language supports only those properties from
+link:../experimental/sycl_ext_oneapi_kernel_compiler.asciidoc[
+sycl_ext_oneapi_kernel_compiler] that are common to all source languages.
+
+The `build_options` property that is passed to the `build` function may contain
+any of the compiler or linker options defined by the OpenCL specification,
+except for those that are specific to creating an OpenCL library.
 The kernel compiler can be used to create an OpenCL program, but not an OpenCL
 library.
 

sycl/doc/extensions/experimental/sycl_ext_oneapi_kernel_compiler_spirv.asciidoc

@@ -121,11 +121,15 @@ As a result, the application must use the overload of
 `create_kernel_bundle_from_source` taking `std::vector<std::byte>` when
 creating a kernel bundle from this language.
 
-=== Build options
+=== Supported properties
+
+The `spirv` language supports only those properties from
+link:../experimental/sycl_ext_oneapi_kernel_compiler.asciidoc[
+sycl_ext_oneapi_kernel_compiler] that are common to all source languages.
 
 This extension does not specify any options that may be passed via the
-`build_options` property, however an implementation may allow
-implementation-defined options to be passed this way.
+`build_options` property to the `build` function, however an implementation may
+allow implementation-defined options to be passed this way.
 
 === SPIR-V execution environment