Fix some markup (#900)

* Fix some markup

* Fix some more markup

chapters/VK_EXT_debug_utils.txt

@@ -418,8 +418,8 @@ sname:VkDebugUtilsMessengerCreateInfoEXT::pname:messageSeverity and
 sname:VkDebugUtilsMessengerCreateInfoEXT::pname:messageType determine when
 that sname:VkDebugUtilsMessengerCreateInfoEXT::pname:pfnUserCallback is
 called.
-The process to determine if the user's pfnUserCallback is triggered when an
+The process to determine if the user's pname:pfnUserCallback is triggered
-event occurs is as follows:
+when an event occurs is as follows:
 
  . The implementation will perform a bitwise AND of the event's
    elink:VkDebugUtilsMessageSeverityFlagBitsEXT with the

chapters/VK_KHR_incremental_present/wsi.txt

@@ -37,8 +37,8 @@ include::../../api/structs/VkPresentRegionsKHR.txt[]
   * [[VUID-VkPresentRegionsKHR-swapchainCount-01260]]
     pname:swapchainCount must: be the same value as
     sname:VkPresentInfoKHR::pname:swapchainCount, where
-    sname:VkPresentInfoKHR is in the pNext-chain of this
+    sname:VkPresentInfoKHR is in the pname:pNext chain of this
-    sname:VkPresentRegionsKHR structure.
+    sname:VkPresentRegionsKHR structure
 ****
 
 include::../../validity/structs/VkPresentRegionsKHR.txt[]

chapters/VK_NN_vi_surface/platformCreateSurface_vi.txt

@@ -32,7 +32,7 @@ will reflect that size.
 In this case, applications should use the same size for the swapchain's
 pname:imageExtent.
 Otherwise, the pname:currentExtent will have the special value
-[eq]#(0xFFFFFFFF, 0xFFFFFFFF), indicating that applications are expected to
+[eq]#(0xFFFFFFFF, 0xFFFFFFFF)#, indicating that applications are expected to
 choose an appropriate size for the swapchain's pname:imageExtent (e.g., by
 matching the result of a call to
 code:nn::code:vi::code:GetDisplayResolution).

chapters/VK_NVX_device_generated_commands/generation.txt

@@ -116,42 +116,42 @@ include::../../api/structs/VkCmdProcessCommandsInfoNVX.txt[]
 ****
   * [[VUID-VkCmdProcessCommandsInfoNVX-objectTable-01331]]
     The provided pname:objectTable must: include all objects referenced by
-    the generation process.
+    the generation process
   * [[VUID-VkCmdProcessCommandsInfoNVX-indirectCommandsTokenCount-01332]]
     pname:indirectCommandsTokenCount must: match the
-    pname:indirectCommandsLayout's pname:tokenCount.
+    pname:indirectCommandsLayout's pname:tokenCount
   * [[VUID-VkCmdProcessCommandsInfoNVX-tokenType-01333]]
     The pname:tokenType member of each entry in the
     pname:pIndirectCommandsTokens array must: match the values used at
     creation time of pname:indirectCommandsLayout
   * [[VUID-VkCmdProcessCommandsInfoNVX-targetCommandBuffer-01334]]
     If pname:targetCommandBuffer is provided, it must: have reserved command
-    space.
+    space
   * [[VUID-VkCmdProcessCommandsInfoNVX-targetCommandBuffer-01335]]
     If pname:targetCommandBuffer is provided, the pname:objectTable must:
-    match the reservation's objectTable and must: have had all referenced
+    match the reservation's pname:objectTable and must: have had all
-    objects registered at reservation time.
+    referenced objects registered at reservation time
   * [[VUID-VkCmdProcessCommandsInfoNVX-targetCommandBuffer-01336]]
     If pname:targetCommandBuffer is provided, the
     pname:indirectCommandsLayout must: match the reservation's
-    indirectCommandsLayout.
+    pname:indirectCommandsLayout
   * [[VUID-VkCmdProcessCommandsInfoNVX-targetCommandBuffer-01337]]
     If pname:targetCommandBuffer is provided, the pname:maxSequencesCount
-    must: not exceed the reservation's maxSequencesCount.
+    must: not exceed the reservation's pname:maxSequencesCount
   * [[VUID-VkCmdProcessCommandsInfoNVX-sequencesCountBuffer-01338]]
     If pname:sequencesCountBuffer is used, its usage flag must: have
