Deprecate counter based event pools (#404)

Signed-off-by: Bartosz Dunajski <bartosz.dunajski@intel.com>

Author: BartoszDunajski

scripts/core/EXT_Exp_CounterBasedEventPools.rst

@@ -14,6 +14,8 @@ from templates import helper as th
  Counter-Based Event Pools Extension
 =====================================
 
+    - This experimental extension is deprecated and replaced by the :ref:`Counter-based events<counter-based-events>`
+
 API
 ----
 

scripts/core/PROG.rst

@@ -460,7 +460,7 @@ The following pseudo-code demonstrates querying properties of a physical memory
 
     ze_physical_mem_handle_t hPhysicalMemory; 
 
-    ${x}PhysicalMemCreate(hContext, hDevice, &alloc_desc, &hPhysicalMemory) 
+    ${x}PhysicalMemCreate(hContext, hDevice, &alloc_desc, &hPhysicalMemory)
     
     // Set up the request to export the external memory handle 
 
@@ -507,7 +507,7 @@ The following pseudo-code demonstrates querying properties of a physical memory
     .size = 1024 
     };
 
-    ${x}PhysicalMemCreate(hContext, hDevice, &alloc_desc, &physicalMemImporter);
+    ${x}PhysicalMemCreate(hContext, hDevice, &alloc_desc, &physicalMemImporter);
 
 
 Mapping Virtual Memory Pages
@@ -800,7 +800,7 @@ The following pseudo-code demonstrates how to import a Linux dma_buf as an exter
         .size = 1024 
         };
 
-        ${x}PhysicalMemCreate(hContext, hDevice, &allocDesc, &physicalMemImporter);
+        ${x}PhysicalMemCreate(hContext, hDevice, &allocDesc, &physicalMemImporter);
 
 Command Queues and Command Lists
 ================================
@@ -1353,6 +1353,7 @@ Driver may select which API calls are applicable for generating interrupts.
 Additionally, user may provide external interrupt id (${X}_EVENT_SYNC_MODE_FLAG_EXTERNAL_INTERRUPT_WAIT). OS methods will be used for Event host synchronization calls, to optimize waiting for completion. Similar to low power mode. 
 It can be used only with Counter Based Events.
 
+.. _counter-based-events:
 Counter Based Events
 ~~~~~~~~~~~~~~~~~~~~~~~
 

scripts/core/counterbasedeventpool.yml

@@ -7,7 +7,7 @@
 #
 --- #--------------------------------------------------------------------------
 type: header
-desc: "Intel $OneApi Level-Zero Extension APIs for Counter-based Event Pools"
+desc: "Intel $OneApi Level-Zero Extension APIs for Counter-based Event Pools. @deprecated since 1.15"
 version: "1.8"
 --- #--------------------------------------------------------------------------
 type: macro
@@ -37,7 +37,7 @@ etors:
       desc: "Counter-based event pool is for non-immediate command lists"
 --- #--------------------------------------------------------------------------
 type: struct
-desc: "Event pool descriptor for counter-based events. This structure may be passed to $xEventPoolCreate as pNext member of $x_event_pool_desc_t."
+desc: "Event pool descriptor for counter-based events. This structure may be passed to $xEventPoolCreate as pNext member of $x_event_pool_desc_t. @deprecated since 1.15"
 class: $xEventPool
 version: "1.8"
 name: $x_event_pool_counter_based_exp_desc_t