[Bf-blender-cvs] SVN commit: /data/svn/bf-blender [35078] trunk/blender: doxygen: add bullet to extern libs, some small changes in page names, and fixes around license blocks

Nathan Letwory nathan at letworyinteractive.com
Tue Feb 22 17:12:13 CET 2011 

Revision: 35078
          http://projects.blender.org/scm/viewvc.php?view=rev&root=bf-blender&revision=35078
Author:   jesterking
Date:     2011-02-22 16:12:12 +0000 (Tue, 22 Feb 2011)
Log Message:
-----------
doxygen: add bullet to extern libs, some small changes in page names, and fixes around license blocks

Modified Paths:
--------------
    trunk/blender/doc/Doxyfile
    trunk/blender/doc/doxygen.main
    trunk/blender/extern/bullet2/src/BulletCollision/CollisionDispatch/btCollisionWorld.h
    trunk/blender/intern/ghost/GHOST_ISystem.h
    trunk/blender/intern/guardedalloc/MEM_guardedalloc.h
    trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_GLExtensionManager.cpp
    trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_GLExtensionManager.h
    trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_OpenGLRasterizer.cpp
    trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_VAOpenGLRasterizer.cpp

Modified: trunk/blender/doc/Doxyfile
===================================================================
--- trunk/blender/doc/Doxyfile	2011-02-22 14:27:46 UTC (rev 35077)
+++ trunk/blender/doc/Doxyfile	2011-02-22 16:12:12 UTC (rev 35078)
@@ -640,7 +640,8 @@
                          ../source/gameengine/Ketsji \
                          ../source/gameengine/Rasterizer \
                          ../source/gameengine/Network \
-                         ../source/gameengine/Physics
+                         ../source/gameengine/Physics \
+                         ../extern/bullet2
 
 # 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 

Modified: trunk/blender/doc/doxygen.main
===================================================================
--- trunk/blender/doc/doxygen.main	2011-02-22 14:27:46 UTC (rev 35077)
+++ trunk/blender/doc/doxygen.main	2011-02-22 16:12:12 UTC (rev 35078)
@@ -6,7 +6,11 @@
  *
  * These pages document the source code of blender.
  *
+ * \subsection implinks Important Links
+ * - <a href="http://projects.blender.org">projects.blender.org</a> with <a href="http://projects.blender.org/tracker/index.php?group_id=9&atid=498">bug tracker</a>
+ * - <a href="http://wiki.blender.org/index.php/Dev:Contents">Development documents</a> on our wiki.
  *
+ * \subsection blother Other
  * For more information on using Blender browse to http://www.blender.org
  *
  */
@@ -35,6 +39,11 @@
  *  folder are updated.
  *
  */
+
+/** \defgroup bullet Bullet Physics Library
+ *  \ingroup extern
+ */
+
 /** \defgroup blenderplayer Blender Player */
 
 /** \defgroup render Rendering */
@@ -121,7 +130,10 @@
 
 /** \defgroup data DNA, RNA and .blend access*/
 
-/** \defgroup GHOST GHOST API */
+/** \defgroup GHOST GHOST API
+ * \ingroup intern GUI
+ * \ref GHOSTPage
+ */
 
 /** \defgroup gpu GPU */
 

