Fix to documentation warnings (#405)

Signed-off-by: Neil R. Spruit <neil.r.spruit@intel.com>

Author: nrspruit

scripts/core/EXT.rst

@@ -7,6 +7,10 @@ from templates import helper as th
     X=x.upper()
     s=tags['$s']
     S=s.upper()
+    t=tags['$t']
+    T=t.upper()
+    r=tags['$r']
+    R=r.upper()
 %>
 ============
  Extensions
@@ -166,43 +170,47 @@ Each extension must document which specific structures and functions can be exte
 
 List of Standard Core Extensions
 ================================
-
+## --validate=off
 %for name in meta['macro']:
 %if name.endswith("EXT_NAME") and name.startswith('$X' + '_'):
     - :ref:`${th.subt(namespace, tags, meta['macro'][name]['values'][0])} <${th.subt(namespace, tags, meta['macro'][name]['values'][0]).replace('"', '')}>`\
 
 %endif
 %endfor
+## --validate=on
 
 List of Standard Tools Extensions
 =================================
-
+## --validate=off
 %for name in meta['macro']:
 %if name.endswith("EXT_NAME") and name.startswith('$T' + '_'):
     - :ref:`${th.subt(namespace, tags, meta['macro'][name]['values'][0])} <${th.subt(namespace, tags, meta['macro'][name]['values'][0]).replace('"', '')}>`\
 
 %endif
 %endfor
+## --validate=on
 
 List of Standard Sysman Extensions
 ==================================
-
+## --validate=off
 %for name in meta['macro']:
 %if name.endswith("EXT_NAME") and name.startswith('$S' + '_'):
     - :ref:`${th.subt(namespace, tags, meta['macro'][name]['values'][0])} <${th.subt(namespace, tags, meta['macro'][name]['values'][0]).replace('"', '')}>`\
 
 %endif
 %endfor
+## --validate=on
 
 List of Standard Runtime Extensions
 ===================================
-
+## --validate=off
 %for name in meta['macro']:
 %if name.endswith("EXT_NAME") and name.startswith('$R' + '_'):
     - :ref:`${th.subt(namespace, tags, meta['macro'][name]['values'][0])} <${th.subt(namespace, tags, meta['macro'][name]['values'][0]).replace('"', '')}>`\
 
 %endif
 %endfor
+## --validate=on
 
 List of All Experimental Extensions
 ===================================

scripts/core/EXT_Image_Format_Support.rst

@@ -54,7 +54,7 @@ Example Usage
 -------------
 
 Single Image Format Validation
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------
 
 .. code-block:: cpp
 
@@ -87,7 +87,7 @@ Single Image Format Validation
     }
 
 Testing Multiple Image Formats on the Same Device
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+-------------------------------------------------
 
 .. code-block:: cpp
 
@@ -135,7 +135,7 @@ Testing Multiple Image Formats on the Same Device
     }
 
 Testing the Same Image Format Across Multiple Devices
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+-----------------------------------------------------
 
 .. code-block:: cpp
 

scripts/core/memory.yml

@@ -450,7 +450,7 @@ members:
 details:
     - "1.0": "This structure may be passed to $xMemAllocDevice, via the `pNext` member of $x_device_mem_alloc_desc_t, to indicate an exportable memory allocation."
       "1.5": "This structure may be passed to $xMemAllocDevice and $xMemAllocHost, via the `pNext` member of $x_device_mem_alloc_desc_t or $x_host_mem_alloc_desc_t, respectively, to indicate an exportable memory allocation."
-      "1.15": "This structure may be passed to $xMemAllocDevice, $xMemAllocHost, or $xPhysicalMemCreate, via the `pNext` member of $x_device_mem_alloc_desc_t or $x_host_mem_alloc_desc_t, or $x_physical_mem_alloc_desc_t, respectively, to indicate an exportable memory allocation."
+      "1.15": "This structure may be passed to $xMemAllocDevice, $xMemAllocHost, or $xPhysicalMemCreate, via the `pNext` member of $x_device_mem_alloc_desc_t or $x_host_mem_alloc_desc_t, or $x_physical_mem_desc_t, respectively, to indicate an exportable memory allocation."
     - "This structure may be passed to $xImageCreate, via the `pNext` member of $x_image_desc_t, to indicate an exportable image."
 --- #--------------------------------------------------------------------------
 type: struct
@@ -471,7 +471,7 @@ members:
 details:
     - "1.0": "This structure may be passed to $xMemAllocDevice, via the `pNext` member of $x_device_mem_alloc_desc_t, to import memory from a file descriptor."
       "1.5": "This structure may be passed to $xMemAllocDevice or $xMemAllocHost, via the `pNext` member of $x_device_mem_alloc_desc_t or of $x_host_mem_alloc_desc_t, respectively, to import memory from a file descriptor."
-      "1.15": "This structure may be passed to $xMemAllocDevice, $xMemAllocHost, or $xPhysicalMemCreate, via the `pNext` member of $x_device_mem_alloc_desc_t or $x_host_mem_alloc_desc_t, or $x_physical_mem_alloc_desc_t, respectively, to import memory from a file descriptor."
+      "1.15": "This structure may be passed to $xMemAllocDevice, $xMemAllocHost, or $xPhysicalMemCreate, via the `pNext` member of $x_device_mem_alloc_desc_t or $x_host_mem_alloc_desc_t, or $x_physical_mem_desc_t, respectively, to import memory from a file descriptor."
     - "This structure may be passed to $xImageCreate, via the `pNext` member of $x_image_desc_t, to import memory from a file descriptor."
 --- #--------------------------------------------------------------------------
 type: struct
@@ -520,7 +520,7 @@ details:
     - "When `flags` is $X_EXTERNAL_MEMORY_TYPE_FLAG_OPAQUE_WIN32_KMT, `name` must be `nullptr`."
     - "1.0": "This structure may be passed to $xMemAllocDevice, via the `pNext` member of $x_device_mem_alloc_desc_t, to import memory from a Win32 handle."
       "1.5": "This structure may be passed to $xMemAllocDevice or $xMemAllocHost, via the `pNext` member of $x_device_mem_alloc_desc_t or of $x_host_mem_alloc_desc_t, respectively, to import memory from a Win32 handle."
-      "1.15": "This structure may be passed to $xMemAllocDevice, $xMemAllocHost, or $xPhysicalMemCreate, via the `pNext` member of $x_device_mem_alloc_desc_t or $x_host_mem_alloc_desc_t, or $x_physical_mem_alloc_desc_t, respectively, to import memory from a Win32 handle."
+      "1.15": "This structure may be passed to $xMemAllocDevice, $xMemAllocHost, or $xPhysicalMemCreate, via the `pNext` member of $x_device_mem_alloc_desc_t or $x_host_mem_alloc_desc_t, or $x_physical_mem_desc_t, respectively, to import memory from a Win32 handle."
     - "This structure may be passed to $xImageCreate, via the `pNext` member of $x_image_desc_t, to import memory from a Win32 handle."
 --- #--------------------------------------------------------------------------
 type: struct