Cleanup: remove redundant doxygen \file argument

Move \ingroup onto same line to be more compact and
make it clear the file is in the group.

28 files changed, 28 insertions, 56 deletions

diff --git a/source/blender/bmesh/tools/bmesh_beautify.c b/source/blender/bmesh/tools/bmesh_beautify.c
index 22cbc760571..67da84ab9e6 100644
--- a/source/blender/bmesh/tools/bmesh_beautify.c
+++ b/source/blender/bmesh/tools/bmesh_beautify.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_beautify.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Beautify the mesh by rotating edges between triangles
  * to more attractive positions until no more rotations can be made.
diff --git a/source/blender/bmesh/tools/bmesh_beautify.h b/source/blender/bmesh/tools/bmesh_beautify.h
index 65413e2a5ee..6a24a990661 100644
--- a/source/blender/bmesh/tools/bmesh_beautify.h
+++ b/source/blender/bmesh/tools/bmesh_beautify.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_BEAUTIFY_H__
 #define __BMESH_BEAUTIFY_H__
 
-/** \file blender/bmesh/tools/bmesh_beautify.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 enum {
diff --git a/source/blender/bmesh/tools/bmesh_bevel.c b/source/blender/bmesh/tools/bmesh_bevel.c
index 19da97ead32..5dea6da7b1d 100644
--- a/source/blender/bmesh/tools/bmesh_bevel.c
+++ b/source/blender/bmesh/tools/bmesh_bevel.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_bevel.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Main functions for beveling a BMesh (used by the tool and modifier)
  */
diff --git a/source/blender/bmesh/tools/bmesh_bevel.h b/source/blender/bmesh/tools/bmesh_bevel.h
index 1611555f9de..9d8e4de2772 100644
--- a/source/blender/bmesh/tools/bmesh_bevel.h
+++ b/source/blender/bmesh/tools/bmesh_bevel.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_BEVEL_H__
 #define __BMESH_BEVEL_H__
 
-/** \file blender/bmesh/tools/bmesh_bevel.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 struct MDeformVert;
diff --git a/source/blender/bmesh/tools/bmesh_bisect_plane.c b/source/blender/bmesh/tools/bmesh_bisect_plane.c
index de586868edf..804e7a3a7a4 100644
--- a/source/blender/bmesh/tools/bmesh_bisect_plane.c
+++ b/source/blender/bmesh/tools/bmesh_bisect_plane.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_bisect_plane.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Cut the geometry in half using a plane.
  *
diff --git a/source/blender/bmesh/tools/bmesh_bisect_plane.h b/source/blender/bmesh/tools/bmesh_bisect_plane.h
index 3abae666e59..34192b7ad98 100644
--- a/source/blender/bmesh/tools/bmesh_bisect_plane.h
+++ b/source/blender/bmesh/tools/bmesh_bisect_plane.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_BISECT_PLANE_H__
 #define __BMESH_BISECT_PLANE_H__
 
-/** \file blender/bmesh/tools/bmesh_bisect_plane.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 void BM_mesh_bisect_plane(
diff --git a/source/blender/bmesh/tools/bmesh_decimate.h b/source/blender/bmesh/tools/bmesh_decimate.h
index 9010ba23a14..bd02e35da21 100644
--- a/source/blender/bmesh/tools/bmesh_decimate.h
+++ b/source/blender/bmesh/tools/bmesh_decimate.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_DECIMATE_H__
 #define __BMESH_DECIMATE_H__
 
-/** \file blender/bmesh/tools/bmesh_decimate.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 void BM_mesh_decimate_collapse(
diff --git a/source/blender/bmesh/tools/bmesh_decimate_collapse.c b/source/blender/bmesh/tools/bmesh_decimate_collapse.c
index cec6e9305a4..95bcd960bda 100644
--- a/source/blender/bmesh/tools/bmesh_decimate_collapse.c
+++ b/source/blender/bmesh/tools/bmesh_decimate_collapse.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_decimate_collapse.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * BMesh decimator that uses an edge collapse method.
  */
diff --git a/source/blender/bmesh/tools/bmesh_decimate_dissolve.c b/source/blender/bmesh/tools/bmesh_decimate_dissolve.c
index 36baa55e30d..0f70e9d242f 100644
--- a/source/blender/bmesh/tools/bmesh_decimate_dissolve.c
+++ b/source/blender/bmesh/tools/bmesh_decimate_dissolve.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_decimate_dissolve.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * BMesh decimator that dissolves flat areas into polygons (ngons).
  */
