[Bf-blender-cvs] [f085ebba58d] master: Cleanup: use doxy sections for blender.c

[Campbell Barton]

Commit: f085ebba58d74297e39ff41ad9a3c7a833412571
Author: Campbell Barton
Date:   Thu Sep 17 15:34:10 2020 +1000
Branches: master
https://developer.blender.org/rBf085ebba58d74297e39ff41ad9a3c7a833412571

Cleanup: use doxy sections for blender.c

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

M	source/blender/blenkernel/intern/blender.c

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

diff --git a/source/blender/blenkernel/intern/blender.c b/source/blender/blenkernel/intern/blender.c
index d5980119a38..1ad1a821129 100644
--- a/source/blender/blenkernel/intern/blender.c
+++ b/source/blender/blenkernel/intern/blender.c
@@ -66,9 +66,9 @@
 Global G;
 UserDef U;
 
-static char blender_version_string[48] = "";
-
-/* ********** free ********** */
+/* -------------------------------------------------------------------- */
+/** \name Blender Free on Exit
+ * \{ */
 
 /* only to be called on exit blender */
 void BKE_blender_free(void)
@@ -102,6 +102,14 @@ void BKE_blender_free(void)
   free_nodesystem();
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Blender Version Access
+ * \{ */
+
+static char blender_version_string[48] = "";
+
 static void blender_version_init(void)
 {
   const char *version_cycle = "";
@@ -141,6 +149,12 @@ bool BKE_blender_version_is_alpha(void)
   return is_alpha;
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Blender #Global Initialize/Clear
+ * \{ */
+
 void BKE_blender_globals_init(void)
 {
   blender_version_init();
@@ -169,7 +183,11 @@ void BKE_blender_globals_clear(void)
   G_MAIN = NULL;
 }
 
-/***/
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Blender Preferences
+ * \{ */
 
 static void keymap_item_free(wmKeyMapItem *kmi)
 {
@@ -285,6 +303,12 @@ void BKE_blender_userdef_data_free(UserDef *userdef, bool clear_fonts)
 #undef U
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Blender Preferences (Application Templates)
+ * \{ */
+
 /**
  * Write U from userdef.
  * This function defines which settings a template will override for the user preferences.
@@ -356,6 +380,9 @@ void BKE_blender_userdef_app_template_data_set_and_free(UserDef *userdef)
   MEM_freeN(userdef);
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
 /** \name Blender's AtExit
  *
  * \note Don't use MEM_mallocN so functions can be registered at any time.