From 8c8ae3dedf0da0c3ea8e15b37a1f57a856d89206 Mon Sep 17 00:00:00 2001
From: Nathan Letwory <nathan@letworyinteractive.com>
Date: Mon, 21 Feb 2011 06:58:46 +0000
Subject: [PATCH] doxygen: entry for gpu, modifiers, nodes, python and render

---
 doc/Doxyfile                                  |  6 ++-
 doc/doxygen.main                              | 39 +++++++------------
 source/blender/gpu/GPU_buffers.h              |  6 ++-
 source/blender/gpu/GPU_draw.h                 |  6 ++-
 source/blender/gpu/GPU_extensions.h           |  6 ++-
 source/blender/gpu/GPU_material.h             |  6 ++-
 source/blender/modifiers/MOD_modifiertypes.h  |  6 ++-
 source/blender/nodes/CMP_node.h               |  6 ++-
 source/blender/nodes/SHD_node.h               |  6 ++-
 source/blender/nodes/TEX_node.h               |  6 ++-
 source/blender/python/BPY_extern.h            |  6 +++
 source/blender/python/generic/blf_py_api.h    |  2 +-
 .../render/extern/include/RE_pipeline.h       |  6 ++-
 .../render/extern/include/RE_render_ext.h     |  6 ++-
 .../render/extern/include/RE_shader_ext.h     |  6 ++-
 15 files changed, 81 insertions(+), 38 deletions(-)

diff --git a/doc/Doxyfile b/doc/Doxyfile
index 8bf8de71edc..83b5188ff41 100644
--- a/doc/Doxyfile
+++ b/doc/Doxyfile
@@ -626,7 +626,11 @@ INPUT                  = doxygen.main \
                          ../source/blender/blenloader \
                          ../source/blender/readblenfile \
                          ../source/blender/blenkernel \
-                         ../source/blender/blenlib
+                         ../source/blender/blenlib \
+                         ../source/blender/render \
+                         ../source/blender/nodes \
+                         ../source/blender/modifiers \
+                         ../source/blender/gpu
 
 # This tag can be used to specify the character encoding of the source files 
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is 
diff --git a/doc/doxygen.main b/doc/doxygen.main
index 201596c0e7a..e8927c8ffc1 100644
--- a/doc/doxygen.main
+++ b/doc/doxygen.main
@@ -8,31 +8,6 @@
  *
  * For more information on using Blender browse to http://www.blender.org
  *
- * \section sects Main sections of the blender code
- *
- *  The following sections are the broad categories into which the various modules
- *  belong.
- *
- *  - \ref render
- *  - \ref meshedit
- *  - \ref texture
- *  - \ref compositor
- *  - \ref scripts
- *  - \ref gameengine
- *  - \ref data
- *
- * \section GUI
- *  - \ref gui
- *
- * \section libraries Libraries and Wrappers
- *  - \ref GHOST
- *  - \ref imbuf
- *  - \ref audaspace
- *  - \ref DNA
- *  - \ref RNA
- *
- * \section Miscellaneous
- *  - \ref undoc
  */
 
 /** \defgroup intern Internal libraries
@@ -65,6 +40,10 @@
 
 /** \defgroup scripts Scripting */
 
+/** \defgroup python Python
+ *  \ingroup scripts
+ */
+
 /** \defgroup gameengine Game Engine */
 
 /** \defgroup audaspace Audaspace
@@ -82,10 +61,20 @@
  *  \ingroup core
  */
 
+/** \defgroup nodes nodes
+ *  \ingroup core
+ */
+
+/** \defgroup modifiers modifiers
+ *  \ingroup core
+ */
+
 /** \defgroup data DNA, RNA and .blend access*/
 
 /** \defgroup GHOST GHOST API */
 
+/** \defgroup gpu GPU */
+
 /** \defgroup DNA sDNA
  *  \ingroup data
  */
diff --git a/source/blender/gpu/GPU_buffers.h b/source/blender/gpu/GPU_buffers.h
index 4c6e24cde62..7ce166d92bd 100644
--- a/source/blender/gpu/GPU_buffers.h
+++ b/source/blender/gpu/GPU_buffers.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -30,6 +30,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file GPU_buffers.h
+ *  \ingroup gpu
+ */
+
 #ifndef __GPU_BUFFERS_H__
 #define __GPU_BUFFERS_H__
 
diff --git a/source/blender/gpu/GPU_draw.h b/source/blender/gpu/GPU_draw.h
index 1f1bbab9abf..18a6f1ba73d 100644
--- a/source/blender/gpu/GPU_draw.h
+++ b/source/blender/gpu/GPU_draw.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -30,6 +30,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file GPU_draw.h
+ *  \ingroup gpu
+ */
+
 #ifndef GPU_GAME_H
 #define GPU_GAME_H
 
