Various documentation enhancements.

include/PolyVox/BaseVolume.h

@@ -35,7 +35,7 @@ namespace PolyVox
 	/// The BaseVolume class provides common functionality and an interface for other volume classes to implement.
 	/// You should not try to create an instance of this class directly. Instead you should use RawVolume or PagedVolume.
 	////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-	/// More details to come...
+	/// \sa RawVolume, PagedVolume
 	////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
 	template <typename _VoxelType>
 	class BaseVolume

include/PolyVox/DefaultIsQuadNeeded.h

@@ -31,6 +31,15 @@
 
 namespace PolyVox
 {
+	/// Default implementation of a function object for deciding when
+	/// the cubic surface extractor should insert a face between two voxels.
+	///
+	/// The criteria used here are that the voxel in front of the potential
+	/// quad should have a value of zero (which would typically indicate empty 
+	/// space) while the voxel behind the potential quad would have a value
+	/// geater than zero (typically indicating it is solid). Note that for
+	/// different behaviour users can create their own implementation and pass
+	/// it to extractCubicMesh().
 	template<typename VoxelType>
 	class DefaultIsQuadNeeded
 	{

include/PolyVox/DefaultMarchingCubesController.h

@@ -56,7 +56,7 @@ namespace PolyVox
 	 * will pass through the density value specified by the threshold, and so you should make sure that the threshold value you choose is between
 	 * the minimum and maximum values found in your volume data. By default it is in the middle of the representable range of the underlying type.
 	 *
-	 * \sa MarchingCubesSurfaceExtractor
+	 * \sa extractMarchingCubesMesh
 	 *
 	 */
 	template<typename VoxelType>

include/PolyVox/Density.h

@@ -38,7 +38,9 @@ namespace PolyVox
 {
 	/// This class represents a voxel storing only a density.
 	////////////////////////////////////////////////////////////////////////////////
-	/// Detailed description...
+	/// Note that this should probably just be considered an example of how to define
+	/// a voxel type for the Marching Cubes algorithm. Advanced users are likely to
+	/// define custom voxel types and possibly custom controllers.
 	////////////////////////////////////////////////////////////////////////////////
 	template <typename Type>
 	class Density

include/PolyVox/Exceptions.h

@@ -28,7 +28,7 @@
 #include <stdexcept> // For base exception classes.
 #include <string.h> // Exception constuctors take strings.
 
-// These exceptions form part of the public API because lcient code may need to catch them.
+// These exceptions form part of the public API because client code may need to catch them.
 // Note that our utility macros such as 'POLYVOX_THROW_IF' do not form part of the public API
 // as they are only for our own internal use.
 namespace PolyVox