Adding comments.

git-svn-id: svn://svn.code.sf.net/p/irrlicht/code/trunk@6331 dfc29bdd-3216-0410-991c-e03cc46cb475

include/CDynamicMeshBuffer.h

@@ -14,7 +14,7 @@ namespace irr
 {
 namespace scene
 {
-
+	//! Implementation of the IMeshBuffer interface for which can work with 16 and 32 bit indices as well as different vertex types
 	class CDynamicMeshBuffer: public IDynamicMeshBuffer
 	{
 	public:

include/CMeshBuffer.h

@@ -12,7 +12,7 @@ namespace irr
 {
 namespace scene
 {
-	//! Template implementation of the IMeshBuffer interface
+	//! Template implementation of the IMeshBuffer interface for 16-bit buffers
 	template <class T>
 	class CMeshBuffer : public IMeshBuffer
 	{

include/EMeshBufferTypes.h

@@ -16,16 +16,16 @@ namespace scene
 	of simple numbers (easier to add external classes). */
 	enum EMESH_BUFFER_TYPE
 	{
-		//! SMeshBuffer
+		//! SMeshBuffer (16 bit buffers)
 		EMBT_STANDARD = MAKE_IRR_ID('s','t','a','n'),
 
-		//! SMeshBufferLightMap
+		//! SMeshBufferLightMap (16 bit buffers)
 		EMBT_LIGHTMAP = MAKE_IRR_ID('l','i','g','h'),
 
-		//! SMeshBufferTangents
+		//! SMeshBufferTangents (16 bit buffers)
 		EMBT_TANGENTS = MAKE_IRR_ID('t','a','n','g'),
 
-		//! CDynamicMeshBuffer
+		//! CDynamicMeshBuffer (16 or 32 bit buffers)
 		EMBT_DYNAMIC  = MAKE_IRR_ID('d','y','n','a'),
 
 		// SSharedMeshBuffer

include/IMeshBuffer.h

@@ -72,11 +72,17 @@ namespace scene
 		virtual video::E_INDEX_TYPE getIndexType() const =0;
 
 		//! Get access to indices.
-		/** \return Pointer to indices array. */
+		/** Note: For historical reasons data pointer is of type u16*, but
+		for an index type of EIT_32BIT the index data is using an u32 array
+		and therefore needs a cast to u32*.
+		\return Pointer to indices array. */
 		virtual const u16* getIndices() const = 0;
 
 		//! Get access to indices.
-		/** \return Pointer to indices array. */
+		/** Note: For historical reasons data pointer is of type u16*, but
+		for an index type of EIT_32BIT the index data is using an u32 array
+		and therefore needs a cast to u32*.
+		\return Pointer to indices array. */
 		virtual u16* getIndices() = 0;
 
 		//! Get amount of indices in this meshbuffer.