diff --git a/include/bgfx/bgfx.h b/include/bgfx/bgfx.h
index 4d769332d..3e1bdc689 100644
--- a/include/bgfx/bgfx.h
+++ b/include/bgfx/bgfx.h
@@ -2468,9 +2468,8 @@ namespace bgfx
 
 	/// Allocate transient index buffer.
 	///
-	/// @param[out] _tib TransientIndexBuffer structure is filled and is valid
-	///   for the duration of frame, and it can be reused for multiple draw
-	///   calls.
+	/// @param[out] _tib TransientIndexBuffer structure will be filled, and will be valid
+	///   for the duration of frame, and can be reused for multiple draw calls.
 	/// @param[in] _num Number of indices to allocate.
 	/// @param[in] _index32 Set to `true` if input indices will be 32-bit.
 	///
@@ -2484,9 +2483,8 @@ namespace bgfx
 
 	/// Allocate transient vertex buffer.
 	///
-	/// @param[out] _tvb TransientVertexBuffer structure is filled and is valid
-	///   for the duration of frame, and it can be reused for multiple draw
-	///   calls.
+	/// @param[out] _tvb TransientVertexBuffer structure will be filled, and will be valid
+	///   for the duration of frame, and can be reused for multiple draw calls.
 	/// @param[in] _num Number of vertices to allocate.
 	/// @param[in] _layout Vertex layout.
 	///
@@ -2502,14 +2500,12 @@ namespace bgfx
 	/// buffers. If both space requirements are satisfied function returns
 	/// true.
 	///
-	/// @param[out] _tvb TransientVertexBuffer structure is filled and is valid
-	///   for the duration of frame, and it can be reused for multiple draw
-	///   calls.
+	/// @param[out] _tvb TransientVertexBuffer structure will be filled, and will be valid
+	///   for the duration of frame, and can be reused for multiple draw calls.
 	/// @param[in] _layout Vertex layout.
 	/// @param[in] _numVertices Number of vertices to allocate.
-	/// @param[out] _tib TransientIndexBuffer structure is filled and is valid
-	///   for the duration of frame, and it can be reused for multiple draw
-	///   calls.
+	/// @param[out] _tib TransientIndexBuffer structure will be filled, and will be valid
+	///   for the duration of frame, and can be reused for multiple draw calls.
 	/// @param[in] _numIndices Number of indices to allocate.
 	/// @param[in] _index32 Set to `true` if input indices will be 32-bit.
 	///
@@ -2526,9 +2522,8 @@ namespace bgfx
 
 	/// Allocate instance data buffer.
 	///
-	/// @param[out] _idb InstanceDataBuffer structure is filled and is valid
-	///   for duration of frame, and it can be reused for multiple draw
-	///   calls.
+	/// @param[out] _idb InstanceDataBuffer structure will be filled, and will be valid
+	///   for the duration of frame, and can be reused for multiple draw calls.
 	/// @param[in] _num Number of instances.
 	/// @param[in] _stride Instance stride. Must be multiple of 16.
 	///