[Bf-blender-cvs] [89186595de9] blender2.8: Cleanup: add file doxy comments
Campbell Barton
noreply at git.blender.org
Wed Aug 29 17:49:05 CEST 2018
Commit: 89186595de97d8faeb4a97784c952904f5fb5472
Author: Campbell Barton
Date: Thu Aug 30 01:56:08 2018 +1000
Branches: blender2.8
https://developer.blender.org/rB89186595de97d8faeb4a97784c952904f5fb5472
Cleanup: add file doxy comments
===================================================================
M source/blender/blenkernel/BKE_mesh_tangent.h
M source/blender/blenkernel/intern/armature.c
M source/blender/blenkernel/intern/armature_update.c
M source/blender/blenkernel/intern/subdiv_converter.c
M source/blender/blenkernel/intern/subdiv_converter.h
M source/blender/blenkernel/intern/subdiv_converter_mesh.c
M source/blender/blenlib/BLI_polyfill_2d.h
M source/blender/blenlib/BLI_polyfill_2d_beautify.h
M source/blender/collada/AnimationExporter.cpp
M source/blender/collada/AnimationExporter.h
M source/blender/editors/io/io_alembic.c
M source/blender/editors/io/io_cache.c
M source/blender/editors/object/object_facemap_ops.c
M source/blender/gpu/GPU_batch_presets.h
M source/blender/gpu/GPU_batch_utils.h
M source/blender/gpu/intern/gpu_shader.c
M source/blender/makesrna/intern/rna_cachefile.c
===================================================================
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"
More information about the Bf-blender-cvs
mailing list