Cleanup: use doxy sections

1 files changed, 38 insertions, 4 deletions

diff --git a/source/blender/editors/space_view3d/view3d_draw.c b/source/blender/editors/space_view3d/view3d_draw.c
index 478f48700ea..ddb57a916af 100644
--- a/source/blender/editors/space_view3d/view3d_draw.c
+++ b/source/blender/editors/space_view3d/view3d_draw.c
@@ -878,7 +878,11 @@ void ED_view3d_draw_depth(Depsgraph *depsgraph, ARegion *region, View3D *v3d, bo
   UI_Theme_Restore(&theme_state);
 }
 
-/* ******************** other elements ***************** */
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Other Elements
+ * \{ */
 
 /** could move this elsewhere, but tied into #ED_view3d_grid_scale */
 float ED_scene_grid_scale(const Scene *scene, const char **r_grid_unit)
@@ -2149,7 +2153,11 @@ 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);
 }
 
-/* *********************** backdraw for selection *************** */
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Backdraw for Selection
+ * \{ */
 
 /**
  * \note Only use in object mode.
@@ -2251,7 +2259,11 @@ int ED_view3d_backbuf_sample_size_clamp(ARegion *region, const float dist)
   return (int)min_ff(ceilf(dist), (float)max_ii(region->winx, region->winx));
 }
 
-/* *********************** */
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Z-Depth Utilities
+ * \{ */
 
 void view3d_update_depths_rect(ARegion *region, ViewDepths *d, rcti *rect)
 {
@@ -2383,7 +2395,11 @@ void ED_view3d_draw_depth_gpencil(Depsgraph *depsgraph, Scene *scene, ARegion *r
   GPU_depth_test(GPU_DEPTH_NONE);
 }
 
-/* *********************** customdata **************** */
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Custom-data Utilities
+ * \{ */
 
 void ED_view3d_datamask(const bContext *C,
                         const Scene *UNUSED(scene),
@@ -2430,6 +2446,12 @@ void ED_view3d_screen_datamask(const bContext *C,
   }
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Region View Matrix Backup/Restore
+ * \{ */
+
 /**
  * Store values from #RegionView3D, set when drawing.
  * This is needed when we draw with to a viewport using a different matrix
@@ -2472,6 +2494,12 @@ void ED_view3d_mats_rv3d_restore(struct RegionView3D *rv3d, struct RV3DMatrixSto
   rv3d->pixsize = rv3dmat->pixsize;
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name FPS Drawing
+ * \{ */
+
 /**
  * \note The info that this uses is updated in #ED_refresh_viewport_fps,
  * which currently gets called during #SCREEN_OT_animation_step.
@@ -2531,6 +2559,12 @@ void ED_scene_draw_fps(const Scene *scene, int xoffset, int *yoffset)
   BLF_disable(font_id, BLF_SHADOW);
 }
 
+/** \} */
+
+/* -------------------------------------------------------------------- */
+/** \name Calculate Render Border
+ * \{ */
+
 static bool view3d_main_region_do_render_draw(const Scene *scene)
 {
   RenderEngineType *type = RE_engines_find(scene->r.engine);