From c097c7b855d4b01950494dc369e9def59486b0fd Mon Sep 17 00:00:00 2001
From: Campbell Barton <ideasman42@gmail.com>
Date: Tue, 14 Dec 2021 15:49:31 +1100
Subject: Cleanup: correct unbalanced doxygen groups

Also add groups in some files.
---
 source/blender/imbuf/IMB_imbuf_types.h             | 25 ++++++++++++++--------
 source/blender/imbuf/intern/imageprocess.c         |  2 ++
 .../blender/imbuf/intern/openexr/openexr_multi.h   |  4 ++--
 3 files changed, 20 insertions(+), 11 deletions(-)

(limited to 'source/blender/imbuf')

diff --git a/source/blender/imbuf/IMB_imbuf_types.h b/source/blender/imbuf/IMB_imbuf_types.h
index a083d4e360c..58148743b7e 100644
--- a/source/blender/imbuf/IMB_imbuf_types.h
+++ b/source/blender/imbuf/IMB_imbuf_types.h
@@ -143,10 +143,9 @@ typedef struct ImbFormatOptions {
   char quality;
 } ImbFormatOptions;
 
-/**
- * \name Imbuf Component flags
+/* -------------------------------------------------------------------- */
+/** \name Imbuf Component flags
  * \brief These flags determine the components of an ImBuf struct.
- *
  * \{ */
 
 typedef enum eImBufFlags {
@@ -175,6 +174,11 @@ typedef enum eImBufFlags {
 } eImBufFlags;
 
 /** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Image Buffer
+ * \{ */
+
 typedef struct ImBuf {
   struct ImBuf *next, *prev; /** < allow lists of #ImBufs, for caches or flip-books. */
 
@@ -301,11 +305,14 @@ enum {
   IB_PERSISTENT = (1 << 5),
 };
 
-/**
- * \name Imbuf preset profile tags
- * \brief Some predefined color space profiles that 8 bit imbufs can represent
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Imbuf Preset Profile Tags
  *
+ * \brief Some predefined color space profiles that 8 bit imbufs can represent.
  * \{ */
+
 #define IB_PROFILE_NONE 0
 #define IB_PROFILE_LINEAR_RGB 1
 #define IB_PROFILE_SRGB 2
@@ -340,10 +347,10 @@ extern const char *imb_ext_audio[];
 /** Image formats that can only be loaded via filepath. */
 extern const char *imb_ext_image_filepath_only[];
 
-/**
- * \name Imbuf Color Management Flag
- * \brief Used with #ImBuf.colormanage_flag
+/* -------------------------------------------------------------------- */
+/** \name Imbuf Color Management Flag
  *
+ * \brief Used with #ImBuf.colormanage_flag
  * \{ */
 
 enum {
diff --git a/source/blender/imbuf/intern/imageprocess.c b/source/blender/imbuf/intern/imageprocess.c
index 1babc3d3b3e..23c4c53d602 100644
--- a/source/blender/imbuf/intern/imageprocess.c
+++ b/source/blender/imbuf/intern/imageprocess.c
@@ -357,6 +357,8 @@ void nearest_interpolation(const ImBuf *in, ImBuf *out, float u, float v, int xo
   nearest_interpolation_color(in, outI, outF, u, v);
 }
 
+/** \} */
+
 /* -------------------------------------------------------------------- */
 /** \name Threaded Image Processing
  * \{ */
diff --git a/source/blender/imbuf/intern/openexr/openexr_multi.h b/source/blender/imbuf/intern/openexr/openexr_multi.h
index 7fb48a92bfd..6694c32820b 100644
--- a/source/blender/imbuf/intern/openexr/openexr_multi.h
+++ b/source/blender/imbuf/intern/openexr/openexr_multi.h
@@ -45,7 +45,7 @@ void *IMB_exr_get_handle_name(const char *name);
 /**
  * Adds flattened #ExrChannel's
  * `xstride`, `ystride` and `rect` can be done in set_channel too, for tile writing.
- * \param passname does not include view.
+ * \param passname: Does not include view.
  */
 void IMB_exr_add_channel(void *handle,
                          const char *layname,
@@ -80,7 +80,7 @@ void IMB_exrtile_begin_write(
 /**
  * Still clumsy name handling, layers/channels can be ordered as list in list later.
  *
- * \param passname here is the raw channel name without the layer.
+ * \param passname: Here is the raw channel name without the layer.
  */
 void IMB_exr_set_channel(void *handle,
                          const char *layname,
-- 
cgit v1.2.3