diff --git a/source/blender/bmesh/tools/bmesh_decimate_unsubdivide.c b/source/blender/bmesh/tools/bmesh_decimate_unsubdivide.c
index 32e50127ed9..908ba470e32 100644
--- a/source/blender/bmesh/tools/bmesh_decimate_unsubdivide.c
+++ b/source/blender/bmesh/tools/bmesh_decimate_unsubdivide.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_decimate_unsubdivide.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * BMesh decimator that uses a grid un-subdivide method.
  */
diff --git a/source/blender/bmesh/tools/bmesh_edgenet.c b/source/blender/bmesh/tools/bmesh_edgenet.c
index 8bb25758068..92e4a8caefb 100644
--- a/source/blender/bmesh/tools/bmesh_edgenet.c
+++ b/source/blender/bmesh/tools/bmesh_edgenet.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_edgenet.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Edgenet Fill.
  */
diff --git a/source/blender/bmesh/tools/bmesh_edgenet.h b/source/blender/bmesh/tools/bmesh_edgenet.h
index 631b942ba45..065f5681edc 100644
--- a/source/blender/bmesh/tools/bmesh_edgenet.h
+++ b/source/blender/bmesh/tools/bmesh_edgenet.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_EDGENET_H__
 #define __BMESH_EDGENET_H__
 
-/** \file blender/bmesh/tools/bmesh_edgenet.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 void BM_mesh_edgenet(
diff --git a/source/blender/bmesh/tools/bmesh_edgesplit.c b/source/blender/bmesh/tools/bmesh_edgesplit.c
index 8e10e09cbe6..100609f9bf6 100644
--- a/source/blender/bmesh/tools/bmesh_edgesplit.c
+++ b/source/blender/bmesh/tools/bmesh_edgesplit.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_edgesplit.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Edge-Split.
  */
diff --git a/source/blender/bmesh/tools/bmesh_edgesplit.h b/source/blender/bmesh/tools/bmesh_edgesplit.h
index b96fbc999c3..6da9ecb48a0 100644
--- a/source/blender/bmesh/tools/bmesh_edgesplit.h
+++ b/source/blender/bmesh/tools/bmesh_edgesplit.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_EDGESPLIT_H__
 #define __BMESH_EDGESPLIT_H__
 
-/** \file blender/bmesh/tools/bmesh_edgesplit.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 void BM_mesh_edgesplit(
diff --git a/source/blender/bmesh/tools/bmesh_intersect.c b/source/blender/bmesh/tools/bmesh_intersect.c
index a57f0f3b083..3181c09545a 100644
--- a/source/blender/bmesh/tools/bmesh_intersect.c
+++ b/source/blender/bmesh/tools/bmesh_intersect.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_intersect.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Cut meshes along intersections.
  *
diff --git a/source/blender/bmesh/tools/bmesh_intersect.h b/source/blender/bmesh/tools/bmesh_intersect.h
index 3320363eca8..4e21f530ba8 100644
--- a/source/blender/bmesh/tools/bmesh_intersect.h
+++ b/source/blender/bmesh/tools/bmesh_intersect.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_INTERSECT_H__
 #define __BMESH_INTERSECT_H__
 
-/** \file blender/bmesh/tools/bmesh_intersect.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 bool BM_mesh_intersect(
diff --git a/source/blender/bmesh/tools/bmesh_path.c b/source/blender/bmesh/tools/bmesh_path.c
index 645c5514a14..3dee1dac20f 100644
--- a/source/blender/bmesh/tools/bmesh_path.c
+++ b/source/blender/bmesh/tools/bmesh_path.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_path.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Find a path between 2 elements.
  */
diff --git a/source/blender/bmesh/tools/bmesh_path.h b/source/blender/bmesh/tools/bmesh_path.h
index f1235315e98..9f1a1890932 100644
--- a/source/blender/bmesh/tools/bmesh_path.h
+++ b/source/blender/bmesh/tools/bmesh_path.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_PATH_H__
 #define __BMESH_PATH_H__
 