-    ename:VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set.
+    the ename:VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set
   * [[VUID-VkCmdProcessCommandsInfoNVX-sequencesCountBuffer-01339]]
     If pname:sequencesCountBuffer is used, pname:sequencesCountOffset must:
     be aligned to
-    sname:VkDeviceGeneratedCommandsLimitsNVX::pname:minSequenceCountBufferOffsetAlignment.
+    sname:VkDeviceGeneratedCommandsLimitsNVX::pname:minSequenceCountBufferOffsetAlignment
   * [[VUID-VkCmdProcessCommandsInfoNVX-sequencesIndexBuffer-01340]]
     If pname:sequencesIndexBuffer is used, its usage flag must: have
-    ename:VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set.
+    the ename:VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set
   * [[VUID-VkCmdProcessCommandsInfoNVX-sequencesIndexBuffer-01341]]
     If pname:sequencesIndexBuffer is used, pname:sequencesIndexOffset must:
     be aligned to
-    sname:VkDeviceGeneratedCommandsLimitsNVX::pname:minSequenceIndexBufferOffsetAlignment.
+    sname:VkDeviceGeneratedCommandsLimitsNVX::pname:minSequenceIndexBufferOffsetAlignment
 ****
 
 include::../../validity/structs/VkCmdProcessCommandsInfoNVX.txt[]

chapters/descriptorsets.txt

@@ -3818,8 +3818,8 @@ include::../api/protos/vkCmdPushDescriptorSetWithTemplateKHR.txt[]
 
   * pname:commandBuffer is the command buffer that the descriptors will be
     recorded in.
-  * pname:descriptorUpdateTemplate A descriptor update template which
+  * pname:descriptorUpdateTemplate is a descriptor update template that
-    defines how to interpret the descriptor information in pData.
+    defines how to interpret the descriptor information in pname:pData.
   * pname:layout is a slink:VkPipelineLayout object used to program the
     bindings.
     It must: be compatible with the layout used to create the
@@ -3828,15 +3828,15 @@ include::../api/protos/vkCmdPushDescriptorSetWithTemplateKHR.txt[]
     that will be updated.
     This must: be the same number used to create the
     pname:descriptorUpdateTemplate handle.
-  * pname:pData Points to memory which contains the descriptors for the
+  * pname:pData points to memory which contains the descriptors for the
     templated update.
 
 .Valid Usage
 ****
   * [[VUID-vkCmdPushDescriptorSetWithTemplateKHR-commandBuffer-00366]]
-    The pipelineBindPoint specified during the creation of the descriptor
+    The pname:pipelineBindPoint specified during the creation of the
-    update template must: be supported by the pname:commandBuffer's parent
+    descriptor update template must: be supported by the
-    sname:VkCommandPool's queue family
+    pname:commandBuffer's parent sname:VkCommandPool's queue family
   * [[VUID-vkCmdPushDescriptorSetWithTemplateKHR-pData-01686]]
     pname:pData must: be a valid pointer to a memory that contains one or
     more valid instances of slink:VkDescriptorImageInfo,

chapters/dispatch.txt

@@ -30,8 +30,8 @@ include::../api/protos/vkCmdDispatch.txt[]
     dimension.
 
 When the command is executed, a global workgroup consisting of
-[eq]#groupCountX {times} groupCountY {times} groupCountZ# local workgroups
+[eq]#pname:groupCountX {times} pname:groupCountY {times} pname:groupCountZ#
-is assembled.
+local workgroups is assembled.
 
 .Valid Usage
 ****
@@ -352,9 +352,10 @@ endif::VK_KHR_device_group[]
     dimension.
 
 When the command is executed, a global workgroup consisting of
-[eq]#groupCountX {times} groupCountY {times} groupCountZ# local workgroups
+[eq]#pname:groupCountX {times} pname:groupCountY {times} pname:groupCountZ#
-is assembled, with code:WorkgroupId values ranging from [eq]#[baseGroup,
+local workgroups is assembled, with code:WorkgroupId values ranging from
-baseGroup {plus} groupCount)# in each component.
+[eq]#[ptext:baseGroup*, ptext:baseGroup* {plus} ptext:groupCount*)# in each
+component.
 flink:vkCmdDispatch is equivalent to
 `vkCmdDispatchBase(0,0,0,groupCountX,groupCountY,groupCountZ)`.
 

