Deprecated flags ZE_COMMAND_LIST_FLAG_EXPLICIT_ONLY and ZE_COMMAND_QUEUE_FLAG_EXPLICIT_ONLY (#335)

Removed the description for driver optimization acrosss sub devices
when these flags are not used.

Signed-off-by: PRADEEP BG <[email protected]>

Author: pbg-intel

scripts/core/PROG.rst

@@ -821,11 +821,6 @@ Execution
 - Command queue submission is free-threaded, allowing multiple Host threads to share the same command queue.
 - If multiple Host threads enter the same command queue simultaneously, then execution order is undefined.
 - Command lists can only be executed on a command queue with an identical command queue group ordinal.
-- If a device contains multiple sub-devices, then command lists submitted to a device-level command queue
-  may be optimized by the driver to fully exploit the concurrency of the sub-devices by distributing command lists across sub-devices.
-- If the application prefers to opt-out of these optimizations, such as when the application plans to perform this distribution itself,
-  then it should use ${X}_COMMAND_QUEUE_FLAG_EXPLICIT_ONLY. Only command lists created using ${X}_COMMAND_LIST_FLAG_EXPLICIT_ONLY
-  can be executed on a command queue created using ${X}_COMMAND_QUEUE_FLAG_EXPLICIT_ONLY.
 
 
 Destruction
@@ -869,11 +864,6 @@ Appending
 - For usage-models where maximum throughput is desired, applications should
   use ${X}_COMMAND_LIST_FLAG_MAXIMIZE_THROUGHPUT. This flag will indicate to the driver
   it may perform additional device-specific optimizations.
-- If a device contains multiple sub-devices, then commands submitted to a device-level
-  command list may be optimized by the driver to fully exploit the concurrency of the
-  sub-devices by distributing commands across sub-devices. If the application prefers
-  to opt-out of these optimizations, such as when the application plans to perform this
-  distribution itself, then it should use ${X}_COMMAND_LIST_FLAG_EXPLICIT_ONLY.
 
 The following pseudo-code demonstrates a basic sequence for creation of command lists:
 

scripts/core/cmdlist.yml

@@ -30,6 +30,7 @@ etors:
             command list should be optimized for submission to a single command queue and device engine.
             driver **must** disable any implicit optimizations for distributing work across multiple engines.
             this flag should be used when applications want full control over multi-engine submission and scheduling.
+            This flag is **DEPRECATED** and implementations are not expected to support this feature.
     - name: IN_ORDER
       version: "1.7"
       desc: |

scripts/core/cmdqueue.yml

@@ -20,6 +20,7 @@ etors:
             command queue should be optimized for submission to a single device engine.
             driver **must** disable any implicit optimizations for distributing work across multiple engines.
             this flag should be used when applications want full control over multi-engine submission and scheduling.
+            This flag is **DEPRECATED** as flag ${X}_COMMAND_LIST_FLAG_EXPLICIT_ONLY is **DEPRECATED**.
     - name: IN_ORDER
       version: "1.7"
       desc: |
@@ -72,7 +73,7 @@ members:
       name: index
       desc: |
             [in] command queue index within the group;
-            must be zero if $X_COMMAND_QUEUE_FLAG_EXPLICIT_ONLY is not set
+            must be zero if $X_COMMAND_QUEUE_FLAG_EXPLICIT_ONLY is not set. 
     - type: $x_command_queue_flags_t
       name: flags
       desc: |