-/** \file blender/bmesh/tools/bmesh_path.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 struct BMCalcPathParams {
diff --git a/source/blender/bmesh/tools/bmesh_path_region.c b/source/blender/bmesh/tools/bmesh_path_region.c
index 2fc343cf183..e2150f0a78a 100644
--- a/source/blender/bmesh/tools/bmesh_path_region.c
+++ b/source/blender/bmesh/tools/bmesh_path_region.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_path_region.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Find the region defined by the path(s) between 2 elements.
  * (path isn't ordered).
diff --git a/source/blender/bmesh/tools/bmesh_path_region.h b/source/blender/bmesh/tools/bmesh_path_region.h
index 37e4dca8f51..d7b5e41c01a 100644
--- a/source/blender/bmesh/tools/bmesh_path_region.h
+++ b/source/blender/bmesh/tools/bmesh_path_region.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_PATH_REGION_H__
 #define __BMESH_PATH_REGION_H__
 
-/** \file blender/bmesh/tools/bmesh_path_region.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 struct LinkNode *BM_mesh_calc_path_region_vert(
diff --git a/source/blender/bmesh/tools/bmesh_region_match.c b/source/blender/bmesh/tools/bmesh_region_match.c
index 8acf7569dab..955269a78e9 100644
--- a/source/blender/bmesh/tools/bmesh_region_match.c
+++ b/source/blender/bmesh/tools/bmesh_region_match.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_region_match.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Given a contiguous region of faces,
  * find multiple matching regions (based on topology) and return them.
diff --git a/source/blender/bmesh/tools/bmesh_region_match.h b/source/blender/bmesh/tools/bmesh_region_match.h
index a95ef64fdb8..9b16986590c 100644
--- a/source/blender/bmesh/tools/bmesh_region_match.h
+++ b/source/blender/bmesh/tools/bmesh_region_match.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_REGION_MATCH_H__
 #define __BMESH_REGION_MATCH_H__
 
-/** \file blender/bmesh/tools/bmesh_region_match.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 int BM_mesh_region_match(
diff --git a/source/blender/bmesh/tools/bmesh_separate.c b/source/blender/bmesh/tools/bmesh_separate.c
index 4b2a7565a60..de38d438daa 100644
--- a/source/blender/bmesh/tools/bmesh_separate.c
+++ b/source/blender/bmesh/tools/bmesh_separate.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_separate.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * BMesh separate, disconnects a set of faces from all others,
  * so they don't share any vertices/edges with other faces.
diff --git a/source/blender/bmesh/tools/bmesh_separate.h b/source/blender/bmesh/tools/bmesh_separate.h
index a8f79b2239d..22353d5a6a7 100644
--- a/source/blender/bmesh/tools/bmesh_separate.h
+++ b/source/blender/bmesh/tools/bmesh_separate.h
@@ -17,8 +17,7 @@
 #ifndef __BMESH_SEPARATE_H__
 #define __BMESH_SEPARATE_H__
 
-/** \file blender/bmesh/tools/bmesh_separate.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  */
 
 void BM_mesh_separate_faces(
diff --git a/source/blender/bmesh/tools/bmesh_triangulate.c b/source/blender/bmesh/tools/bmesh_triangulate.c
index c21faa6b5d6..4617dc006a2 100644
--- a/source/blender/bmesh/tools/bmesh_triangulate.c
+++ b/source/blender/bmesh/tools/bmesh_triangulate.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_triangulate.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Triangulate.
  */
diff --git a/source/blender/bmesh/tools/bmesh_triangulate.h b/source/blender/bmesh/tools/bmesh_triangulate.h
index 18fb93f0199..22a50abfaf7 100644
--- a/source/blender/bmesh/tools/bmesh_triangulate.h
+++ b/source/blender/bmesh/tools/bmesh_triangulate.h
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_triangulate.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Triangulate.
  */
diff --git a/source/blender/bmesh/tools/bmesh_wireframe.c b/source/blender/bmesh/tools/bmesh_wireframe.c
index a41f96e08d3..45fe0b0f6bc 100644
--- a/source/blender/bmesh/tools/bmesh_wireframe.c
+++ b/source/blender/bmesh/tools/bmesh_wireframe.c
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_wireframe.c
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Creates a solid wireframe from connected faces.
  */
diff --git a/source/blender/bmesh/tools/bmesh_wireframe.h b/source/blender/bmesh/tools/bmesh_wireframe.h
index 867f5f3ca3a..026a19e5484 100644
--- a/source/blender/bmesh/tools/bmesh_wireframe.h
+++ b/source/blender/bmesh/tools/bmesh_wireframe.h
@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file blender/bmesh/tools/bmesh_wireframe.h
- *  \ingroup bmesh
+/** \file \ingroup bmesh
  *
  * Wire Frame.
  */