Cleanup: add file doxy comments

source/blender/blenkernel/BKE_mesh_tangent.h

@@ -20,6 +20,10 @@
 #ifndef __BKE_MESH_TANGENT_H__
 #define __BKE_MESH_TANGENT_H__
 
+/** \file BKE_mesh_tangent.h
+ *  \ingroup bke
+ */
+
 void BKE_mesh_calc_loop_tangent_single_ex(
         const struct MVert *mverts, const int numVerts, const struct MLoop *mloops,
         float (*r_looptangent)[4], float (*loopnors)[3], const struct MLoopUV *loopuv,

source/blender/blenkernel/intern/armature.c

@@ -27,7 +27,6 @@
  *  \ingroup bke
  */
 
-
 #include <ctype.h>
 #include <stdlib.h>
 #include <math.h>

source/blender/blenkernel/intern/armature_update.c

@@ -26,6 +26,10 @@
  * Defines and code for core node types
  */
 
+/** \file blender/blenkernel/intern/armature_update.c
+ *  \ingroup bke
+ */
+
 #include "MEM_guardedalloc.h"
 
 #include "BLI_utildefines.h"

source/blender/blenkernel/intern/subdiv_converter.c

@@ -23,6 +23,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/blenkernel/intern/subdiv_converter.c
+ *  \ingroup bke
+ */
+
 #include "subdiv_converter.h"
 
 #include "BLI_utildefines.h"

source/blender/blenkernel/intern/subdiv_converter.h

@@ -26,6 +26,10 @@
 #ifndef __SUBDIV_CONVERTER_H__
 #define __SUBDIV_CONVERTER_H__
 
+/** \file blender/blenkernel/intern/subdiv_converter.h
+ *  \ingroup bke
+ */
+
 #include "BKE_subdiv.h"
 
 /* NOTE: Was initially used to get proper enumerator types, but this makes

source/blender/blenkernel/intern/subdiv_converter_mesh.c

@@ -23,6 +23,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/blenkernel/intern/subdiv_converter_mesh.c
+ *  \ingroup bke
+ */
+
 #include "subdiv_converter.h"
 
 #include <string.h>

source/blender/blenlib/BLI_polyfill_2d.h

@@ -21,6 +21,10 @@
 #ifndef __BLI_POLYFILL_2D_H__
 #define __BLI_POLYFILL_2D_H__
 
+/** \file BLI_polyfill_2d.h
+ *  \ingroup bli
+ */
+
 struct MemArena;
 
 void BLI_polyfill_calc_arena(

source/blender/blenlib/BLI_polyfill_2d_beautify.h

@@ -21,6 +21,10 @@
 #ifndef __BLI_POLYFILL_2D_BEAUTIFY_H__
 #define __BLI_POLYFILL_2D_BEAUTIFY_H__
 
+/** \file BLI_polyfill_2d_beautify.h
+ *  \ingroup bli
+ */
+
 struct Heap;
 struct MemArena;
 

source/blender/collada/AnimationExporter.cpp

@@ -20,6 +20,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file AnimationExporter.cpp
+ *  \ingroup collada
+ */
+
 #include "GeometryExporter.h"
 #include "AnimationExporter.h"
 #include "MaterialExporter.h"

source/blender/collada/AnimationExporter.h

@@ -20,6 +20,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file AnimationExporter.h
+ *  \ingroup collada
+ */
+
 #include <stdlib.h>
 #include <stdio.h>
 #include <math.h>

source/blender/editors/io/io_alembic.c

@@ -22,6 +22,10 @@
  *
  */
 
+/** \file blender/editors/io/io_alembic.c
+ *  \ingroup editor/io
+ */
+
 #ifdef WITH_ALEMBIC
 
 /* needed for directory lookup */

source/blender/editors/io/io_cache.c

@@ -22,6 +22,10 @@
  *
  */
 
+/** \file blender/editors/io/io_cache.c
+ *  \ingroup editor/io
+ */
+
 #include "MEM_guardedalloc.h"
 
 #include "DNA_cachefile_types.h"

source/blender/editors/object/object_facemap_ops.c

@@ -24,6 +24,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/editors/object/object_facemap_ops.c
+ *  \ingroup edobj
+ */
+
 #include <string.h>
 
 #include "MEM_guardedalloc.h"

source/blender/gpu/GPU_batch_presets.h

@@ -24,7 +24,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
-/* Batched geometry rendering is powered by the GPU library.
+/** \file blender/gpu/GPU_batch_presets.h
+ *  \ingroup gpu
+ *
+ * Batched geometry rendering is powered by the GPU library.
  * This file contains any additions or modifications specific to Blender.
  */
 

source/blender/gpu/GPU_batch_utils.h

@@ -18,6 +18,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/gpu/GPU_batch_utils.h
+ *  \ingroup gpu
+ */
+
 #ifndef __GPU_BATCH_UTILS_H__
 #define __GPU_BATCH_UTILS_H__
 

source/blender/gpu/intern/gpu_shader.c

@@ -25,6 +25,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/gpu/intern/gpu_shader.c
+ *  \ingroup gpu
+ */
+
 #include "MEM_guardedalloc.h"
 
 #include "BLI_utildefines.h"

source/blender/makesrna/intern/rna_cachefile.c

@@ -23,6 +23,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/makesrna/intern/rna_cachefile.c
+ *  \ingroup RNA
+ */
+
 #include "DNA_cachefile_types.h"
 #include "DNA_scene_types.h"