Cleanup: consistent use of tags: NOTE/TODO/FIXME/XXX

Also use doxy style function reference `#` prefix chars when
referencing identifiers.

1 files changed, 8 insertions, 8 deletions

diff --git a/source/blender/editors/mesh/editmesh_tools.c b/source/blender/editors/mesh/editmesh_tools.c
index fe9656d277e..e1f192bea77 100644
--- a/source/blender/editors/mesh/editmesh_tools.c
+++ b/source/blender/editors/mesh/editmesh_tools.c
@@ -145,7 +145,7 @@ static int edbm_subdivide_exec(bContext *C, wmOperator *op)
   return OPERATOR_FINISHED;
 }
 
-/* Note, these values must match delete_mesh() event values */
+/* NOTE: these values must match delete_mesh() event values. */
 static const EnumPropertyItem prop_mesh_cornervert_types[] = {
     {SUBD_CORNER_INNERVERT, "INNERVERT", 0, "Inner Vert", ""},
     {SUBD_CORNER_PATH, "PATH", 0, "Path", ""},
@@ -245,7 +245,7 @@ static void mesh_operator_edgering_props(wmOperatorType *ot,
                                          const int cuts_min,
                                          const int cuts_default)
 {
-  /* Note, these values must match delete_mesh() event values */
+  /* NOTE: these values must match delete_mesh() event values. */
   static const EnumPropertyItem prop_subd_edgering_types[] = {
       {SUBD_RING_INTERP_LINEAR, "LINEAR", 0, "Linear", ""},
       {SUBD_RING_INTERP_PATH, "PATH", 0, "Blend Path", ""},
@@ -431,7 +431,7 @@ void MESH_OT_unsubdivide(wmOperatorType *ot)
 /** \name Delete Operator
  * \{ */
 
-/* Note, these values must match delete_mesh() event values */
+/* NOTE: these values must match delete_mesh() event values. */
 enum {
   MESH_DELETE_VERT = 0,
   MESH_DELETE_EDGE = 1,
@@ -4222,7 +4222,7 @@ static int edbm_knife_cut_exec(bContext *C, wmOperator *op)
   /* for ED_view3d_project_float_object */
   ED_view3d_init_mats_rv3d(obedit, region->regiondata);
 
-  /* TODO, investigate using index lookup for screen_vert_coords() rather than a hash table */
+  /* TODO: investigate using index lookup for #screen_vert_coords() rather than a hash table. */
 
   /* the floating point coordinates of verts in screen space will be
    * stored in a hash table according to the vertices pointer */
@@ -5874,7 +5874,7 @@ void MESH_OT_decimate(wmOperatorType *ot)
   /* flags */
   ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO;
 
-  /* Note, keep in sync with 'rna_def_modifier_decimate' */
+  /* NOTE: keep in sync with 'rna_def_modifier_decimate'. */
   RNA_def_float(ot->srna, "ratio", 1.0f, 0.0f, 1.0f, "Ratio", "", 0.0f, 1.0f);
 
   RNA_def_boolean(ot->srna,
@@ -6751,7 +6751,7 @@ static void sort_bmelem_flag(bContext *C,
     BM_ITER_MESH_INDEX (fa, &iter, em->bm, BM_FACES_OF_MESH, i) {
       if (BM_elem_flag_test(fa, flag)) {
         /* Reverse materials' order, not order of faces inside each mat! */
-        /* Note: cannot use totcol, as mat_nr may sometimes be greater... */
+        /* NOTE: cannot use totcol, as mat_nr may sometimes be greater... */
         float srt = reverse ? (float)(MAXMAT - fa->mat_nr) : (float)fa->mat_nr;
         pb[i] = false;
         sb[affected[2]].org_idx = i;
@@ -8385,7 +8385,7 @@ static void point_normals_update_header(bContext *C, wmOperator *op)
   ED_area_status_text(CTX_wm_area(C), header);
 }
 
-/* TODO move that to generic function in BMesh? */
+/* TODO: move that to generic function in BMesh? */
 static void bmesh_selected_verts_center_calc(BMesh *bm, float *r_center)
 {
   BMVert *v;
@@ -9691,7 +9691,7 @@ static int edbm_smooth_normals_exec(bContext *C, wmOperator *op)
       BKE_lnor_space_custom_data_to_normal(
           bm->lnor_spacearr->lspacearr[lnor_ed->loop_index], lnor_ed->clnors_data, current_normal);
 
-      /* Note: again, this is not true spherical interpolation that normals would need...
+      /* NOTE: again, this is not true spherical interpolation that normals would need...
        * But it's probably good enough for now. */
       mul_v3_fl(current_normal, 1.0f - factor);
       mul_v3_fl(smooth_normal[i], factor);