[Bf-blender-cvs] [02ff6006202] master: Cleanup: add doxy sections to view3d_draw, header

[Campbell Barton]

Commit: 02ff60062024f6750cea5bf6f5ff1a50ae07b7f8
Author: Campbell Barton
Date:   Thu Mar 28 15:00:27 2019 +1100
Branches: master
https://developer.blender.org/rB02ff60062024f6750cea5bf6f5ff1a50ae07b7f8

Cleanup: add doxy sections to view3d_draw,header

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

M	source/blender/editors/space_view3d/view3d_draw.c
M	source/blender/editors/space_view3d/view3d_header.c

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

diff --git a/source/blender/editors/space_view3d/view3d_draw.c b/source/blender/editors/space_view3d/view3d_draw.c
index c2db61f0b72..39a77329db5 100644
--- a/source/blender/editors/space_view3d/view3d_draw.c
+++ b/source/blender/editors/space_view3d/view3d_draw.c
@@ -93,7 +93,9 @@
 
 #include "view3d_intern.h"  /* own include */
 
-/* ******************** general functions ***************** */
+/* -------------------------------------------------------------------- */
+/** \name General Functions
+ * \{ */
 
 /**
  * \note keep this synced with #ED_view3d_mats_rv3d_backup/#ED_view3d_mats_rv3d_restore
@@ -294,7 +296,11 @@ void ED_view3d_draw_setup_view(
 	}
 }
 
-/* ******************** view border ***************** */
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Draw View Border
+ * \{ */
 
 static void view3d_camera_border(
         const Scene *scene, struct Depsgraph *depsgraph,
@@ -1006,8 +1012,6 @@ static void draw_rotation_guide(const RegionView3D *rv3d)
 }
 #endif /* WITH_INPUT_NDOF */
 
-/* ******************** info ***************** */
-
 /**
  * Render and camera border
  */
@@ -1026,8 +1030,14 @@ static void view3d_draw_border(const bContext *C, ARegion *ar)
 	}
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Draw Text & Info
+ * \{ */
+
 /**
- * Grease Pencil
+ * Draw Info
  */
 static void view3d_draw_grease_pencil(const bContext *UNUSED(C))
 {
@@ -1280,8 +1290,6 @@ static void draw_selected_name(Scene *scene, ViewLayer *view_layer, Object *ob,
 	BLF_disable(font_id, BLF_SHADOW);
 }
 
-/* ******************** view loop ***************** */
-
 /**
  * Information drawn on top of the solid plates and composed data
  */
@@ -1367,6 +1375,12 @@ void view3d_draw_region_info(const bContext *C, ARegion *ar)
 	BLF_batch_draw_end();
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Draw Viewport Contents
+ * \{ */
+
 static void view3d_draw_view(const bContext *C, ARegion *ar)
 {
 	ED_view3d_draw_setup_view(CTX_wm_window(C), CTX_data_depsgraph(C), CTX_data_scene(C), ar, CTX_wm_view3d(C), NULL, NULL, NULL);
@@ -1408,6 +1422,8 @@ void view3d_main_region_draw(const bContext *C, ARegion *ar)
 	v3d->flag |= V3D_INVALID_BACKBUF;
 }
 
+/** \} */
+
 /* -------------------------------------------------------------------- */
 /** \name Offscreen Drawing
  * \{ */
@@ -1793,5 +1809,4 @@ bool ED_view3d_clipping_test(const RegionView3D *rv3d, const float co[3], const
 	return view3d_clipping_test(co, is_local ? rv3d->clip_local : rv3d->clip);
 }
 
-
 /** \} */
diff --git a/source/blender/editors/space_view3d/view3d_header.c b/source/blender/editors/space_view3d/view3d_header.c
index aa97c151df5..de3f0392ff0 100644
--- a/source/blender/editors/space_view3d/view3d_header.c
+++ b/source/blender/editors/space_view3d/view3d_header.c
@@ -96,6 +96,9 @@ void VIEW3D_OT_toggle_matcap_flip(wmOperatorType *ot)
 
 /** \} */
 
+/* -------------------------------------------------------------------- */
+/** \name UI Templates
+ * \{ */
 
 static void do_view3d_header_buttons(bContext *C, void *UNUSED(arg), int event)
 {
@@ -189,3 +192,5 @@ void uiTemplateHeader3D_mode(uiLayout *layout, struct bContext *C)
 		uiTemplatePaintModeSelection(layout, C);
 	}
 }
+
+/** \} */