chapters/drawing.txt

@@ -777,9 +777,9 @@ The assembled primitives execute the bound graphics pipeline.
     ename:VK_PIPELINE_BIND_POINT_GRAPHICS requires any dynamic state, that
     state must: have been set on the current command buffer
   * [[VUID-vkCmdDrawIndexed-indexSize-00463]]
-    [eq]#(pname:indexSize * (pname:firstIndex {plus} pname:indexCount)
+    [eq]#(code:indexSize * (pname:firstIndex {plus} pname:indexCount)
     {plus} pname:offset)# must: be less than or equal to the size of the
-    bound index buffer, with indexSize being based on the type specified by
+    bound index buffer, with code:indexSize being based on the type specified by
     pname:indexType, where the index buffer, pname:indexType, and
     pname:offset are specified via fname:vkCmdBindIndexBuffer
   * [[VUID-vkCmdDrawIndexed-None-00464]]
@@ -1773,9 +1773,9 @@ the similarly named parameters of flink:vkCmdDrawIndexed.
     entirely contained within the corresponding vertex buffer binding, as
     described in <<fxvertex-input>>
   * [[VUID-VkDrawIndexedIndirectCommand-indexSize-00553]]
-    [eq]#(pname:indexSize * (pname:firstIndex {plus} pname:indexCount)
+    [eq]#(code:indexSize * (pname:firstIndex {plus} pname:indexCount)
     {plus} pname:offset)# must: be less than or equal to the size of the
-    bound index buffer, with pname:indexSize being based on the type
+    bound index buffer, with code:indexSize being based on the type
     specified by pname:indexType, where the index buffer, pname:indexType,
     and pname:offset are specified via fname:vkCmdBindIndexBuffer
   * [[VUID-VkDrawIndexedIndirectCommand-firstInstance-00554]]

chapters/features.txt

@@ -4292,7 +4292,7 @@ whether or not the feature is enabled.
 | code:uint32_t            | pname:maxMemoryAllocationCount             | -
 | code:uint32_t            | pname:maxSamplerAllocationCount            | -
 | basetype:VkDeviceSize    | pname:bufferImageGranularity               | -
-| basetype:VkDeviceSize    | pname:sparseAddressSpaceSize               | sparseBinding
+| basetype:VkDeviceSize    | pname:sparseAddressSpaceSize               | pname:sparseBinding
 | code:uint32_t            | pname:maxBoundDescriptorSets               | -
 | code:uint32_t            | pname:maxPerStageDescriptorSamplers        | -
 | code:uint32_t            | pname:maxPerStageDescriptorUniformBuffers  | -

chapters/fragops.txt

@@ -1367,8 +1367,8 @@ each be modulated (multiplied) by that color sample's associated value of
 Which components are modulated is controlled by
 pname:coverageModulationMode.
 
-If this structure is not present, it is as if coverageModulationMode is
+If this structure is not present, it is as if pname:coverageModulationMode
-ename:VK_COVERAGE_MODULATION_MODE_NONE_NV.
+is ename:VK_COVERAGE_MODULATION_MODE_NONE_NV.
 
 .Valid Usage
 ****

chapters/interfaces.txt

@@ -389,11 +389,11 @@ not be two output variables which have the same location, component, and
 index, either explicitly declared or implied.
 
 Output values written by a fragment shader must: be declared with either
-code:OpTypeFloat or code:OpTypeInt, and a Width of 32.
+code:OpTypeFloat or code:OpTypeInt, and a code:Width of 32.
 ifdef::VK_VERSION_1_1,VK_KHR_16bit_storage[]
 If pname:storageInputOutput16 is supported, output values written by a
 fragment shader can: be also declared with either code:OpTypeFloat or
-code:OpTypeInt and a Width of 16.
+code:OpTypeInt and a code:Width of 16.
 endif::VK_VERSION_1_1,VK_KHR_16bit_storage[]
 Composites of these types are also permitted.
 If the color attachment has a signed or unsigned normalized fixed-point
@@ -1228,7 +1228,7 @@ The code:BaseVertex decoration must: be used only within vertex shaders.
 The variable decorated with code:BaseVertex must: be declared using the
 input storage class.
 +