diff --git a/source/blender/gpu/GPU_extensions.h b/source/blender/gpu/GPU_extensions.h
index 4256d494302..90c99257087 100644
--- a/source/blender/gpu/GPU_extensions.h
+++ b/source/blender/gpu/GPU_extensions.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -30,6 +30,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file GPU_extensions.h
+ *  \ingroup gpu
+ */
+
 #ifndef GPU_EXTENSIONS_H
 #define GPU_EXTENSIONS_H
 
diff --git a/source/blender/gpu/GPU_material.h b/source/blender/gpu/GPU_material.h
index bfc74683c9d..f563d8cbe92 100644
--- a/source/blender/gpu/GPU_material.h
+++ b/source/blender/gpu/GPU_material.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -30,6 +30,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file GPU_material.h
+ *  \ingroup gpu
+ */
+
 #ifndef __GPU_MATERIAL__
 #define __GPU_MATERIAL__
 
diff --git a/source/blender/modifiers/MOD_modifiertypes.h b/source/blender/modifiers/MOD_modifiertypes.h
index 6063acf47f4..8486e2b5d29 100644
--- a/source/blender/modifiers/MOD_modifiertypes.h
+++ b/source/blender/modifiers/MOD_modifiertypes.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -25,6 +25,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file MOD_modifiertypes.h
+ *  \ingroup modifiers
+ */
+
 #ifndef MOD_MODIFIERTYPES_H
 #define MOD_MODIFIERTYPES_H
 
diff --git a/source/blender/nodes/CMP_node.h b/source/blender/nodes/CMP_node.h
index 4cbb5599797..65c9236710f 100644
--- a/source/blender/nodes/CMP_node.h
+++ b/source/blender/nodes/CMP_node.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -30,6 +30,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file CMP_node.h
+ *  \ingroup nodes
+ */
+
 #ifndef CMP_NODE_H
 #define CMP_NODE_H
 
diff --git a/source/blender/nodes/SHD_node.h b/source/blender/nodes/SHD_node.h
index 20a7aa083ec..80e5eec6893 100644
--- a/source/blender/nodes/SHD_node.h
+++ b/source/blender/nodes/SHD_node.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -30,6 +30,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file SHD_node.h
+ *  \ingroup nodes
+ */
+
 #ifndef SHD_NODE_H
 #define SHD_NODE_H
 
diff --git a/source/blender/nodes/TEX_node.h b/source/blender/nodes/TEX_node.h
index b741c654b15..23a6b4427af 100644
--- a/source/blender/nodes/TEX_node.h
+++ b/source/blender/nodes/TEX_node.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -30,6 +30,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file TEX_node.h
+ *  \ingroup nodes
+ */
+
 #ifndef TEX_NODE_H
 #define TEX_NODE_H
 
diff --git a/source/blender/python/BPY_extern.h b/source/blender/python/BPY_extern.h
index e559f0bf57b..2abe6044ca3 100644
--- a/source/blender/python/BPY_extern.h
+++ b/source/blender/python/BPY_extern.h
@@ -27,6 +27,12 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file BPY_extern.h
+ *  \ingroup python
+ */
+
+
+
 #ifndef BPY_EXTERN_H
 #define BPY_EXTERN_H
 
diff --git a/source/blender/python/generic/blf_py_api.h b/source/blender/python/generic/blf_py_api.h
index db17f62337b..316bad3a4c9 100644
--- a/source/blender/python/generic/blf_py_api.h
+++ b/source/blender/python/generic/blf_py_api.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
diff --git a/source/blender/render/extern/include/RE_pipeline.h b/source/blender/render/extern/include/RE_pipeline.h
index fa71101cbe8..b64538cb452 100644
--- a/source/blender/render/extern/include/RE_pipeline.h
+++ b/source/blender/render/extern/include/RE_pipeline.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -27,6 +27,10 @@
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file RE_pipeline.h
+ *  \ingroup render
+ */
+
 #ifndef RE_PIPELINE_H
 #define RE_PIPELINE_H
 
diff --git a/source/blender/render/extern/include/RE_render_ext.h b/source/blender/render/extern/include/RE_render_ext.h
index b04f7247e2a..849640a5c16 100644
--- a/source/blender/render/extern/include/RE_render_ext.h
+++ b/source/blender/render/extern/include/RE_render_ext.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -26,6 +26,10 @@
  *
  * ***** END GPL/BL DUAL LICENSE BLOCK *****
  */
+/** \file RE_render_ext.h
+ *  \ingroup render
+ */
+
 
 #ifndef RE_RENDER_EXT_H
 #define RE_RENDER_EXT_H
diff --git a/source/blender/render/extern/include/RE_shader_ext.h b/source/blender/render/extern/include/RE_shader_ext.h
index 7825d2e4647..ca04990efad 100644
--- a/source/blender/render/extern/include/RE_shader_ext.h
+++ b/source/blender/render/extern/include/RE_shader_ext.h
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -26,6 +26,10 @@
  *
  * ***** END GPL/BL DUAL LICENSE BLOCK *****
  */
+/** \file RE_shader_ext.h
+ *  \ingroup render
+ */
+
 
 #ifndef RE_SHADER_EXT_H
 #define RE_SHADER_EXT_H
-- 
GitLab