diff --git a/girs/GstVulkan-1.0.gir b/girs/GstVulkan-1.0.gir
index e917d91852..671c25ff59 100644
--- a/girs/GstVulkan-1.0.gir
+++ b/girs/GstVulkan-1.0.gir
@@ -4594,8 +4594,8 @@ hold the same semaphores but increasing their current value.</doc>
     gst_vulkan_operation_new_extra_image_barriers() and
     gst_vulkan_operation_update_frame()
 
-Any non-repeated image barrier in @extra is appended to the internal barrier
-list.
+Any non-repeated image barrier in @extra_barriers is appended to the internal
+barrier list.
 
 Remember to call gst_vulkan_operation_update_frame() on those frames with
 images in @extra_barriers.</doc>
@@ -4683,7 +4683,7 @@ called internally if something failed.</doc>
         </parameters>
       </method>
       <method name="begin_query" c:identifier="gst_vulkan_operation_begin_query">
-        <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c">Begins a query operation in the current command buffer.</doc>
+        <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c">Begins a query operation with @id in the current command buffer.</doc>
         <source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.h"/>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c">whether the begin command was set</doc>
@@ -4695,6 +4695,7 @@ called internally if something failed.</doc>
             <type name="VulkanOperation" c:type="GstVulkanOperation*"/>
           </instance-parameter>
           <parameter name="id" transfer-ownership="none">
+            <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c">query id</doc>
             <type name="guint32" c:type="guint32"/>
           </parameter>
         </parameters>
@@ -4762,7 +4763,8 @@ gst_vulkan_operation_reset() is called internally if something fails</doc>
         </parameters>
       </method>
       <method name="end_query" c:identifier="gst_vulkan_operation_end_query">
-        <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c">Ends a query operation in the current command buffer.</doc>
+        <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c">Ends a query operation with @id in the current command buffer. A query with
+@id has had started with gst_vulkan_operation_begin_query()</doc>
         <source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.h"/>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c">whether the end command was set</doc>
@@ -4774,6 +4776,7 @@ gst_vulkan_operation_reset() is called internally if something fails</doc>
             <type name="VulkanOperation" c:type="GstVulkanOperation*"/>
           </instance-parameter>
           <parameter name="id" transfer-ownership="none">
+            <doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c">query id</doc>
             <type name="guint32" c:type="guint32"/>
           </parameter>
         </parameters>
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c b/subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c
index 1bcb6a2a3e..5931fce6fb 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/vulkan/gstvkoperation.c
@@ -784,8 +784,8 @@ gst_vulkan_operation_new_extra_image_barriers (GstVulkanOperation * self)
  *     gst_vulkan_operation_new_extra_image_barriers() and
  *     gst_vulkan_operation_update_frame()
  *
- * Any non-repeated image barrier in @extra is appended to the internal barrier
- * list.
+ * Any non-repeated image barrier in @extra_barriers is appended to the internal
+ * barrier list.
  *
  * Remember to call gst_vulkan_operation_update_frame() on those frames with
  * images in @extra_barriers.
@@ -1333,8 +1333,9 @@ gst_vulkan_operation_get_query (GstVulkanOperation * self, gpointer * result,
 /**
  * gst_vulkan_operation_begin_query:
  * @self: a #GstVulkanOperation
+ * @id: query id
  *
- * Begins a query operation in the current command buffer.
+ * Begins a query operation with @id in the current command buffer.
  *
  * Returns: whether the begin command was set
  */
@@ -1364,8 +1365,10 @@ gst_vulkan_operation_begin_query (GstVulkanOperation * self, guint32 id)
 /**
  * gst_vulkan_operation_end_query:
  * @self: a #GstVulkanOperation
+ * @id: query id
  *
- * Ends a query operation in the current command buffer.
+ * Ends a query operation with @id in the current command buffer. A query with
+ * @id has had started with gst_vulkan_operation_begin_query()
  *
  * Returns: whether the end command was set
  */