code comments: bmesh operator doxy header descriptions.

source/blender/bmesh/operators/bmo_beautify.c

@@ -22,6 +22,19 @@
 
 /** \file blender/bmesh/operators/bmo_beautify.c
  *  \ingroup bmesh
+ *
+ * Beautify the mesh by rotating edes between triangles
+ * to more attractive positions until no more rotations can be made.
+ *
+ * In princible this is very simple however there is the possability of
+ * going into an eternal loop where edges keep rotating.
+ * To avoid this - each edge stores a hash of it previous
+ * states so as not to rotate back.
+ *
+ * TODO
+ * - Take face normals into account.
+ * - Use a stack of rotations to perform the best onces first
+ *   similar to edge-collapse-decimate.
  */
 
 #include "BLI_math.h"

source/blender/bmesh/operators/bmo_bevel.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_bevel.c
  *  \ingroup bmesh
+ *
+ * Bevel wrapper around #BM_mesh_bevel
  */
 
 #include "BLI_utildefines.h"

source/blender/bmesh/operators/bmo_connect.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_connect.c
  *  \ingroup bmesh
+ *
+ * Connect verts across faces (splits faces) and bridge tool.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_create.c

@@ -15,13 +15,15 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  *
- * Contributor(s): Joseph Eagar.
+ * Contributor(s): Joseph Eagar, Campbell Barton.
  *
  * ***** END GPL LICENSE BLOCK *****
  */
 
 /** \file blender/bmesh/operators/bmo_create.c
- *  \ingroup bmesh
+ *  \ingroup bmesh 
+ *
+ * Create faces or edges (Fkey by default).
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_dissolve.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_dissolve.c
  *  \ingroup bmesh
+ *
+ * Removes isolated geometry regions without creating holes in the mesh.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_dupe.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_dupe.c
  *  \ingroup bmesh
+ *
+ * Duplicate, Split, Spint operators.
  */
 
 #include "MEM_guardedalloc.h"
@@ -124,7 +126,6 @@ static BMEdge *copy_edge(BMOperator *op,
  *
  * Copy an existing face from one bmesh to another.
  */
-
 static BMFace *copy_face(BMOperator *op,
                          BMOpSlot *slot_facemap_out,
                          BMesh *source_mesh,
@@ -183,7 +184,6 @@ static BMFace *copy_face(BMOperator *op,
  *
  * Internal Copy function.
  */
-
 static void bmo_mesh_copy(BMOperator *op, BMesh *bm_src, BMesh *bm_dst)
 {
 
@@ -320,7 +320,6 @@ static void bmo_mesh_copy(BMOperator *op, BMesh *bm_src, BMesh *bm_dst)
  * BMOP_DUPE_ENEW: Buffer containing pointers to the new mesh edges
  * BMOP_DUPE_FNEW: Buffer containing pointers to the new mesh faces
  */
-
 void bmo_duplicate_exec(BMesh *bm, BMOperator *op)
 {
 	BMOperator *dupeop = op;
@@ -378,11 +377,10 @@ void BMO_dupe_from_flag(BMesh *bm, int htype, const char hflag)
  * BMOP_DUPE_EOUTPUT: Buffer containing pointers to the split mesh edges
  * BMOP_DUPE_FOUTPUT: Buffer containing pointers to the split mesh faces
  */
-
-#define SPLIT_INPUT 1
-
 void bmo_split_exec(BMesh *bm, BMOperator *op)
 {
+#define SPLIT_INPUT 1
+
 	BMOperator *splitop = op;
 	BMOperator dupeop;
 	BMOperator delop;
@@ -455,6 +453,8 @@ void bmo_split_exec(BMesh *bm, BMOperator *op)
 	/* cleanup */
 	BMO_op_finish(bm, &delop);
 	BMO_op_finish(bm, &dupeop);
+
+#undef SPLIT_INPUT
 }
 
 
@@ -478,7 +478,6 @@ void bmo_delete_exec(BMesh *bm, BMOperator *op)
  * Extrude or duplicate geometry a number of times,
  * rotating and possibly translating after each step
  */
-
 void bmo_spin_exec(BMesh *bm, BMOperator *op)
 {
 	BMOperator dupop, extop;

source/blender/bmesh/operators/bmo_edgeloop_fill.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_edgeloop_fill.c
  *  \ingroup bmesh
+ *
+ * Fill discreet edge loop(s) with faces.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_edgenet.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_edgenet.c
  *  \ingroup bmesh
+ *
+ * Edge-Net for filling in open edge-loops.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_extrude.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_extrude.c
  *  \ingroup bmesh
+ *
+ * Extrude faces and solidify.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_hull.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_hull.c
  *  \ingroup bmesh
+ *
+ * Create a convex hull using bullet physics library.
  */
 
 #ifdef WITH_BULLET

source/blender/bmesh/operators/bmo_inset.c

@@ -22,6 +22,11 @@
 
 /** \file blender/bmesh/operators/bmo_inset.c
  *  \ingroup bmesh
+ *
+ * Inset face regions.
+ *
+ * TODO
+ * - Inset indervidual faces.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_join_triangles.c

@@ -22,6 +22,11 @@
 
 /** \file blender/bmesh/operators/bmo_join_triangles.c
  *  \ingroup bmesh
+ *
+ * Convert triangle to quads.
+ *
+ * TODO
+ * - convert triangles to any sided faces, not just quads.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_mirror.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_mirror.c
  *  \ingroup bmesh
+ *
+ * Basic mirror, optionally with UVs's.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_primitive.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_primitive.c
  *  \ingroup bmesh
+ *
+ * Primitive shapes.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_removedoubles.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_removedoubles.c
  *  \ingroup bmesh
+ *
+ * Welding and merging functionality.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_smooth_laplacian.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_smooth_laplacian.c
  *  \ingroup bmesh
+ *
+ * Advanced smoothing.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_subdivide.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_subdivide.c
  *  \ingroup bmesh
+ *
+ * Edge based subdivision with various subdivision patterns.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_symmetrize.c

@@ -20,6 +20,13 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/bmesh/operators/bmo_symmetrize.c
+ *  \ingroup bmesh
+ *
+ * Makes the mesh symmetrical by splitting along an axis and duplicating the geometry.
+ */
+
+
 #include "MEM_guardedalloc.h"
 
 #include "BLI_array.h"

source/blender/bmesh/operators/bmo_triangulate.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_triangulate.c
  *  \ingroup bmesh
+ *
+ * Triangulate faces, also defines triangle fill.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/bmesh/operators/bmo_unsubdivide.c

@@ -22,6 +22,9 @@
 
 /** \file blender/bmesh/operators/bmo_unsubdivide.c
  *  \ingroup bmesh
+ *
+ * Pattern based geometry reduction which has the result similar to undoing
+ * a subdivide operation.
  */
 
 #include "BLI_math.h"

source/blender/bmesh/operators/bmo_wireframe.c

@@ -22,6 +22,8 @@
 
 /** \file blender/bmesh/operators/bmo_wireframe.c
  *  \ingroup bmesh
+ *
+ * Creates a solid wireframe from conected faces.
  */
 
 #include "MEM_guardedalloc.h"