added some comments, to clarify unit-test/brute force implementations.

Demos/BasicDemo/BasicDemo.cpp

@@ -199,7 +199,7 @@ void	BasicDemo::initPhysics()
 	localCreateRigidBody(btScalar(0.),groundTransform,groundShape);
 
 	//create a few dynamic sphere rigidbodies (re-using the same sphere shape)
-	//btCollisionShape* sphereShape = new btBoxShape(btVector3(1,1,1));
+	//btCollisionShape* colShape = new btBoxShape(btVector3(1,1,1));
 	btCollisionShape* colShape = new btSphereShape(btScalar(1.));
 	m_collisionShapes.push_back(colShape);
 

Demos/ConvexDecompositionDemo/ConvexDecompositionDemo.cpp

@@ -275,7 +275,7 @@ void ConvexDecompositionDemo::initPhysics(const char* filename)
 
 	};
 
-	if (0)//tcount)
+	if (tcount)
 	{
 		btTriangleMesh* trimesh = new btTriangleMesh();
 

Demos/RagdollDemo/RagdollDemo.cpp

@@ -333,14 +333,17 @@ void RagdollDemo::initPhysics()
 	}
 
 	// Spawn one ragdoll
-	spawnRagdoll();
+	btVector3 startOffset(1,0.5,0);
+	spawnRagdoll(startOffset);
+	startOffset.setValue(-1,0.5,0);
+	spawnRagdoll(startOffset);
 
 	clientResetScene();		
 }
 
-void RagdollDemo::spawnRagdoll(bool random)
+void RagdollDemo::spawnRagdoll(const btVector3& startOffset)
 {
-	RagDoll* ragDoll = new RagDoll (m_dynamicsWorld, btVector3 (0,1,0));
+	RagDoll* ragDoll = new RagDoll (m_dynamicsWorld, startOffset);
 	m_ragdolls.push_back(ragDoll);
 }	
 
@@ -383,8 +386,11 @@ void RagdollDemo::keyboardCallback(unsigned char key, int x, int y)
 	switch (key)
 	{
 	case 'e':
-		spawnRagdoll(true);
+		{
+		btVector3 startOffset(0,2,0);
+		spawnRagdoll(startOffset);
 		break;
+		}
 	default:
 		DemoApplication::keyboardCallback(key, x, y);
 	}

Demos/RagdollDemo/RagdollDemo.h

@@ -55,7 +55,7 @@ public:
 		exitPhysics();
 	}
 
-	void spawnRagdoll(bool random = false);
+	void spawnRagdoll(const btVector3& startOffset);
 
 	virtual void clientMoveAndDisplay();
 

src/BulletCollision/BroadphaseCollision/btSimpleBroadphase.h

@@ -49,6 +49,8 @@ struct btSimpleBroadphaseProxy : public btBroadphaseProxy
 };
 
 ///SimpleBroadphase is a brute force aabb culling broadphase based on O(n^2) aabb checks
+///btSimpleBroadphase is just a unit-test implementation to verify and test other broadphases.
+///So please don't use this class, but use bt32BitAxisSweep3 or btAxisSweep3 instead!
 class btSimpleBroadphase : public btBroadphaseInterface
 {
 

src/BulletCollision/CollisionShapes/btOptimizedBvh.cpp

@@ -597,7 +597,6 @@ void	btOptimizedBvh::reportAabbOverlappingNodex(btNodeOverlapCallback* nodeCallb
 {
 	//either choose recursive traversal (walkTree) or stackless (walkStacklessTree)
 
-
 	if (m_useQuantization)
 	{
 		///quantize query AABB

src/BulletCollision/CollisionShapes/btTriangleMeshShape.cpp

@@ -137,7 +137,7 @@ const btVector3& btTriangleMeshShape::getLocalScaling() const
 //#define DEBUG_TRIANGLE_MESH
 
 
-/*
+
 void	btTriangleMeshShape::processAllTriangles(btTriangleCallback* callback,const btVector3& aabbMin,const btVector3& aabbMax) const
 {
 		struct FilteredCallback : public btInternalTriangleIndexCallback
@@ -171,8 +171,6 @@ void	btTriangleMeshShape::processAllTriangles(btTriangleCallback* callback,const
 }
 
 
-*/
-
 
 
 

src/BulletCollision/CollisionShapes/btTriangleMeshShape.h

@@ -28,9 +28,11 @@ protected:
 	btVector3	m_localAabbMax;
 	btStridingMeshInterface* m_meshInterface;
 
+	///btTriangleMeshShape constructor has been disabled/protected, so that users will not mistakenly use this class.
+	///Don't use btTriangleMeshShape but use btBvhTriangleMeshShape instead!
+	btTriangleMeshShape(btStridingMeshInterface* meshInterface);
 
 public:
-	btTriangleMeshShape(btStridingMeshInterface* meshInterface);
 
 	virtual ~btTriangleMeshShape();
 
@@ -51,12 +53,7 @@ public:
 
 	virtual void getAabb(const btTransform& t,btVector3& aabbMin,btVector3& aabbMax) const;
 
-//this is a brute force processAllTriangles implementation to compare/unit test the btBvhTriangleMeshShape.
-//it has been disabled, so that users will not mistakenly use this class.
-//Don't use btTriangleMeshShape but use btBvhTriangleMeshShape instead!
-/*
 	virtual void	processAllTriangles(btTriangleCallback* callback,const btVector3& aabbMin,const btVector3& aabbMax) const;
-*/
 
 	virtual void	calculateLocalInertia(btScalar mass,btVector3& inertia) const;
 

src/BulletDynamics/Dynamics/btContinuousDynamicsWorld.h

@@ -20,7 +20,7 @@ subject to the following restrictions:
 
 ///btContinuousDynamicsWorld adds optional (per object) continuous collision detection for fast moving objects to the btDiscreteDynamicsWorld.
 ///This copes with fast moving objects that otherwise would tunnel/miss collisions.
-///Under construction, don't use yet!
+///Under construction, don't use yet! Please use btDiscreteDynamicsWorld instead.
 class btContinuousDynamicsWorld : public btDiscreteDynamicsWorld
 {
 

src/BulletDynamics/Dynamics/btSimpleDynamicsWorld.h

@@ -22,11 +22,8 @@ class btDispatcher;
 class btOverlappingPairCache;
 class btConstraintSolver;
 
-///btSimpleDynamicsWorld demonstrates very basic usage of Bullet rigid body dynamics
+///btSimpleDynamicsWorld serves as unit-test and to verify more complicated and optimized dynamics worlds.
-///It can be used for basic simulations, and as a starting point for porting Bullet
+///Please use btDiscreteDynamicsWorld instead (or btContinuousDynamicsWorld once it is finished).
-///btSimpleDynamicsWorld lacks object deactivation, island management and other concepts.
-///For more complicated simulations, btDiscreteDynamicsWorld and btContinuousDynamicsWorld are recommended
-///those classes replace the obsolete CcdPhysicsEnvironment/CcdPhysicsController
 class btSimpleDynamicsWorld : public btDynamicsWorld
 {
 protected: