Cleanup: use our own code style for doxy-gen comment blocks

5 files changed, 36 insertions, 23 deletions

diff --git a/source/blender/blenkernel/BKE_attribute_math.hh b/source/blender/blenkernel/BKE_attribute_math.hh
index b0d32b20d44..0afdc436415 100644
--- a/source/blender/blenkernel/BKE_attribute_math.hh
+++ b/source/blender/blenkernel/BKE_attribute_math.hh
@@ -227,8 +227,10 @@ template<typename T> class SimpleMixer {
   }
 };
 
-/** This mixer accumulates values in a type that is different from the one that is mixed. Some
- * types cannot encode the floating point weights in their values (e.g. int and bool). */
+/**
+ * This mixer accumulates values in a type that is different from the one that is mixed.
+ * Some types cannot encode the floating point weights in their values (e.g. int and bool).
+ */
 template<typename T, typename AccumulationT, T (*ConvertToT)(const AccumulationT &value)>
 class SimpleMixerWithAccumulationType {
  private:
diff --git a/source/blender/blenkernel/intern/anim_sys.c b/source/blender/blenkernel/intern/anim_sys.c
index 564b5c9399a..51a38d81966 100644
--- a/source/blender/blenkernel/intern/anim_sys.c
+++ b/source/blender/blenkernel/intern/anim_sys.c
@@ -1686,8 +1686,10 @@ static void nlaevalchan_copy_values(NlaEvalChannelSnapshot *dst, NlaEvalChannelS
   memcpy(dst->values, src->values, src->length * sizeof(float));
 }
 
-/** Copies lower necs to blended necs if upper necs is NULL or has zero influence.
- * \return true if copied. */
+/**
+ * Copies lower necs to blended necs if upper necs is NULL or has zero influence.
+ * \return true if copied.
+ */
 static bool nlaevalchan_blendOrcombine_try_copy_lower(NlaEvalChannelSnapshot *lower_necs,
                                                       NlaEvalChannelSnapshot *upper_necs,
                                                       const float upper_influence,
@@ -1702,10 +1704,10 @@ static bool nlaevalchan_blendOrcombine_try_copy_lower(NlaEvalChannelSnapshot *lo
   return true;
 }
 
-/** Based on blendmode, blend lower necs with upper necs into blended necs.
+/**
+ * Based on blend-mode, blend lower necs with upper necs into blended necs.
  *
- * Each upper value's blend domain determines whether to blend or to copy directly
- * from lower.
+ * Each upper value's blend domain determines whether to blend or to copy directly from lower.
  */
 static void nlaevalchan_blend_value(NlaEvalChannelSnapshot *lower_necs,
                                     NlaEvalChannelSnapshot *upper_necs,
@@ -1731,11 +1733,11 @@ static void nlaevalchan_blend_value(NlaEvalChannelSnapshot *lower_necs,
   }
 }
 
-/** Based on mixmode, provided by one the necs, combines lower necs with upper necs into blended
- * necs.
+/**
+ * Based on mix-mode, provided by one the necs,
+ * combines lower necs with upper necs into blended necs.
  *
- * Each upper value's blend domain determines whether to blend or to copy directly
- * from lower.
+ * Each upper value's blend domain determines whether to blend or to copy directly from lower.
  */
 static void nlaevalchan_combine_value(NlaEvalChannelSnapshot *lower_necs,
                                       NlaEvalChannelSnapshot *upper_necs,
@@ -1764,7 +1766,8 @@ static void nlaevalchan_combine_value(NlaEvalChannelSnapshot *lower_necs,
   }
 }
 
-/** Quaternion combines lower necs with upper necs into blended necs.
+/**
+ * Quaternion combines lower necs with upper necs into blended necs.
  *
  * Each upper value's blend domain determines whether to blend or to copy directly
  * from lower.
@@ -1790,7 +1793,8 @@ static void nlaevalchan_combine_quaternion(NlaEvalChannelSnapshot *lower_necs,
       lower_necs->values, upper_necs->values, upper_influence, r_blended_necs->values);
 }
 
-/** Based on blendmode and mixmode, blend lower necs with upper necs into blended necs.
+/**
+ * Based on blendmode and mixmode, blend lower necs with upper necs into blended necs.
  *
  * Each upper value's blend domain determines whether to blend or to copy directly
  * from lower.
@@ -1841,7 +1845,8 @@ static void nlaevalchan_blendOrcombine(NlaEvalChannelSnapshot *lower_necs,
   }
 }
 
-/** Based on blendmode, solve for the upper values such that when lower blended with upper then we
+/**
+ * Based on blend-mode, solve for the upper values such that when lower blended with upper then we
  * get blended values as a result.
  *
  * Only processes blended values in the remap domain. Successfully remapped upper values are placed
@@ -1873,7 +1878,8 @@ static void nlaevalchan_blend_value_get_inverted_upper_evalchan(
   }
 }
 
-/** Based on mixmode, solve for the upper values such that when lower combined with upper then we
+/**
+ * Based on mixmode, solve for the upper values such that when lower combined with upper then we
  * get blended values as a result.
  *
  * Only processes blended values in the remap domain. Successfully remapped upper values are placed
@@ -1910,7 +1916,8 @@ static void nlaevalchan_combine_value_get_inverted_upper_evalchan(
   }
 }
 
-/** Solve for the upper values such that when lower quaternion combined with upper then we get
+/**
+ * Solve for the upper values such that when lower quaternion combined with upper then we get
  * blended values as a result.
  *
  * All blended values must be in the remap domain. If successfully remapped, then all upper values
@@ -1941,7 +1948,8 @@ static void nlaevalchan_combine_quaternion_get_inverted_upper_evalchan(
   BLI_bitmap_set_all(r_upper_necs->remap_domain.ptr, success, 4);
 }
 
-/** Based on blendmode and mix mode, solve for the upper values such that when lower blended or
+/**
+ * Based on blend-mode and mix mode, solve for the upper values such that when lower blended or
  * combined with upper then we get blended values as a result.
  *
  * Only processes blended values in the remap domain. Successfully remapped upper values are placed
@@ -2882,7 +2890,8 @@ void nlasnapshot_blend(NlaEvalData *eval_data,
   }
 }
 
-/** Using  \a blended_snapshot and \a lower_snapshot, we can solve for the \a r_upper_snapshot.
+/**
+ * Using \a blended_snapshot and \a lower_snapshot, we can solve for the \a r_upper_snapshot.
  *
  * Only channels that exist within \a blended_snapshot are inverted.
  *
diff --git a/source/blender/blenkernel/intern/lib_override.c b/source/blender/blenkernel/intern/lib_override.c
index 68e1d9f77ea..8341c5b6e78 100644
--- a/source/blender/blenkernel/intern/lib_override.c
+++ b/source/blender/blenkernel/intern/lib_override.c
@@ -1669,7 +1669,7 @@ bool BKE_lib_override_library_property_operation_operands_validate(
   return true;
 }
 
-/** Check against potential  \a bmain. */
+/** Check against potential \a bmain. */
 void BKE_lib_override_library_validate(Main *UNUSED(bmain), ID *id, ReportList *reports)
 {
   if (id->override_library == NULL) {
@@ -1703,7 +1703,7 @@ void BKE_lib_override_library_validate(Main *UNUSED(bmain), ID *id, ReportList *
   }
 }
 
-/** Check against potential  \a bmain. */
+/** Check against potential \a bmain. */
 void BKE_lib_override_library_main_validate(Main *bmain, ReportList *reports)
 {
   ID *id;
diff --git a/source/blender/editors/transform/transform.c b/source/blender/editors/transform/transform.c
index 9c4175784cd..ba8e5c1e2c6 100644
--- a/source/blender/editors/transform/transform.c
+++ b/source/blender/editors/transform/transform.c
@@ -1619,7 +1619,7 @@ static void initSnapSpatial(TransInfo *t, float r_snap[2])
 
 /**
  * \note  caller needs to free 't' on a 0 return
- * \warning  \a event might be NULL (when tweaking from redo panel)
+ * \warning \a event might be NULL (when tweaking from redo panel)
  * \see #saveTransform which writes these values back.
  */
 bool initTransform(bContext *C, TransInfo *t, wmOperator *op, const wmEvent *event, int mode)
diff --git a/source/blender/gpencil_modifiers/intern/lineart/MOD_lineart.h b/source/blender/gpencil_modifiers/intern/lineart/MOD_lineart.h
index 56cd7fa1456..44ff0616fe9 100644
--- a/source/blender/gpencil_modifiers/intern/lineart/MOD_lineart.h
+++ b/source/blender/gpencil_modifiers/intern/lineart/MOD_lineart.h
@@ -322,9 +322,11 @@ typedef enum eLineartTriangleFlags {
   LRT_TRIANGLE_NO_INTERSECTION = (1 << 4),
 } eLineartTriangleFlags;
 
-/** Controls how many edges a worker thread is processing at one request.
+/**
+ * Controls how many edges a worker thread is processing at one request.
  * There's no significant performance impact on choosing different values.
- * Don't make it too small so that the worker thread won't request too many times. */
+ * Don't make it too small so that the worker thread won't request too many times.
+ */
 #define LRT_THREAD_EDGE_COUNT 1000
 
 typedef struct LineartRenderTaskInfo {