Better documentation for primitives.

src/Primitives/Capsule.h

@@ -24,9 +24,10 @@
 namespace Magnum { namespace Primitives {
 
 /**
-@brief %Capsule primitive
+@brief 3D capsule primitive
 
-Cylinder along Y axis with hemispheres instead of caps.
+Cylinder along Y axis with hemispheres instead of caps. Indexed with normals
+and optional 2D texture coordinates.
 */
 class Capsule: public Trade::MeshData3D {
     friend class UVSphere;

src/Primitives/Cube.h

@@ -23,7 +23,12 @@
 
 namespace Magnum { namespace Primitives {
 
-/** @brief %Cube primitive */
+/**
+@brief 3D cube primitive
+
+Indexed with smooth normals.
+@todo Does anyone EVER want smooth normals on a cube?!
+*/
 class Cube: public Trade::MeshData3D {
     public:
         /** @brief Constructor */

src/Primitives/Cylinder.h

@@ -25,7 +25,12 @@
 
 namespace Magnum { namespace Primitives {
 
-/** @brief Cylinder primitive */
+/**
+@brief 3D cylinder primitive
+
+Indexed with normals, optional 2D texture coordinates and optional capped
+ends.
+*/
 class Cylinder: public Capsule {
     public:
         /**

src/Primitives/Icosphere.h

@@ -29,8 +29,9 @@ namespace Magnum { namespace Primitives {
 template<size_t subdivisions> class Icosphere;
 
 /**
-@brief %Icosphere primitive with zero subdivisions
+@brief 3D icosphere primitive with zero subdivisions
 
+Indexed with normals.
 @todo Use own computed (and more precise) icosahedron data, not these stolen
 from Blender.
 */
@@ -41,9 +42,11 @@ template<> class Icosphere<0>: public Trade::MeshData3D {
 };
 
 /**
- * @brief %Icosphere primitive
+@brief 3D icosphere primitive
- * @tparam subdivisions     Number of subdivisions
+@tparam subdivisions     Number of subdivisions
- */
+
+Indexed with normals.
+*/
 #ifndef DOXYGEN_GENERATING_OUTPUT
 template<size_t subdivisions> class Icosphere: public Icosphere<0> {
 #else

src/Primitives/Plane.h

@@ -24,9 +24,9 @@
 namespace Magnum { namespace Primitives {
 
 /**
-@brief %Plane primitive
+@brief 3D plane primitive
 
-2x2 plane with normals in positive Z direction.
+2x2 plane, non-indexed with normals in positive Z direction.
 */
 class Plane: public Trade::MeshData3D {
     public:

src/Primitives/Square.h

@@ -24,9 +24,9 @@
 namespace Magnum { namespace Primitives {
 
 /**
-@brief %Square primitive
+@brief 2D square primitive
 
-2x2 square.
+2x2 square, non-indexed.
 */
 class Square: public Trade::MeshData2D {
     public:

src/Primitives/UVSphere.h

@@ -23,7 +23,11 @@
 
 namespace Magnum { namespace Primitives {
 
-/** @brief UV Sphere primitive */
+/**
+@brief 3D UV sphere primitive
+
+Indexed with normals and optional 2D texture coordinates.
+*/
 class UVSphere: public Capsule {
     public:
         /**