From 9e6e34df6cc5aa9b514d32b42c0732b91f293008 Mon Sep 17 00:00:00 2001
From: Nathan Letwory <nathan@letworyinteractive.com>
Date: Thu, 17 Feb 2011 23:34:07 +0000
Subject: [PATCH] Bring blenloader module under data group. Rename the group to
 look a bit more sensible in the output.

---
 doc/Doxyfile                              | 3 ++-
 doc/doxygen.main                          | 6 +++++-
 source/blender/blenloader/BLO_readfile.h  | 6 +++++-
 source/blender/blenloader/BLO_soundfile.h | 4 ++++
 source/blender/blenloader/BLO_sys_types.h | 5 +++++
 source/blender/blenloader/BLO_undofile.h  | 4 ++++
 source/blender/blenloader/BLO_writefile.h | 6 +++++-
 7 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/doc/Doxyfile b/doc/Doxyfile
index 7cf8401b5b2..d8c18a8ff63 100644
--- a/doc/Doxyfile
+++ b/doc/Doxyfile
@@ -622,7 +622,8 @@ INPUT                  = doxygen.main \
                          ../source/blender/windowmanager \
                          ../source/blender/makesdna \
                          ../source/blender/makesrna \
-                         ../intern/ghost
+                         ../intern/ghost \
+                         ../source/blender/blenloader
 
 # 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 a34eb9d888d..c5a3ee3dd28 100644
--- a/doc/doxygen.main
+++ b/doc/doxygen.main
@@ -72,7 +72,7 @@
  *  \todo add to doxygen
  */
 
-/** \defgroup data DNA and RNA */
+/** \defgroup data DNA, RNA and .blend access*/
 
 /** \defgroup GHOST GHOST API */
 
@@ -83,6 +83,10 @@
  *  \ingroup data
  */
 
+/** \defgroup readwrite .blend read and write functions
+ *  \ingroup data
+ */
+
 /** \defgroup gui GUI */
 
 /** \defgroup wm windowmanager
diff --git a/source/blender/blenloader/BLO_readfile.h b/source/blender/blenloader/BLO_readfile.h
index 94983791289..024bff98c0f 100644
--- a/source/blender/blenloader/BLO_readfile.h
+++ b/source/blender/blenloader/BLO_readfile.h
@@ -25,11 +25,15 @@
  * Contributor(s): none yet.
  *
  * ***** END GPL LICENSE BLOCK *****
- * external readfile function prototypes
  */
 #ifndef BLO_READFILE_H
 #define BLO_READFILE_H
 
+/** \file BLO_readfile.h
+ *  \ingroup readwrite
+ *  \brief external readfile function prototypes.
+ */
+
 #ifdef __cplusplus
 extern "C" {
 #endif
diff --git a/source/blender/blenloader/BLO_soundfile.h b/source/blender/blenloader/BLO_soundfile.h
index aa37a053e18..60b05535cad 100644
--- a/source/blender/blenloader/BLO_soundfile.h
+++ b/source/blender/blenloader/BLO_soundfile.h
@@ -29,6 +29,10 @@
 #ifndef BLO_SOUNDFILE_H
 #define BLO_SOUNDFILE_H
 
+/** \file BLO_soundfile.h
+ *  \ingroup readwrite
+ */
+
 #include "DNA_sound_types.h"
 #include "DNA_packedFile_types.h"
 
diff --git a/source/blender/blenloader/BLO_sys_types.h b/source/blender/blenloader/BLO_sys_types.h
index e29beb48efb..956ed513852 100644
--- a/source/blender/blenloader/BLO_sys_types.h
+++ b/source/blender/blenloader/BLO_sys_types.h
@@ -25,6 +25,11 @@
  * Contributor(s): none yet.
  *
  * ***** END GPL LICENSE BLOCK *****
+ */
+
+/** \file BLO_sys_types.h
+ *  \ingroup readwrite
+ *
  * A platform-independent definition of [u]intXX_t
  * Plus the accompanying header include for htonl/ntohl
  *
diff --git a/source/blender/blenloader/BLO_undofile.h b/source/blender/blenloader/BLO_undofile.h
index 9ec03c4e4d4..c7f0f7f0d1f 100644
--- a/source/blender/blenloader/BLO_undofile.h
+++ b/source/blender/blenloader/BLO_undofile.h
@@ -31,6 +31,10 @@
 #ifndef BLO_UNDOFILE_H
 #define BLO_UNDOFILE_H
 
+/** \file BLO_undofile.h
+ *  \ingroup readwrite
+ */
+
 typedef struct {
 	void *next, *prev;
 	
diff --git a/source/blender/blenloader/BLO_writefile.h b/source/blender/blenloader/BLO_writefile.h
index 127607232e1..7fdc136980e 100644
--- a/source/blender/blenloader/BLO_writefile.h
+++ b/source/blender/blenloader/BLO_writefile.h
@@ -25,12 +25,16 @@
  * Contributor(s): none yet.
  *
  * ***** END GPL LICENSE BLOCK *****
- * external writefile function prototypes
  */
 
 #ifndef BLO_WRITEFILE_H
 #define BLO_WRITEFILE_H
 
+/** \file BLO_writefile.h
+ *  \ingroup readwrite
+ *  \brief external writefile function prototypes.
+ */
+
 struct MemFile;
 struct Main;
 struct ReportList;
-- 
GitLab