doxygen: add newline after \file

While \file doesn't need an argument, it can't have another doxy
command after it.

source/blender/bmesh/bmesh.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_H__
 #define __BMESH_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * \addtogroup bmesh BMesh
  *

source/blender/bmesh/bmesh_class.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_CLASS_H__
 #define __BMESH_CLASS_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 /* bmesh data structures */

source/blender/bmesh/bmesh_tools.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_TOOLS_H__
 #define __BMESH_TOOLS_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Utility functions that operate directly on the BMesh,
  * These can be used by both Modifiers and BMesh-Operators.

source/blender/bmesh/intern/bmesh_callback_generic.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BM element callback functions.
  */

source/blender/bmesh/intern/bmesh_callback_generic.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_CALLBACK_GENERIC_H__
 #define __BMESH_CALLBACK_GENERIC_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 bool BM_elem_cb_check_hflag_enabled(BMElem *, void *user_data);

source/blender/bmesh/intern/bmesh_construct.c

@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BM construction functions.
  */

source/blender/bmesh/intern/bmesh_construct.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_CONSTRUCT_H__
 #define __BMESH_CONSTRUCT_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 struct BMAllocTemplate;

source/blender/bmesh/intern/bmesh_core.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Core BMesh functions for adding, removing BMesh elements.
  */

source/blender/bmesh/intern/bmesh_core.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_CORE_H__
 #define __BMESH_CORE_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 BMFace *BM_face_copy(

source/blender/bmesh/intern/bmesh_delete.c

@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BM remove functions.
  */

source/blender/bmesh/intern/bmesh_delete.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_DELETE_H__
 #define __BMESH_DELETE_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 void BMO_mesh_delete_oflag_tagged(BMesh *bm, const short oflag, const char htype);

source/blender/bmesh/intern/bmesh_edgeloop.c

@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Generic utility functions for getting edge loops from a mesh.
  */

source/blender/bmesh/intern/bmesh_edgeloop.h

@@ -20,7 +20,8 @@
 #ifndef __BMESH_EDGELOOP_H__
 #define __BMESH_EDGELOOP_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 struct BMEdgeLoopStore;

source/blender/bmesh/intern/bmesh_error.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_ERROR_H__
 #define __BMESH_ERROR_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 /*----------- bmop error system ----------*/

source/blender/bmesh/intern/bmesh_inline.h

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BM Inline functions.
  */

source/blender/bmesh/intern/bmesh_interp.c

@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Functions for interpolating data across the surface of a mesh.
  */

source/blender/bmesh/intern/bmesh_interp.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_INTERP_H__
 #define __BMESH_INTERP_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 struct LinkNode;

source/blender/bmesh/intern/bmesh_iterators.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Functions to abstract looping over bmesh data structures.
  *

source/blender/bmesh/intern/bmesh_iterators.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_ITERATORS_H__
 #define __BMESH_ITERATORS_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 /**

source/blender/bmesh/intern/bmesh_iterators_inline.h

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh inline iterator functions.
  */

source/blender/bmesh/intern/bmesh_log.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * The BMLog is an interface for storing undo/redo steps as a BMesh is
  * modified. It only stores changes to the BMesh, not full copies.

source/blender/bmesh/intern/bmesh_log.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_LOG_H__
 #define __BMESH_LOG_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 struct BMFace;

source/blender/bmesh/intern/bmesh_marking.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Selection routines for bmesh structures.
  * This is actually all old code ripped from

source/blender/bmesh/intern/bmesh_marking.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_MARKING_H__
 #define __BMESH_MARKING_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 typedef struct BMEditSelection {

source/blender/bmesh/intern/bmesh_mesh.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BM mesh level functions.
  */

source/blender/bmesh/intern/bmesh_mesh.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_MESH_H__
 #define __BMESH_MESH_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 struct BMAllocTemplate;

source/blender/bmesh/intern/bmesh_mesh_conv.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BM mesh conversion functions.
  *

source/blender/bmesh/intern/bmesh_mesh_conv.h

@@ -20,7 +20,8 @@
 #ifndef __BMESH_MESH_CONV_H__
 #define __BMESH_MESH_CONV_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 struct Main;

source/blender/bmesh/intern/bmesh_mesh_validate.c

@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BM mesh validation function.
  */

source/blender/bmesh/intern/bmesh_mesh_validate.h

@@ -20,7 +20,8 @@
 #ifndef __BMESH_MESH_VALIDATE_H__
 #define __BMESH_MESH_VALIDATE_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 bool BM_mesh_validate(BMesh *bm);

source/blender/bmesh/intern/bmesh_mods.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * This file contains functions for locally modifying
  * the topology of existing mesh data. (split, join, flip etc).

