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

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

8 files changed, 13 insertions, 13 deletions

diff --git a/source/blender/editors/space_node/drawnode.cc b/source/blender/editors/space_node/drawnode.cc
index 1c7ee9e622f..243652da608 100644
--- a/source/blender/editors/space_node/drawnode.cc
+++ b/source/blender/editors/space_node/drawnode.cc
@@ -758,7 +758,7 @@ static void node_shader_buts_tex_image(uiLayout *layout, bContext *C, PointerRNA
 
   uiItemR(layout, ptr, "extension", DEFAULT_FLAGS, "", ICON_NONE);
 
-  /* note: image user properties used directly here, unlike compositor image node,
+  /* NOTE: image user properties used directly here, unlike compositor image node,
    * which redefines them in the node struct RNA to get proper updates.
    */
   node_buts_image_user(layout, C, &iuserptr, &imaptr, &iuserptr, false, true);
@@ -4195,7 +4195,7 @@ void node_draw_link_bezier(const View2D *v2d,
   }
 }
 
-/* note; this is used for fake links in groups too */
+/* NOTE: this is used for fake links in groups too. */
 void node_draw_link(View2D *v2d, SpaceNode *snode, bNodeLink *link)
 {
   int th_col1 = TH_WIRE_INNER, th_col2 = TH_WIRE_INNER, th_col3 = TH_WIRE;
diff --git a/source/blender/editors/space_node/node_edit.cc b/source/blender/editors/space_node/node_edit.cc
index 0cf47ed35fa..56064e92d70 100644
--- a/source/blender/editors/space_node/node_edit.cc
+++ b/source/blender/editors/space_node/node_edit.cc
@@ -2313,7 +2313,7 @@ static int ntree_socket_add_exec(bContext *C, wmOperator *op)
     // nodeSocketCopyValue(sock, &ntree_ptr, active_sock, &ntree_ptr);
   }
   else {
-    /* XXX TODO define default socket type for a tree! */
+    /* XXX TODO: define default socket type for a tree! */
     sock = ntreeAddSocketInterface(ntree, in_out, "NodeSocketFloat", default_name);
   }
 
