A whole lot of more rhi docs

examples/rhi/imguidemo/imgui/qt_attribution.json

@@ -4,7 +4,7 @@
         "Name": "Dear ImGui",
         "QDocModule": "qtrhi",
         "Description": "Dear ImGui",
-        "QtUsage": "Bloat-free GUI library for in-scene visualization of profiling and debugging data",
+        "QtUsage": "Used in examples to demo integration of an external GUI library.",
 
         "Homepage": "https://github.com/ocornut/imgui",
         "Version": "v1.66b",

src/3rdparty/SPIRV-Cross/qt_attribution.json

@@ -3,8 +3,8 @@
         "Id": "SpirvCross",
         "Name": "SPIRV-Cross",
         "QDocModule": "qtshadertools",
-        "Description": "A practical tool and library for performing reflection on SPIR-V and disassembling SPIR-V back to high level languages",
-        "QtUsage": "Shader code generation",
+        "Description": "A practical tool and library for performing reflection on SPIR-V and disassembling SPIR-V back to high level languages.",
+        "QtUsage": "Shader code generation.",
 
         "Homepage": "https://github.com/KhronosGroup/SPIRV-Cross",
         "Version": "bfeb388edfb63c9a927e517b634abaaa5bfb1caf",

src/3rdparty/VulkanMemoryAllocator/qt_attribution.json

@@ -4,7 +4,7 @@
         "Name": "Vulkan Memory Allocator",
         "QDocModule": "qtrhi",
         "Description": "Vulkan Memory Allocator",
-        "QtUsage": "Memory management for the Vulkan backend",
+        "QtUsage": "Memory management for the Vulkan backend of QRhi.",
 
         "Homepage": "https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator",
         "Version": "2.1.0",

src/3rdparty/glslang/qt_attribution.json

@@ -4,7 +4,7 @@
         "Name": "glslang",
         "QDocModule": "qtshadertools",
         "Description": "An OpenGL and OpenGL ES shader front end and validator.",
-        "QtUsage": "Compile Vulkan-flavor GLSL to SPIR-V",
+        "QtUsage": "Compile GLSL to SPIR-V.",
 
         "Homepage": "https://github.com/KhronosGroup/glslang",
         "Version": "816bc4447ce58c048a40e3f2a3a46b4d1019083b",

src/rhi/qrhi.h

@@ -74,7 +74,7 @@ class QRhiProfiler;
 //   5. Ownership of resources imported (QRhi*InitParams or buildFrom()) or exported (nativeHandles()) is never taken or given away.
 //
 // Other:
-//   1. QRhiResourceUpdateBatch manages no graphics resources underneath. beginPass() implicitly calls release() on the batch.
+//   1. QRhiResourceUpdateBatch manages no graphics resources underneath. begin/endPass() implicitly calls release() on the batch.
 
 struct Q_RHI_EXPORT QRhiColorClearValue
 {

src/rhi/qrhigles2.cpp

@@ -68,6 +68,11 @@ QT_BEGIN_NAMESPACE
     QWindow the first QRhiSwapChain will target is passed in as well.
 
     \badcode
+        QSurfaceFormat format;
+        format.setDepthBufferSize(24);
+        format.setStencilBufferSize(8);
+        QSurfaceFormat::setDefaultFormat(format);
+
         context = new QOpenGLContext;
         if (!context->create())
             qFatal("Failed to get OpenGL context");