Cleanup: un-wrap lines in headers, use doxy comments

2 files changed, 11 insertions, 10 deletions

diff --git a/source/blender/bmesh/intern/bmesh_mods.h b/source/blender/bmesh/intern/bmesh_mods.h
index 3d4eefbb598..36cb85bc9bc 100644
--- a/source/blender/bmesh/intern/bmesh_mods.h
+++ b/source/blender/bmesh/intern/bmesh_mods.h
@@ -79,15 +79,16 @@ bool BM_edge_rotate_check_degenerate(BMEdge *e, BMLoop *l1, BMLoop *l2);
 bool BM_edge_rotate_check_beauty(BMEdge *e, BMLoop *l1, BMLoop *l2);
 BMEdge *BM_edge_rotate(BMesh *bm, BMEdge *e, const bool ccw, const short check_flag);
 
-/* flags for BM_edge_rotate */
+/** Flags for #BM_edge_rotate */
 enum {
-  BM_EDGEROT_CHECK_EXISTS =
-      (1 << 0), /* disallow to rotate when the new edge matches an existing one */
-  BM_EDGEROT_CHECK_SPLICE =
-      (1 << 1), /* overrides existing check, if the edge already, rotate and merge them */
-  BM_EDGEROT_CHECK_DEGENERATE = (1
-                                 << 2), /* disallow creating bow-tie, concave or zero area faces */
-  BM_EDGEROT_CHECK_BEAUTY = (1 << 3),   /* disallow to rotate into ugly topology */
+  /** Disallow to rotate when the new edge matches an existing one. */
+  BM_EDGEROT_CHECK_EXISTS = (1 << 0),
+  /** Overrides existing check, if the edge already, rotate and merge them. */
+  BM_EDGEROT_CHECK_SPLICE = (1 << 1),
+  /** Disallow creating bow-tie, concave or zero area faces */
+  BM_EDGEROT_CHECK_DEGENERATE = (1 << 2),
+  /** Disallow to rotate into ugly topology. */
+  BM_EDGEROT_CHECK_BEAUTY = (1 << 3),
 };
 
 BMVert *BM_face_loop_separate(BMesh *bm, BMLoop *l_sep);
diff --git a/source/blender/bmesh/intern/bmesh_operator_api.h b/source/blender/bmesh/intern/bmesh_operator_api.h
index 3b543835586..f06a5fb8b13 100644
--- a/source/blender/bmesh/intern/bmesh_operator_api.h
+++ b/source/blender/bmesh/intern/bmesh_operator_api.h
@@ -300,8 +300,8 @@ typedef struct BMOpSlot {
 /* BMOpDefine->type_flag */
 typedef enum {
   BMO_OPTYPE_FLAG_NOP = 0,
-  BMO_OPTYPE_FLAG_UNTAN_MULTIRES =
-      (1 << 0), /* switch from multires tangent space to absolute coordinates */
+  /** Switch from multires tangent space to absolute coordinates. */
+  BMO_OPTYPE_FLAG_UNTAN_MULTIRES = (1 << 0),
   BMO_OPTYPE_FLAG_NORMALS_CALC = (1 << 1),
   BMO_OPTYPE_FLAG_SELECT_FLUSH = (1 << 2),
   BMO_OPTYPE_FLAG_SELECT_VALIDATE = (1 << 3),