Cleanup: doxygen comments

Also correct some outdated symbol references,
add missing 'name' commands.

3 files changed, 12 insertions, 7 deletions

diff --git a/source/blender/editors/space_view3d/view3d_select.c b/source/blender/editors/space_view3d/view3d_select.c
index 3eee76277e8..092142a83cd 100644
--- a/source/blender/editors/space_view3d/view3d_select.c
+++ b/source/blender/editors/space_view3d/view3d_select.c
@@ -3925,8 +3925,9 @@ static bool mball_circle_select(ViewContext *vc,
   return data.is_changed;
 }
 
-/** Callbacks for circle selection in Editmode */
-
+/**
+ * Callbacks for circle selection in Editmode
+ */
 static bool obedit_circle_select(bContext *C,
                                  ViewContext *vc,
                                  wmGenericUserData *wm_userdata,
diff --git a/source/blender/editors/space_view3d/view3d_snap.c b/source/blender/editors/space_view3d/view3d_snap.c
index 9a2f4062631..35a116dc4b3 100644
--- a/source/blender/editors/space_view3d/view3d_snap.c
+++ b/source/blender/editors/space_view3d/view3d_snap.c
@@ -231,7 +231,8 @@ void VIEW3D_OT_snap_selected_to_grid(wmOperatorType *ot)
 
 /* *************************************************** */
 
-/** Snaps the selection as a whole (use_offset=true) or each selected object to the given location.
+/**
+ * Snaps the selection as a whole (use_offset=true) or each selected object to the given location.
  *
  * \param snap_target_global: a location in global space to snap to
  * (eg. 3D cursor or active object).
@@ -762,10 +763,11 @@ void VIEW3D_OT_snap_cursor_to_selected(wmOperatorType *ot)
 
 /* ********************************************** */
 
-/** Calculates the center position of the active object in global space.
+/**
+ * Calculates the center position of the active object in global space.
  *
  * Note: this could be exported to be a generic function.
- * see: calculateCenterActive
+ * see: #calculateCenterActive
  */
 static bool snap_calc_active_center(bContext *C, const bool select_only, float r_center[3])
 {
diff --git a/source/blender/editors/space_view3d/view3d_view.c b/source/blender/editors/space_view3d/view3d_view.c
index c64ace77a79..d7f7e96ba08 100644
--- a/source/blender/editors/space_view3d/view3d_view.c
+++ b/source/blender/editors/space_view3d/view3d_view.c
@@ -963,8 +963,10 @@ static bool drw_select_filter_object_mode_lock(Object *ob, void *user_data)
   return BKE_object_is_mode_compat(ob, obact->mode);
 }
 
-/** Implement #VIEW3D_SELECT_FILTER_WPAINT_POSE_MODE_LOCK for special case when
- * we want to select pose bones (this doesn't switch modes). */
+/**
+ * Implement #VIEW3D_SELECT_FILTER_WPAINT_POSE_MODE_LOCK for special case when
+ * we want to select pose bones (this doesn't switch modes).
+ */
 static bool drw_select_filter_object_mode_lock_for_weight_paint(Object *ob, void *user_data)
 {
   LinkNode *ob_pose_list = user_data;