Modified: trunk/blender/extern/bullet2/src/BulletCollision/CollisionDispatch/btCollisionWorld.h
===================================================================
--- trunk/blender/extern/bullet2/src/BulletCollision/CollisionDispatch/btCollisionWorld.h	2011-02-22 14:27:46 UTC (rev 35077)
+++ trunk/blender/extern/bullet2/src/BulletCollision/CollisionDispatch/btCollisionWorld.h	2011-02-22 16:12:12 UTC (rev 35078)
@@ -1,5 +1,5 @@
 /*
-Bullet Continuous Collision Detection and Physics Library
+Bullet Continuous Collision Detection and Physics %Library
 Copyright (c) 2003-2006 Erwin Coumans  http://bulletphysics.com/Bullet/
 
 This software is provided 'as-is', without any express or implied warranty.
@@ -15,12 +15,15 @@
 
 
 /**
- * @mainpage Bullet Documentation
+ * \file btCollisionWorld.h
+ * \ingroup bullet
  *
+ * @page bulletdoc Bullet Documentation
+ *
  * @section intro_sec Introduction
  * Bullet Collision Detection & Physics SDK
  *
- * Bullet is a Collision Detection and Rigid Body Dynamics Library. The Library is Open Source and free for commercial use, under the ZLib license ( http://opensource.org/licenses/zlib-license.php ).
+ * Bullet is a Collision Detection and Rigid Body Dynamics %Library. The %Library is Open Source and free for commercial use, under the ZLib license ( http://opensource.org/licenses/zlib-license.php ).
  *
  * There is the Physics Forum for feedback and general Collision Detection and Physics discussions.
  * Please visit http://www.bulletphysics.com
@@ -28,7 +31,7 @@
  * @section install_sec Installation
  *
  * @subsection step1 Step 1: Download
- * You can download the Bullet Physics Library from the Google Code repository: http://code.google.com/p/bullet/downloads/list
+ * You can download the Bullet Physics %Library from the Google Code repository: http://code.google.com/p/bullet/downloads/list
  * @subsection step2 Step 2: Building
  * Bullet comes with autogenerated Project Files for Microsoft Visual Studio 6, 7, 7.1 and 8.
  * The main Workspace/Solution is located in Bullet/msvc/8/wksbullet.sln (replace 8 with your version).
@@ -40,13 +43,13 @@
  * 
  * @subsection step3 Step 3: Testing demos
  * Try to run and experiment with BasicDemo executable as a starting point.
- * Bullet can be used in several ways, as Full Rigid Body simulation, as Collision Detector Library or Low Level / Snippets like the GJK Closest Point calculation.
+ * Bullet can be used in several ways, as Full Rigid Body simulation, as Collision Detector %Library or Low Level / Snippets like the GJK Closest Point calculation.
  * The Dependencies can be seen in this documentation under Directories
  * 
  * @subsection step4 Step 4: Integrating in your application, full Rigid Body and Soft Body simulation
  * Check out BasicDemo how to create a btDynamicsWorld, btRigidBody and btCollisionShape, Stepping the simulation and synchronizing your graphics object transform.
  * Check out SoftDemo how to use soft body dynamics, using btSoftRigidDynamicsWorld.
- * @subsection step5 Step 5 : Integrate the Collision Detection Library (without Dynamics and other Extras)
+ * @subsection step5 Step 5 : Integrate the Collision Detection %Library (without Dynamics and other Extras)
  * Bullet Collision Detection can also be used without the Dynamics/Extras.
  * Check out btCollisionWorld and btCollisionObject, and the CollisionInterfaceDemo.
  * @subsection step6 Step 6 : Use Snippets like the GJK Closest Point calculation.

Modified: trunk/blender/intern/ghost/GHOST_ISystem.h
===================================================================
--- trunk/blender/intern/ghost/GHOST_ISystem.h	2011-02-22 14:27:46 UTC (rev 35077)
+++ trunk/blender/intern/ghost/GHOST_ISystem.h	2011-02-22 16:12:12 UTC (rev 35078)
@@ -43,7 +43,7 @@
 class GHOST_IEventConsumer;
 
 /**
- * \page GHOST GHOST
+ * \page GHOSTPage GHOST
  *
  * \section intro Introduction
  *

Modified: trunk/blender/intern/guardedalloc/MEM_guardedalloc.h
===================================================================
--- trunk/blender/intern/guardedalloc/MEM_guardedalloc.h	2011-02-22 14:27:46 UTC (rev 35077)
+++ trunk/blender/intern/guardedalloc/MEM_guardedalloc.h	2011-02-22 16:12:12 UTC (rev 35078)
@@ -30,26 +30,32 @@
  *  \ingroup MEM
  *
  *  \author Copyright (C) 2001 NaN Technologies B.V.
- *  \brief Guarded memory (de)allocation
+ *  \brief Read \ref MEMPage
+ */
+
+/** 
+ * \page MEMPage Guarded memory(de)allocation
  *
- *
  * \section aboutmem c-style guarded memory allocation
  *
- * \subsection about About the MEM module
+ * \subsection memabout About the MEM module
  *
  * MEM provides guarded malloc/calloc calls. All memory is enclosed by
  * pads, to detect out-of-bound writes. All blocks are placed in a
  * linked list, so they remain reachable at all times. There is no
  * back-up in case the linked-list related data is lost.
  *
- * \subsection issues Known issues with MEM
+ * \subsection memissues Known issues with MEM
  *
  * There are currently no known issues with MEM. Note that there is a
  * second intern/ module with MEM_ prefix, for use in c++.
  * 
- * \subsection dependencies Dependencies
+ * \subsection memdependencies Dependencies
  * - stdlib
  * - stdio
+ * 
+ * \subsection memdocs API Documentation
+ * See \ref MEM_guardedalloc.h
  */
 
 #ifndef MEM_MALLOCN_H

Modified: trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_GLExtensionManager.cpp
===================================================================
--- trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_GLExtensionManager.cpp	2011-02-22 14:27:46 UTC (rev 35077)
+++ trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_GLExtensionManager.cpp	2011-02-22 16:12:12 UTC (rev 35078)
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  * ***** BEGIN GPL LICENSE BLOCK *****
  *

Modified: trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_GLExtensionManager.h
===================================================================
--- trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_GLExtensionManager.h	2011-02-22 14:27:46 UTC (rev 35077)
+++ trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_GLExtensionManager.h	2011-02-22 16:12:12 UTC (rev 35078)
@@ -35,7 +35,7 @@
 
 #include "GL/glew.h"
 
-/* Note: this used to have a lot more code, but now extension handling
+/** Note: this used to have a lot more code, but now extension handling
  * is done by GLEW, so it does mostly debug stuff */
 
 namespace bgl

Modified: trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_OpenGLRasterizer.cpp
===================================================================
--- trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_OpenGLRasterizer.cpp	2011-02-22 14:27:46 UTC (rev 35077)
+++ trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_OpenGLRasterizer.cpp	2011-02-22 16:12:12 UTC (rev 35078)
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  * ***** BEGIN GPL LICENSE BLOCK *****
  *

Modified: trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_VAOpenGLRasterizer.cpp
===================================================================
--- trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_VAOpenGLRasterizer.cpp	2011-02-22 14:27:46 UTC (rev 35077)
+++ trunk/blender/source/gameengine/Rasterizer/RAS_OpenGLRasterizer/RAS_VAOpenGLRasterizer.cpp	2011-02-22 16:12:12 UTC (rev 35078)
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  * ***** BEGIN GPL LICENSE BLOCK *****
  *

More information about the Bf-blender-cvs mailing list