diff --git a/source/blender/editors/space_node/node_gizmo.c b/source/blender/editors/space_node/node_gizmo.c
index 8547c825230..e1deca54890 100644
--- a/source/blender/editors/space_node/node_gizmo.c
+++ b/source/blender/editors/space_node/node_gizmo.c
@@ -155,7 +155,7 @@ static void WIDGETGROUP_node_transform_refresh(const bContext *C, wmGizmoGroup *
     WM_gizmo_set_matrix_location(cage, origin);
     WM_gizmo_set_flag(cage, WM_GIZMO_HIDDEN, false);
 
-    /* need to set property here for undo. TODO would prefer to do this in _init */
+    /* Need to set property here for undo. TODO: would prefer to do this in _init. */
     SpaceNode *snode = CTX_wm_space_node(C);
 #if 0
     PointerRNA nodeptr;
@@ -492,7 +492,7 @@ static void WIDGETGROUP_node_sbeam_refresh(const bContext *C, wmGizmoGroup *gzgr
     SpaceNode *snode = CTX_wm_space_node(C);
     bNode *node = nodeGetActive(snode->edittree);
 
-    /* need to set property here for undo. TODO would prefer to do this in _init */
+    /* Need to set property here for undo. TODO: would prefer to do this in _init. */
     PointerRNA nodeptr;
     RNA_pointer_create((ID *)snode->edittree, &RNA_CompositorNodeSunBeams, node, &nodeptr);
     WM_gizmo_target_property_def_rna(gz, "offset", &nodeptr, "source", -1);
@@ -604,7 +604,7 @@ static void WIDGETGROUP_node_corner_pin_refresh(const bContext *C, wmGizmoGroup
     SpaceNode *snode = CTX_wm_space_node(C);
     bNode *node = nodeGetActive(snode->edittree);
 
-    /* need to set property here for undo. TODO would prefer to do this in _init */
+    /* need to set property here for undo. TODO: would prefer to do this in _init. */
     int i = 0;
     for (bNodeSocket *sock = node->inputs.first; sock && i < 4; sock = sock->next) {
       if (sock->type == SOCK_VECTOR) {
diff --git a/source/blender/editors/space_node/node_intern.h b/source/blender/editors/space_node/node_intern.h
index 8dfc43333e3..58c3c8181b2 100644
--- a/source/blender/editors/space_node/node_intern.h
+++ b/source/blender/editors/space_node/node_intern.h
@@ -52,7 +52,7 @@ typedef struct bNodeLinkDrag {
   struct bNodeLinkDrag *next, *prev;
 
   /* List of links dragged by the operator.
-   * Note: This is a list of LinkData structs on top of the actual bNodeLinks.
+   * NOTE: This is a list of LinkData structs on top of the actual bNodeLinks.
    * This way the links can be added to the node tree while being stored in this list.
    */
   ListBase links;
@@ -291,7 +291,7 @@ void NODE_OT_output_file_move_active_socket(struct wmOperatorType *ot);
 
 void NODE_OT_switch_view_update(struct wmOperatorType *ot);
 
-/* Note: clipboard_cut is a simple macro of copy + delete */
+/* NOTE: clipboard_cut is a simple macro of copy + delete. */
 void NODE_OT_clipboard_copy(struct wmOperatorType *ot);
 void NODE_OT_clipboard_paste(struct wmOperatorType *ot);
 
diff --git a/source/blender/editors/space_node/node_ops.c b/source/blender/editors/space_node/node_ops.c
index e35b444aa11..ce65fe93f20 100644
--- a/source/blender/editors/space_node/node_ops.c
+++ b/source/blender/editors/space_node/node_ops.c
@@ -157,7 +157,7 @@ void ED_operatormacros_node(void)
   WM_operatortype_macro_define(ot, "NODE_OT_attach");
   WM_operatortype_macro_define(ot, "NODE_OT_insert_offset");
 
-  /* Note: Currently not in a default keymap or menu due to messy keymaps
+  /* NOTE: Currently not in a default keymap or menu due to messy keymaps
    * and tricky invoke functionality.
    * Kept around in case users want to make own shortcuts.
    */
diff --git a/source/blender/editors/space_node/node_select.cc b/source/blender/editors/space_node/node_select.cc
index 41820cd813c..2c8e78de8d2 100644
--- a/source/blender/editors/space_node/node_select.cc
+++ b/source/blender/editors/space_node/node_select.cc
@@ -330,7 +330,7 @@ static bool node_select_grouped_name(SpaceNode *snode, bNode *node_act, const bo
   pref_len_act = BLI_str_partition_ex_utf8(
       node_act->name, nullptr, delims, &sep, &suf_act, from_right);
 
-  /* Note: in case we are searching for suffix, and found none, use whole name as suffix. */
+  /* NOTE: in case we are searching for suffix, and found none, use whole name as suffix. */
   if (from_right && !(sep && suf_act)) {
     pref_len_act = 0;
     suf_act = node_act->name;
diff --git a/source/blender/editors/space_node/node_templates.cc b/source/blender/editors/space_node/node_templates.cc
index fae180ca6c5..cbe33fab64e 100644
--- a/source/blender/editors/space_node/node_templates.cc
+++ b/source/blender/editors/space_node/node_templates.cc
@@ -364,7 +364,7 @@ static void ui_node_link_items(NodeLinkArg *arg,
           NodeLinkItem *item = &items[i];
 
           item->socket_index = index;
-          /* note: int stemp->type is not fully reliable, not used for node group
+          /* NOTE: int stemp->type is not fully reliable, not used for node group
            * interface sockets. use the typeinfo->type instead.
            */
           item->socket_type = stemp->typeinfo->type;
diff --git a/source/blender/editors/space_node/space_node.c b/source/blender/editors/space_node/space_node.c
index f20a9409d90..d7e16dd69f1 100644
--- a/source/blender/editors/space_node/space_node.c
+++ b/source/blender/editors/space_node/space_node.c
@@ -345,7 +345,7 @@ static void node_area_listener(const wmSpaceTypeListenerParams *params)
   ScrArea *area = params->area;
   wmNotifier *wmn = params->notifier;
 
-  /* note, ED_area_tag_refresh will re-execute compositor */
+  /* NOTE: #ED_area_tag_refresh will re-execute compositor. */
   SpaceNode *snode = area->spacedata.first;
   /* shaderfrom is only used for new shading nodes, otherwise all shaders are from objects */
   short shader_type = snode->shaderfrom;
@@ -563,7 +563,7 @@ static SpaceLink *node_duplicate(SpaceLink *sl)
     BLI_listbase_clear(&snoden->runtime->linkdrag);
   }
 
-  /* Note: no need to set node tree user counts,
+  /* NOTE: no need to set node tree user counts,
    * the editor only keeps at least 1 (id_us_ensure_real),
    * which is already done by the original SpaceNode.
    */