Updated documentation for WebGPU backend interfaces

Author: TheMostDiligent

Graphics/GraphicsEngineWebGPU/interface/BufferWebGPU.h

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2023-2024 Diligent Graphics LLC
+ *  Copyright 2023-2025 Diligent Graphics LLC
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -49,6 +49,8 @@ static DILIGENT_CONSTEXPR INTERFACE_ID IID_BufferWebGPU =
 /// Exposes WebGPU-specific functionality of a buffer object.
 DILIGENT_BEGIN_INTERFACE(IBufferWebGPU, IBuffer)
 {
+    /// Returns WebGPU buffer handle.
+
     /// The application must not destroy the returned buffer
     /// Returns a WebGPU handle of the internal buffer object.
     VIRTUAL WGPUBuffer METHOD(GetWebGPUBuffer)(THIS) CONST PURE;

Graphics/GraphicsEngineWebGPU/interface/PipelineStateWebGPU.h

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2024 Diligent Graphics LLC
+ *  Copyright 2024-2025 Diligent Graphics LLC
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -47,10 +47,10 @@ static DILIGENT_CONSTEXPR INTERFACE_ID IID_PipelineStateWebGPU =
 /// Exposes WebGPU-specific functionality of a pipeline state object.
 DILIGENT_BEGIN_INTERFACE(IPipelineStateWebGPU, IPipelineState)
 {
-    /// Returns a pointer to WebGPU render pipeline (WGPURenderPipeline)
+    /// Returns a pointer to WebGPU render pipeline (`WGPURenderPipeline`)
     VIRTUAL WGPURenderPipeline METHOD(GetWebGPURenderPipeline)(THIS) CONST PURE;
 
-    /// Returns a pointer to WebGPU compute pipeline (WGPUComputePipeline)
+    /// Returns a pointer to WebGPU compute pipeline (`WGPUComputePipeline`)
     VIRTUAL WGPUComputePipeline METHOD(GetWebGPUComputePipeline)(THIS) CONST PURE;
 };
 DILIGENT_END_INTERFACE

Graphics/GraphicsEngineWebGPU/interface/RenderDeviceWebGPU.h

@@ -67,6 +67,7 @@ DILIGENT_BEGIN_INTERFACE(IRenderDeviceWebGPU, IRenderDevice)
     ///                             texture interface will be stored.
     ///                             The function calls AddRef(), so that the new object will contain
     ///                             one reference.
+    ///
     /// \note  Created texture object does not take ownership of the WebGPU texture and will not
     ///        destroy it once released. The application must not destroy the image while it is
     ///        in use by the engine.
@@ -87,6 +88,7 @@ DILIGENT_BEGIN_INTERFACE(IRenderDeviceWebGPU, IRenderDevice)
     ///                             buffer interface will be stored.
     ///                             The function calls AddRef(), so that the new object will contain
     ///                             one reference.
+    ///
     /// \note  Created buffer object does not take ownership of the WebGPU buffer and will not
     ///        destroy it once released. The application must not destroy Vulkan buffer while it is
     ///        in use by the engine.

Graphics/GraphicsEngineWebGPU/interface/ShaderWebGPU.h

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2024 Diligent Graphics LLC
+ *  Copyright 2024-2025 Diligent Graphics LLC
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -55,11 +55,13 @@ class IShaderWebGPU : public IShader
     /// Returns WGSL source code
     virtual const std::string& DILIGENT_CALL_TYPE GetWGSL() const = 0;
 
-    /// Returns a suffix to append to the name of emulated array variables to get
+    /// Returns emulated array index suffix
+
+    /// Returns a suffix to append to the name of an emulated array variables to get
     /// the indexed array element name.
     ///
-    /// \remarks    This value is defined by ShaderCI.WebGPUEmulatedArrayIndexSuffix,
-    ///             see Diligent::ShaderCreateInfo::WebGPUEmulatedArrayIndexSuffix.
+    /// This value is defined by `ShaderCI.WebGPUEmulatedArrayIndexSuffix`,
+    /// see Diligent::ShaderCreateInfo::WebGPUEmulatedArrayIndexSuffix.
     virtual const char* DILIGENT_CALL_TYPE GetEmulatedArrayIndexSuffix() const = 0;
 };
 

Graphics/GraphicsEngineWebGPU/interface/TextureWebGPU.h

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2023-2024 Diligent Graphics LLC
+ *  Copyright 2023-2025 Diligent Graphics LLC
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -50,6 +50,7 @@ static DILIGENT_CONSTEXPR INTERFACE_ID IID_TextureWebGPU =
 DILIGENT_BEGIN_INTERFACE(ITextureWebGPU, ITexture)
 {
     /// Returns WebGPU texture handle.
+
     /// The application must not destroy the returned texture
     VIRTUAL WGPUTexture METHOD(GetWebGPUTexture)(THIS) CONST PURE;