From f324cbf2a679347c09a7ab1e2da75f60dfcfa767 Mon Sep 17 00:00:00 2001
From: Campbell Barton <campbell@blender.org>
Date: Mon, 31 Jul 2023 09:57:46 +1000
Subject: [PATCH] Cleanup: use doxygen docs for datatoc_icon

---
 source/blender/datatoc/datatoc_icon.cc | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/source/blender/datatoc/datatoc_icon.cc b/source/blender/datatoc/datatoc_icon.cc
index 251eb19dbe3..e85b176d501 100644
--- a/source/blender/datatoc/datatoc_icon.cc
+++ b/source/blender/datatoc/datatoc_icon.cc
@@ -34,7 +34,8 @@
 #endif
 
 /* -------------------------------------------------------------------- */
-/* Utility functions */
+/** \name Utility Functions
+ * \{ */
 
 static bool path_test_extension(const char *filepath, const char *ext)
 {
@@ -89,8 +90,11 @@ static bool path_join(char *filepath,
   return true;
 }
 
+/** \} */
+
 /* -------------------------------------------------------------------- */
-/* Write a PNG from RGBA pixels */
+/** \name Write a PNG from RGBA Pixels
+ * \{ */
 
 static bool write_png(const char *filepath, const uint *pixels, const int width, const int height)
 {
@@ -188,8 +192,11 @@ static bool write_png(const char *filepath, const uint *pixels, const int width,
   return true;
 }
 
+/** \} */
+
 /* -------------------------------------------------------------------- */
-/* Merge icon-data from files */
+/** \name Merge Icon-Data from Files
+ * \{ */
 
 struct IconHead {
   uint icon_w, icon_h;
@@ -453,8 +460,11 @@ static bool icondir_to_png(const char *path_src, const char *file_dst)
   return (fail == 0);
 }
 
+/** \} */
+
 /* -------------------------------------------------------------------- */
-/* Main and parse args */
+/** \name Main & Parse Arguments
+ * \{ */
 
 int main(int argc, char **argv)
 {
@@ -471,3 +481,5 @@ int main(int argc, char **argv)
 
   return (icondir_to_png(path_src, file_dst) == true) ? 0 : 1;
 }
+
+/** \} */