-The variable decorated with codeBaseVertex must: be declared as a scalar
+The variable decorated with code:BaseVertex must: be declared as a scalar
 32-bit integer.
 
 endif::VK_VERSION_1_1,VK_KHR_shader_draw_parameters[]

chapters/memory.txt

@@ -3170,7 +3170,7 @@ endif::VK_KHR_device_group[]
   * [[VUID-vkGetDeviceGroupPeerMemoryFeatures-remoteDeviceIndex-00693]]
     pname:remoteDeviceIndex must: be a valid device index
   * [[VUID-vkGetDeviceGroupPeerMemoryFeatures-localDeviceIndex-00694]]
-    pname:localDeviceIndex must: not equal remoteDeviceIndex
+    pname:localDeviceIndex must: not equal pname:remoteDeviceIndex
 ****
 
 include::../validity/protos/vkGetDeviceGroupPeerMemoryFeatures.txt[]

chapters/renderpass.txt

@@ -638,7 +638,7 @@ endif::VK_KHR_maintenance2[]
   * pname:sType is the type of this structure.
   * pname:pNext is `NULL` or a pointer to an extension-specific structure.
   * pname:aspectReferenceCount is the number of elements in the
-    pAspectReferences array.
+    pname:pAspectReferences array.
   * pname:pAspectReferences points to an array of pname:aspectReferenceCount
     number of slink:VkInputAttachmentAspectReference structures describing
     which aspect(s) can: be accessed for a given input attachment within a

chapters/resources.txt

@@ -3531,13 +3531,13 @@ a render pass instance still apply to the entire subresource referenced
 which includes all the slices of the selected mip level.
 endif::VK_VERSION_1_1,VK_KHR_maintenance1[]
 
-When using an imageView of a depth/stencil image to populate a descriptor
+When using an image view of a depth/stencil image to populate a descriptor
 set (e.g. for sampling in the shader, or for use as an input attachment),
 the pname:aspectMask must: only include one bit and selects whether the
-imageView is used for depth reads (i.e. using a floating-point sampler or
+image view is used for depth reads (i.e. using a floating-point sampler or
 input attachment in the shader) or stencil reads (i.e. using an unsigned
 integer sampler or input attachment in the shader).
-When an imageView of a depth/stencil image is used as a depth/stencil
+When an image view of a depth/stencil image is used as a depth/stencil
 framebuffer attachment, the pname:aspectMask is ignored and both depth and
 stencil image subresources are used.
 

chapters/sparsemem.txt

@@ -1471,8 +1471,9 @@ binding range specified must: be within the mip tail region of the metadata
 aspect.
 In this case the pname:resourceOffset is not required: to be a simple device
 address offset within the resource.
-However, it _is_ defined to be within [eq]#[imageMipTailOffset,
+However, it _is_ defined to be within [eq]#[pname:imageMipTailOffset,
-imageMipTailOffset {plus} imageMipTailSize)# for the metadata aspect.
+pname:imageMipTailOffset {plus} pname:imageMipTailSize)# for the metadata
+aspect.
 See slink:VkSparseMemoryBind for the full constraints on binding region with
 this flag present.
 ====
@@ -1498,7 +1499,7 @@ include::../api/structs/VkSparseImageMemoryBindInfo.txt[]
 
   * pname:image is the slink:VkImage object to be bound
   * pname:bindCount is the number of slink:VkSparseImageMemoryBind
-    structures in pBinds array
+    structures in pname:pBinds array
   * pname:pBinds is a pointer to array of slink:VkSparseImageMemoryBind
     structures
 
@@ -1524,7 +1525,8 @@ The sname:VkSparseImageMemoryBind structure is defined as:
 
 include::../api/structs/VkSparseImageMemoryBind.txt[]
 
-  * pname:subresource is the aspectMask and region of interest in the image.
+  * pname:subresource is the image _aspect_ and region of interest in the
+    image.
   * pname:offset are the coordinates of the first texel within the image
     subresource to bind.
   * pname:extent is the size in texels of the region within the image

config/vulkan-macros/extension.rb

@@ -204,7 +204,7 @@ end
 
 class CodeInlineMacro < StrongInlineMacroBase
     named :code
-    match /code:(\w+)/
+    match /code:(\w+(\.\w+)*)/
 end
 
 # The tag: and attr: macros are only used in registry.txt