source/blender/bmesh/intern/bmesh_mods.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_MODS_H__
 #define __BMESH_MODS_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 bool BM_vert_dissolve(BMesh *bm, BMVert *v);

source/blender/bmesh/intern/bmesh_opdefines.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh operator definitions.
  *

source/blender/bmesh/intern/bmesh_operator_api.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_OPERATOR_API_H__
 #define __BMESH_OPERATOR_API_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 #ifdef __cplusplus

source/blender/bmesh/intern/bmesh_operator_api_inline.h

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh inline operator functions.
  */

source/blender/bmesh/intern/bmesh_operators.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh operator access.
  */

source/blender/bmesh/intern/bmesh_operators.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_OPERATORS_H__
 #define __BMESH_OPERATORS_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 /*see comments in intern/bmesh_opdefines.c for documentation of specific operators*/

source/blender/bmesh/intern/bmesh_operators_private.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_OPERATORS_PRIVATE_H__
 #define __BMESH_OPERATORS_PRIVATE_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 struct BMOperator;

source/blender/bmesh/intern/bmesh_polygon.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * This file contains code for dealing
  * with polygons (normal/area calculation,

source/blender/bmesh/intern/bmesh_polygon.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_POLYGON_H__
 #define __BMESH_POLYGON_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 struct Heap;

source/blender/bmesh/intern/bmesh_polygon_edgenet.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * This file contains functions for splitting faces into isolated regions,
  * defined by connected edges.

source/blender/bmesh/intern/bmesh_polygon_edgenet.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_POLYGON_EDGENET_H__
 #define __BMESH_POLYGON_EDGENET_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 bool BM_face_split_edgenet(

source/blender/bmesh/intern/bmesh_private.h

@@ -20,7 +20,8 @@
 #ifndef __BMESH_PRIVATE_H__
 #define __BMESH_PRIVATE_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Private function prototypes for bmesh public API.
  * This file is a grab-bag of functions from various

source/blender/bmesh/intern/bmesh_query.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * This file contains functions for answering common
  * Topological and geometric queries about a mesh, such

source/blender/bmesh/intern/bmesh_query.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_QUERY_H__
 #define __BMESH_QUERY_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 bool    BM_vert_in_face(BMVert *v, BMFace *f) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL();

source/blender/bmesh/intern/bmesh_query_inline.h

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 

source/blender/bmesh/intern/bmesh_structure.c

@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Low level routines for manipulating the BM structure.
  */

source/blender/bmesh/intern/bmesh_structure.h

@@ -20,7 +20,8 @@
 #ifndef __BMESH_STRUCTURE_H__
 #define __BMESH_STRUCTURE_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * The lowest level of functionality for manipulating bmesh structures.
  * None of these functions should ever be exported to the rest of Blender.

source/blender/bmesh/intern/bmesh_structure_inline.h

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh inline operator functions.
  */

source/blender/bmesh/intern/bmesh_walkers.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh Walker API.
  */

source/blender/bmesh/intern/bmesh_walkers.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_WALKERS_H__
 #define __BMESH_WALKERS_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 /*

source/blender/bmesh/intern/bmesh_walkers_impl.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh Walker Code.
  */

source/blender/bmesh/intern/bmesh_walkers_private.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_WALKERS_PRIVATE_H__
 #define __BMESH_WALKERS_PRIVATE_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh walker API.
  */

source/blender/bmesh/operators/bmo_beautify.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Beautify the mesh by rotating edges between triangles
  * to more attractive positions until no more rotations can be made.

source/blender/bmesh/operators/bmo_bevel.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Bevel wrapper around #BM_mesh_bevel
  */

source/blender/bmesh/operators/bmo_bisect_plane.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Wrapper around #BM_mesh_bisect_plane
  */

source/blender/bmesh/operators/bmo_bridge.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Connect verts across faces (splits faces) and bridge tool.
  */

source/blender/bmesh/operators/bmo_connect.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Connect verts across faces (splits faces).
  */

source/blender/bmesh/operators/bmo_connect_concave.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Connect vertices so all resulting faces are convex.
  *

source/blender/bmesh/operators/bmo_connect_nonplanar.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Connect verts non-planer faces iteratively (splits faces).
  */

source/blender/bmesh/operators/bmo_connect_pair.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Connect vertex pair across multiple faces (splits faces).
  */

source/blender/bmesh/operators/bmo_create.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Create faces or edges (Fkey by default).
  */

source/blender/bmesh/operators/bmo_dissolve.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Removes isolated geometry regions without creating holes in the mesh.
  */

source/blender/bmesh/operators/bmo_dupe.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Duplicate, Split, Split operators.
  */

source/blender/bmesh/operators/bmo_edgenet.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Edge-Net for filling in open edge-loops.
  */

source/blender/bmesh/operators/bmo_extrude.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Extrude faces and solidify.
  */

source/blender/bmesh/operators/bmo_fill_attribute.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Fill in geometry with the attributes of their adjacent data.
  */

source/blender/bmesh/operators/bmo_fill_edgeloop.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Fill discreet edge loop(s) with faces.
  */

source/blender/bmesh/operators/bmo_fill_grid.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Fill 2 isolated, open edge loops with a grid of quads.
  */

source/blender/bmesh/operators/bmo_fill_holes.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Fill boundary edge loop(s) with faces.
  */

source/blender/bmesh/operators/bmo_hull.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Create a convex hull using bullet physics library.
  */

source/blender/bmesh/operators/bmo_inset.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Inset face regions.
  * Inset individual faces.

source/blender/bmesh/operators/bmo_join_triangles.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Convert triangle to quads.
  *

source/blender/bmesh/operators/bmo_mesh_conv.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * This file contains functions
  * for converting a Mesh

source/blender/bmesh/operators/bmo_mirror.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Basic mirror, optionally with UVs's.
  */

source/blender/bmesh/operators/bmo_normals.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * normal recalculation.
  */
@@ -50,7 +51,7 @@ static bool bmo_recalc_normal_loop_filter_cb(const BMLoop *l, void *UNUSED(user_
  * +
  * |\ <- face
  * + +
- *  \ \
+ * \ \
  *   \ \
  *    \ +--------------+
  *     \               |

source/blender/bmesh/operators/bmo_offset_edgeloops.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Simple edge offset functionality.
  *

source/blender/bmesh/operators/bmo_planar_faces.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Iteratively flatten 4+ sided faces.
  */

source/blender/bmesh/operators/bmo_poke.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Pokes a face.
  *

source/blender/bmesh/operators/bmo_primitive.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Primitive shapes.
  */

source/blender/bmesh/operators/bmo_removedoubles.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Welding and merging functionality.
  */

source/blender/bmesh/operators/bmo_rotate_edges.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Rotate edges topology that share two faces.
  */

source/blender/bmesh/operators/bmo_smooth_laplacian.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Advanced smoothing.
  */

source/blender/bmesh/operators/bmo_split_edges.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Just a wrapper around #BM_mesh_edgesplit
  */

source/blender/bmesh/operators/bmo_subdivide.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Edge based subdivision with various subdivision patterns.
  */

source/blender/bmesh/operators/bmo_subdivide_edgering.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * This operator is a special edge-ring subdivision tool
  * which gives special options for interpolation.

source/blender/bmesh/operators/bmo_symmetrize.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Makes the mesh symmetrical by splitting along an axis and duplicating the geometry.
  */

source/blender/bmesh/operators/bmo_triangulate.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Triangulate faces, also defines triangle fill.
  */

source/blender/bmesh/operators/bmo_unsubdivide.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Pattern based geometry reduction which has the result similar to undoing
  * a subdivide operation.

source/blender/bmesh/operators/bmo_utils.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * utility bmesh operators, e.g. transform,
  * translate, rotate, scale, etc.

source/blender/bmesh/operators/bmo_wireframe.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Creates a solid wireframe from connected faces.
  */

source/blender/bmesh/tools/bmesh_beautify.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Beautify the mesh by rotating edges between triangles
  * to more attractive positions until no more rotations can be made.

source/blender/bmesh/tools/bmesh_beautify.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_BEAUTIFY_H__
 #define __BMESH_BEAUTIFY_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 enum {

source/blender/bmesh/tools/bmesh_bevel.c

@@ -5889,7 +5889,7 @@ static void set_profile_spacing(BevelParams *bp)
  * Assume we have a situation like:
  *
  * a                 d
- *  \               /
+ * \               /
  * A \             / C
  *    \ th1    th2/
  *     b---------c

source/blender/bmesh/tools/bmesh_bisect_plane.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * Cut the geometry in half using a plane.
  *

source/blender/bmesh/tools/bmesh_bisect_plane.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_BISECT_PLANE_H__
 #define __BMESH_BISECT_PLANE_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 void BM_mesh_bisect_plane(

source/blender/bmesh/tools/bmesh_decimate.h

@@ -17,7 +17,8 @@
 #ifndef __BMESH_DECIMATE_H__
 #define __BMESH_DECIMATE_H__
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  */
 
 void BM_mesh_decimate_collapse(

source/blender/bmesh/tools/bmesh_decimate_collapse.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh decimator that uses an edge collapse method.
  */

source/blender/bmesh/tools/bmesh_decimate_dissolve.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh decimator that dissolves flat areas into polygons (ngons).
  */

source/blender/bmesh/tools/bmesh_decimate_unsubdivide.c

@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bmesh
+/** \file
+ * \ingroup bmesh
  *
  * BMesh decimator that uses a grid un-subdivide method.
  */