From 975f42b7b2be13702e4ba1a936c478a4fb5e00be Mon Sep 17 00:00:00 2001 From: Campbell Barton Date: Fri, 12 Sep 2025 10:19:56 +1000 Subject: [PATCH] Cleanup: use doxygen comments to end groups --- intern/ghost/intern/GHOST_ContextVK.cc | 8 +++++--- .../intern/GHOST_XrGraphicsBindingD3D.cc | 6 +++--- .../intern/GHOST_XrGraphicsBindingVulkan.cc | 8 ++++---- .../intern/grease_pencil_convert_legacy.cc | 2 +- .../blenkernel/intern/idprop_create.cc | 2 +- .../blenkernel/intern/idprop_serialize.cc | 7 ++++--- source/blender/gpu/tests/texture_test.cc | 19 ++++++++++--------- .../blender/gpu/vulkan/vk_data_conversion.cc | 6 +++--- .../blender/gpu/vulkan/vk_data_conversion.hh | 2 +- source/blender/gpu/vulkan/vk_pipeline_pool.cc | 2 +- .../makesrna/intern/rna_sculpt_paint.cc | 2 +- 11 files changed, 34 insertions(+), 30 deletions(-) diff --git a/intern/ghost/intern/GHOST_ContextVK.cc b/intern/ghost/intern/GHOST_ContextVK.cc index c79990ac6d8..7b7f71d67d1 100644 --- a/intern/ghost/intern/GHOST_ContextVK.cc +++ b/intern/ghost/intern/GHOST_ContextVK.cc @@ -136,7 +136,7 @@ void GHOST_Frame::destroy(VkDevice vk_device) discard_pile.destroy(vk_device); } -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Extension list @@ -207,7 +207,7 @@ struct GHOST_ExtensionsVK { } }; -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Vulkan Device @@ -318,6 +318,8 @@ class GHOST_DeviceVK { } }; +/** \} */ + /* -------------------------------------------------------------------- */ /** \name Vulkan Instance * \{ */ @@ -616,7 +618,7 @@ struct GHOST_InstanceVK { } }; -/* \} */ +/** \} */ /** * A shared device between multiple contexts. diff --git a/intern/ghost/intern/GHOST_XrGraphicsBindingD3D.cc b/intern/ghost/intern/GHOST_XrGraphicsBindingD3D.cc index a965f19569d..fe733b0734e 100644 --- a/intern/ghost/intern/GHOST_XrGraphicsBindingD3D.cc +++ b/intern/ghost/intern/GHOST_XrGraphicsBindingD3D.cc @@ -200,7 +200,7 @@ bool GHOST_XrGraphicsBindingD3D::needsUpsideDownDrawing(GHOST_Context &) const return ghost_d3d_ctx_->isUpsideDown(); } -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name OpenGL-Direct3D bridge @@ -260,7 +260,7 @@ void GHOST_XrGraphicsBindingOpenGLD3D::submitToSwapchainImage( #endif } -/* \} */ +/** \} */ #ifdef WITH_VULKAN_BACKEND @@ -331,6 +331,6 @@ void GHOST_XrGraphicsBindingVulkanD3D::submitToSwapchainImage( ghost_ctx_.openxr_release_framebuffer_image_callback_(&openxr_data); } -/* \} */ +/** \} */ #endif diff --git a/intern/ghost/intern/GHOST_XrGraphicsBindingVulkan.cc b/intern/ghost/intern/GHOST_XrGraphicsBindingVulkan.cc index b4b85eac451..83dcd217347 100644 --- a/intern/ghost/intern/GHOST_XrGraphicsBindingVulkan.cc +++ b/intern/ghost/intern/GHOST_XrGraphicsBindingVulkan.cc @@ -37,7 +37,7 @@ GHOST_XrGraphicsBindingVulkan::GHOST_XrGraphicsBindingVulkan(GHOST_Context &ghos { } -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Destroying resources. @@ -97,7 +97,7 @@ GHOST_XrGraphicsBindingVulkan::~GHOST_XrGraphicsBindingVulkan() s_xrCreateVulkanDeviceKHR_fn = nullptr; } -/* \} */ +/** \} */ bool GHOST_XrGraphicsBindingVulkan::checkVersionRequirements(GHOST_Context &ghost_ctx, XrInstance instance, @@ -557,7 +557,7 @@ void GHOST_XrGraphicsBindingVulkan::submitToSwapchainImageCpu( ghost_ctx_.openxr_release_framebuffer_image_callback_(&openxr_data); } -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Data transfer GPU @@ -772,7 +772,7 @@ void GHOST_XrGraphicsBindingVulkan::submitToSwapchainImageGpu( vkResetCommandBuffer(vk_command_buffer, 0); } -/* \} */ +/** \} */ bool GHOST_XrGraphicsBindingVulkan::needsUpsideDownDrawing(GHOST_Context &ghost_ctx) const { diff --git a/source/blender/blenkernel/intern/grease_pencil_convert_legacy.cc b/source/blender/blenkernel/intern/grease_pencil_convert_legacy.cc index 7f38fa2be40..83faf47d0ca 100644 --- a/source/blender/blenkernel/intern/grease_pencil_convert_legacy.cc +++ b/source/blender/blenkernel/intern/grease_pencil_convert_legacy.cc @@ -631,7 +631,7 @@ class AnimDataConvertor { } }; -/* \} */ +/** \} */ /** * Find vertex groups that have assigned vertices in this drawing. diff --git a/source/blender/blenkernel/intern/idprop_create.cc b/source/blender/blenkernel/intern/idprop_create.cc index 47f06613e0b..659b86a2496 100644 --- a/source/blender/blenkernel/intern/idprop_create.cc +++ b/source/blender/blenkernel/intern/idprop_create.cc @@ -156,6 +156,6 @@ std::unique_ptr create_group(const StringRef prop return std::unique_ptr(property); } -/* \} */ +/** \} */ } // namespace blender::bke::idprop diff --git a/source/blender/blenkernel/intern/idprop_serialize.cc b/source/blender/blenkernel/intern/idprop_serialize.cc index 762b470f144..5342fe80026 100644 --- a/source/blender/blenkernel/intern/idprop_serialize.cc +++ b/source/blender/blenkernel/intern/idprop_serialize.cc @@ -788,11 +788,12 @@ static const IDPropertySerializer &serializer_for(StringRef idprop_typename) return IDP_SERIALIZER_UNKNOWN; } -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name IDProperty to Value * \{ */ + std::unique_ptr convert_to_serialize_values(const IDProperty *properties) { BLI_assert(properties != nullptr); @@ -810,7 +811,7 @@ std::unique_ptr convert_to_serialize_values(const IDProperty *proper return result; } -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name IDProperty from Value @@ -866,6 +867,6 @@ IDProperty *convert_from_serialize_value(const Value &value) return idprop_from_value(*value.as_array_value()); } -/* \} */ +/** \} */ } // namespace blender::bke::idprop diff --git a/source/blender/gpu/tests/texture_test.cc b/source/blender/gpu/tests/texture_test.cc index d96da49c213..d1313ca3f61 100644 --- a/source/blender/gpu/tests/texture_test.cc +++ b/source/blender/gpu/tests/texture_test.cc @@ -673,7 +673,7 @@ static void test_texture_roundtrip__GPU_DATA_FLOAT__GPU_DEPTH_COMPONENT16() GPU_TEST(texture_roundtrip__GPU_DATA_FLOAT__GPU_DEPTH_COMPONENT16); #endif -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Round-trip testing GPU_DATA_HALF_FLOAT @@ -705,7 +705,7 @@ static void test_texture_roundtrip__GPU_DATA_HALF_FLOAT__GPU_RGB16F() GPU_TEST(texture_roundtrip__GPU_DATA_HALF_FLOAT__GPU_RGB16F); #endif -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Round-trip testing GPU_DATA_INT @@ -787,7 +787,7 @@ static void test_texture_roundtrip__GPU_DATA_INT__GPU_RGB32I() GPU_TEST(texture_roundtrip__GPU_DATA_INT__GPU_RGB32I); #endif -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Round-trip testing GPU_DATA_UINT @@ -887,7 +887,7 @@ static void test_texture_roundtrip__GPU_DATA_UINT__GPU_DEPTH_COMPONENT16() GPU_TEST(texture_roundtrip__GPU_DATA_UINT__GPU_DEPTH_COMPONENT16); #endif -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Round-trip testing GPU_DATA_UBYTE @@ -954,7 +954,8 @@ static void test_texture_roundtrip__GPU_DATA_UBYTE__GPU_SRGB8() } GPU_TEST(texture_roundtrip__GPU_DATA_UBYTE__GPU_SRGB8); #endif -/* \} */ + +/** \} */ /* -------------------------------------------------------------------- */ /** \name Round-trip testing GPU_DATA_UINT_24_8_DEPRECATED @@ -970,7 +971,7 @@ static void test_texture_roundtrip__GPU_DATA_UINT_24_8__GPU_DEPTH32F_STENCIL8() GPU_TEST(texture_roundtrip__GPU_DATA_UINT_24_8__GPU_DEPTH32F_STENCIL8); #endif -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Round-trip testing GPU_DATA_10_11_11_REV @@ -982,7 +983,7 @@ static void test_texture_roundtrip__GPU_DATA_10_11_11_REV__GPU_R11F_G11F_B10F() } GPU_TEST(texture_roundtrip__GPU_DATA_10_11_11_REV__GPU_R11F_G11F_B10F); -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Round-trip testing GPU_DATA_2_10_10_10_REV @@ -1003,7 +1004,7 @@ static void test_texture_roundtrip__GPU_DATA_2_10_10_10_REV__GPU_RGB10_A2UI() } GPU_TEST(texture_roundtrip__GPU_DATA_2_10_10_10_REV__GPU_RGB10_A2UI); -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Unpack row length @@ -1184,6 +1185,6 @@ static void test_texture_pool() } GPU_TEST(texture_pool); -/* \} */ +/** \} */ } // namespace blender::gpu::tests diff --git a/source/blender/gpu/vulkan/vk_data_conversion.cc b/source/blender/gpu/vulkan/vk_data_conversion.cc index fc7a60510a7..6c99594d25e 100644 --- a/source/blender/gpu/vulkan/vk_data_conversion.cc +++ b/source/blender/gpu/vulkan/vk_data_conversion.cc @@ -679,7 +679,7 @@ static ConversionType reversed(ConversionType type) return ConversionType::UNSUPPORTED; } -/* \} */ +/** \} */ /* -------------------------------------------------------------------- */ /** \name Data Conversion @@ -945,7 +945,7 @@ static void convert(B10F_G11G_R11F &dst, const FLOAT3 &src) dst.value = r << SHIFT_R | g << SHIFT_G | b << SHIFT_B; } -/* \} */ +/** \} */ static void convert(UI32 &dst, const Depth32fStencil8 &src) { @@ -1173,6 +1173,6 @@ void convert_device_to_host(void *dst_buffer, convert_buffer(dst_buffer, src_buffer, buffer_size, device_format, conversion_type); } -/* \} */ +/** \} */ } // namespace blender::gpu diff --git a/source/blender/gpu/vulkan/vk_data_conversion.hh b/source/blender/gpu/vulkan/vk_data_conversion.hh index 243470f13ed..97509382d71 100644 --- a/source/blender/gpu/vulkan/vk_data_conversion.hh +++ b/source/blender/gpu/vulkan/vk_data_conversion.hh @@ -224,6 +224,6 @@ uint32_t convert_float_formats(uint32_t value) return result; } -/* \} */ +/** \} */ }; // namespace blender::gpu diff --git a/source/blender/gpu/vulkan/vk_pipeline_pool.cc b/source/blender/gpu/vulkan/vk_pipeline_pool.cc index 71aa4ada1cd..ab33f4dcd92 100644 --- a/source/blender/gpu/vulkan/vk_pipeline_pool.cc +++ b/source/blender/gpu/vulkan/vk_pipeline_pool.cc @@ -809,6 +809,6 @@ void VKPipelinePool::write_to_disk() #endif } -/* \} */ +/** \} */ } // namespace blender::gpu diff --git a/source/blender/makesrna/intern/rna_sculpt_paint.cc b/source/blender/makesrna/intern/rna_sculpt_paint.cc index 2e44579212f..ef501babdd7 100644 --- a/source/blender/makesrna/intern/rna_sculpt_paint.cc +++ b/source/blender/makesrna/intern/rna_sculpt_paint.cc @@ -474,7 +474,7 @@ static void rna_PaintModeSettings_canvas_source_update(bContext *C, PointerRNA * } } -/* \} */ +/** \} */ static bool rna_ImaPaint_detect_data(ImagePaintSettings *imapaint) {