[Bf-blender-cvs] [eb4b79c5562] master: Cleanup: unbalanced doxy sections, add some sections

[Campbell Barton]

Commit: eb4b79c5562ad6cd13b45c2e69a7b95628853e17
Author: Campbell Barton
Date:   Thu Apr 28 14:03:47 2022 +1000
Branches: master
https://developer.blender.org/rBeb4b79c5562ad6cd13b45c2e69a7b95628853e17

Cleanup: unbalanced doxy sections, add some sections

===================================================================

M	source/blender/blenkernel/BKE_curves.hh
M	source/blender/blenkernel/intern/layer.c
M	source/blender/editors/object/object_edit.c
M	source/blender/editors/sculpt_paint/paint_vertex.cc
M	source/blender/editors/sculpt_paint/paint_vertex_color_ops.c
M	source/blender/geometry/GEO_uv_parametrizer.h
M	source/blender/gpu/intern/gpu_codegen.cc
M	source/blender/python/intern/bpy_rna_types_capi.c

===================================================================

diff --git a/source/blender/blenkernel/BKE_curves.hh b/source/blender/blenkernel/BKE_curves.hh
index 4bfbe0cd27f..fe2c6196221 100644
--- a/source/blender/blenkernel/BKE_curves.hh
+++ b/source/blender/blenkernel/BKE_curves.hh
@@ -401,6 +401,10 @@ class CurvesGeometry : public ::CurvesGeometry {
 
 namespace curves {
 
+/* -------------------------------------------------------------------- */
+/** \name Inline Curve Methods
+ * \{ */
+
 /**
  * The number of segments between control points, accounting for the last segment of cyclic
  * curves. The logic is simple, but this function should be used to make intentions clearer.
@@ -422,6 +426,12 @@ inline float3 decode_surface_bary_coord(const float2 &v)
   return {v.x, v.y, 1.0f - v.x - v.y};
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Curve Poly Methods
+ * \{ */
+
 namespace poly {
 
 /**
@@ -447,6 +457,12 @@ void calculate_normals_z_up(Span<float3> tangents, MutableSpan<float3> normals);
 
 }  // namespace poly
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Curve Bezier Methods
+ * \{ */
+
 namespace bezier {
 
 /**
@@ -547,6 +563,12 @@ void interpolate_to_evaluated(GSpan src, Span<int> evaluated_offsets, GMutableSp
 
 }  // namespace bezier
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Curve Catmull-Rom Methods
+ * \{ */
+
 namespace catmull_rom {
 
 /**
@@ -564,6 +586,12 @@ void interpolate_to_evaluated(GSpan src, bool cyclic, int resolution, GMutableSp
 
 }  // namespace catmull_rom
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Curve NURBS Methods
+ * \{ */
+
 namespace nurbs {
 
 /**
@@ -629,6 +657,8 @@ void interpolate_to_evaluated(const BasisCache &basis_cache,
 
 }  // namespace nurbs
 
+/** \} */
+
 }  // namespace curves
 
 Curves *curves_new_nomain(int points_num, int curves_num);
@@ -640,8 +670,6 @@ Curves *curves_new_nomain_single(int points_num, CurveType type);
 
 std::array<int, CURVE_TYPES_NUM> calculate_type_counts(const VArray<int8_t> &types);
 
-/** \} */
-
 /* -------------------------------------------------------------------- */
 /** \name #CurvesGeometry Inline Methods
  * \{ */
@@ -767,8 +795,8 @@ inline bool point_is_sharp(const Span<int8_t> handle_types_left,
          ELEM(handle_types_right[index], BEZIER_HANDLE_VECTOR, BEZIER_HANDLE_FREE);
 }
 
-}  // namespace curves::bezier
-
 /** \} */
 
+}  // namespace curves::bezier
+
 }  // namespace blender::bke
diff --git a/source/blender/blenkernel/intern/layer.c b/source/blender/blenkernel/intern/layer.c
index f0ccd305690..534ff7f1fbc 100644
--- a/source/blender/blenkernel/intern/layer.c
+++ b/source/blender/blenkernel/intern/layer.c
@@ -2509,6 +2509,8 @@ ViewLayer *BKE_view_layer_find_with_aov(struct Scene *scene, struct ViewLayerAOV
   return NULL;
 }
 
+/** \} */
+
 /* -------------------------------------------------------------------- */
 /** \name Light Groups
  * \{ */
diff --git a/source/blender/editors/object/object_edit.c b/source/blender/editors/object/object_edit.c
index 0275ace8ec9..cb0e76c11e4 100644
--- a/source/blender/editors/object/object_edit.c
+++ b/source/blender/editors/object/object_edit.c
@@ -1454,8 +1454,6 @@ void OBJECT_OT_paths_clear(wmOperatorType *ot)
 
 /** \} */
 
-/** \} */
-
 /* -------------------------------------------------------------------- */
 /** \name Object Shade Smooth/Flat Operator
  * \{ */
diff --git a/source/blender/editors/sculpt_paint/paint_vertex.cc b/source/blender/editors/sculpt_paint/paint_vertex.cc
index 5aeacb15e00..a474767b1a1 100644
--- a/source/blender/editors/sculpt_paint/paint_vertex.cc
+++ b/source/blender/editors/sculpt_paint/paint_vertex.cc
@@ -4091,6 +4091,8 @@ void PAINT_OT_vertex_paint(wmOperatorType *ot)
   paint_stroke_operator_properties(ot);
 }
 
+/** \} */
+
 /* -------------------------------------------------------------------- */
 /** \name Set Vertex Colors Operator
  * \{ */
diff --git a/source/blender/editors/sculpt_paint/paint_vertex_color_ops.c b/source/blender/editors/sculpt_paint/paint_vertex_color_ops.c
index 9f337d8d789..a2e1adff50a 100644
--- a/source/blender/editors/sculpt_paint/paint_vertex_color_ops.c
+++ b/source/blender/editors/sculpt_paint/paint_vertex_color_ops.c
@@ -30,6 +30,10 @@
 
 #include "paint_intern.h" /* own include */
 
+/* -------------------------------------------------------------------- */
+/** \name Internal Utility Functions
+ * \{ */
+
 static bool vertex_weight_paint_mode_poll(bContext *C)
 {
   Object *ob = CTX_data_active_object(C);
diff --git a/source/blender/geometry/GEO_uv_parametrizer.h b/source/blender/geometry/GEO_uv_parametrizer.h
index e25889a0923..a5194883cf2 100644
--- a/source/blender/geometry/GEO_uv_parametrizer.h
+++ b/source/blender/geometry/GEO_uv_parametrizer.h
@@ -120,6 +120,8 @@ void GEO_uv_parametrizer_average(ParamHandle *handle, bool ignore_pinned);
 
 void GEO_uv_parametrizer_scale(ParamHandle *handle, float x, float y);
 
+/** \} */
+
 /* -------------------------------------------------------------------- */
 /** \name Flushing
  * \{ */
diff --git a/source/blender/gpu/intern/gpu_codegen.cc b/source/blender/gpu/intern/gpu_codegen.cc
index b8573f88d0c..2e7c95974ab 100644
--- a/source/blender/gpu/intern/gpu_codegen.cc
+++ b/source/blender/gpu/intern/gpu_codegen.cc
@@ -92,7 +92,7 @@ struct GPUPass {
  * Internal shader cache: This prevent the shader recompilation / stall when
  * using undo/redo AND also allows for GPUPass reuse if the Shader code is the
  * same for 2 different Materials. Unused GPUPasses are free by Garbage collection.
- */
+ * \{ */
 
 /* Only use one linklist that contains the GPUPasses grouped by hash. */
 static GPUPass *pass_cache = nullptr;
@@ -793,4 +793,4 @@ void gpu_codegen_exit(void)
   GPU_shader_free_builtin_shaders();
 }
 
-/** \} */
\ No newline at end of file
+/** \} */
diff --git a/source/blender/python/intern/bpy_rna_types_capi.c b/source/blender/python/intern/bpy_rna_types_capi.c
index 608692876d6..d58adb66b37 100644
--- a/source/blender/python/intern/bpy_rna_types_capi.c
+++ b/source/blender/python/intern/bpy_rna_types_capi.c
@@ -98,6 +98,8 @@ static struct PyMethodDef pyrna_text_methods[] = {
     {NULL, NULL, 0, NULL},
 };
 
+/** \} */
+
 /* -------------------------------------------------------------------- */
 /** \name Window Manager Clipboard Property
  *