From 89186595de97d8faeb4a97784c952904f5fb5472 Mon Sep 17 00:00:00 2001
From: Campbell Barton <ideasman42@gmail.com>
Date: Thu, 30 Aug 2018 01:56:08 +1000
Subject: Cleanup: add file doxy comments

---
 source/blender/blenkernel/BKE_mesh_tangent.h             | 4 ++++
 source/blender/blenkernel/intern/armature.c              | 1 -
 source/blender/blenkernel/intern/armature_update.c       | 4 ++++
 source/blender/blenkernel/intern/subdiv_converter.c      | 4 ++++
 source/blender/blenkernel/intern/subdiv_converter.h      | 4 ++++
 source/blender/blenkernel/intern/subdiv_converter_mesh.c | 4 ++++
 source/blender/blenlib/BLI_polyfill_2d.h                 | 4 ++++
 source/blender/blenlib/BLI_polyfill_2d_beautify.h        | 4 ++++
 source/blender/collada/AnimationExporter.cpp             | 4 ++++
 source/blender/collada/AnimationExporter.h               | 4 ++++
 source/blender/editors/io/io_alembic.c                   | 4 ++++
 source/blender/editors/io/io_cache.c                     | 4 ++++
 source/blender/editors/object/object_facemap_ops.c       | 4 ++++
 source/blender/gpu/GPU_batch_presets.h                   | 5 ++++-
 source/blender/gpu/GPU_batch_utils.h                     | 4 ++++
 source/blender/gpu/intern/gpu_shader.c                   | 4 ++++
 source/blender/makesrna/intern/rna_cachefile.c           | 4 ++++
 17 files changed, 64 insertions(+), 2 deletions(-)

(limited to 'source/blender')

diff --git a/source/blender/blenkernel/BKE_mesh_tangent.h b/source/blender/blenkernel/BKE_mesh_tangent.h
index 6d359a0653c..09575f39e98 100644
--- a/source/blender/blenkernel/BKE_mesh_tangent.h
+++ b/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,
diff --git a/source/blender/blenkernel/intern/armature.c b/source/blender/blenkernel/intern/armature.c
index 9174038dfbb..7383d80cfa8 100644
--- a/source/blender/blenkernel/intern/armature.c
+++ b/source/blender/blenkernel/intern/armature.c
@@ -27,7 +27,6 @@
  *  \ingroup bke
  */
 
-
 #include <ctype.h>
 #include <stdlib.h>
 #include <math.h>
diff --git a/source/blender/blenkernel/intern/armature_update.c b/source/blender/blenkernel/intern/armature_update.c
index d53c61255fe..92777444cfe 100644
--- a/source/blender/blenkernel/intern/armature_update.c
+++ b/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"
diff --git a/source/blender/blenkernel/intern/subdiv_converter.c b/source/blender/blenkernel/intern/subdiv_converter.c
index 5cad2f3e4cd..47e87bfdd78 100644
--- a/source/blender/blenkernel/intern/subdiv_converter.c
+++ b/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"
diff --git a/source/blender/blenkernel/intern/subdiv_converter.h b/source/blender/blenkernel/intern/subdiv_converter.h
index 4c552a9164e..0326c9e504c 100644
--- a/source/blender/blenkernel/intern/subdiv_converter.h
+++ b/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
diff --git a/source/blender/blenkernel/intern/subdiv_converter_mesh.c b/source/blender/blenkernel/intern/subdiv_converter_mesh.c
index 32e829a9439..d17ee49ca0c 100644
--- a/source/blender/blenkernel/intern/subdiv_converter_mesh.c
+++ b/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>
diff --git a/source/blender/blenlib/BLI_polyfill_2d.h b/source/blender/blenlib/BLI_polyfill_2d.h
index 099f08d4663..0ede111fc42 100644
--- a/source/blender/blenlib/BLI_polyfill_2d.h
+++ b/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(
diff --git a/source/blender/blenlib/BLI_polyfill_2d_beautify.h b/source/blender/blenlib/BLI_polyfill_2d_beautify.h
index 73b52125904..96b730bee68 100644
--- a/source/blender/blenlib/BLI_polyfill_2d_beautify.h
+++ b/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;
 
diff --git a/source/blender/collada/AnimationExporter.cpp b/source/blender/collada/AnimationExporter.cpp
index ab53e282476..31d0dde567b 100644
--- a/source/blender/collada/AnimationExporter.cpp
+++ b/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"
diff --git a/source/blender/collada/AnimationExporter.h b/source/blender/collada/AnimationExporter.h
index 04cd78af830..f5e96dbd813 100644
--- a/source/blender/collada/AnimationExporter.h
+++ b/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>
diff --git a/source/blender/editors/io/io_alembic.c b/source/blender/editors/io/io_alembic.c
index 91fc1e9fe6a..8e446c73eab 100644
--- a/source/blender/editors/io/io_alembic.c
+++ b/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 */
diff --git a/source/blender/editors/io/io_cache.c b/source/blender/editors/io/io_cache.c
index 221142a6cf8..953dc24f6a5 100644
--- a/source/blender/editors/io/io_cache.c
+++ b/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"
diff --git a/source/blender/editors/object/object_facemap_ops.c b/source/blender/editors/object/object_facemap_ops.c
index a561556bba0..25fe52ba279 100644
--- a/source/blender/editors/object/object_facemap_ops.c
+++ b/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"
diff --git a/source/blender/gpu/GPU_batch_presets.h b/source/blender/gpu/GPU_batch_presets.h
index a33b864c5b9..6b010396a9b 100644
--- a/source/blender/gpu/GPU_batch_presets.h
+++ b/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.
  */
 
diff --git a/source/blender/gpu/GPU_batch_utils.h b/source/blender/gpu/GPU_batch_utils.h
index d558b7a1097..05bbb6542ff 100644
--- a/source/blender/gpu/GPU_batch_utils.h
+++ b/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__
 
diff --git a/source/blender/gpu/intern/gpu_shader.c b/source/blender/gpu/intern/gpu_shader.c
index daea96df008..1bfa0788f00 100644
--- a/source/blender/gpu/intern/gpu_shader.c
+++ b/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"
diff --git a/source/blender/makesrna/intern/rna_cachefile.c b/source/blender/makesrna/intern/rna_cachefile.c
index c0aa1f2a9f4..dd76e2409db 100644
--- a/source/blender/makesrna/intern/rna_cachefile.c
+++ b/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"
 
-- 
cgit v1.2.3