diff --git a/src/mat2.rs b/src/mat2.rs
index 0e3f03f..e1efe39 100644
--- a/src/mat2.rs
+++ b/src/mat2.rs
@@ -399,8 +399,10 @@ impl<T:Copy + Float + FuzzyEq<T>> FuzzyEq<T> for Mat2<T> {
 // GLSL-style type aliases, corresponding to Section 4.1.6 of the [GLSL 4.30.6 specification]
 // (http://www.opengl.org/registry/doc/GLSLangSpec.4.30.6.pdf).
 
-pub type mat2 = Mat2<f32>;      // a 2×2 single-precision floating-point matrix
-pub type dmat2 = Mat2<f64>;     // a 2×2 double-precision floating-point matrix
+/// a 2×2 single-precision floating-point matrix
+pub type mat2 = Mat2<f32>;
+/// a 2×2 double-precision floating-point matrix
+pub type dmat2 = Mat2<f64>;
 
 // Static method wrappers for GLSL-style types
 
diff --git a/src/mat3.rs b/src/mat3.rs
index 3db476f..d76f30b 100644
--- a/src/mat3.rs
+++ b/src/mat3.rs
@@ -576,8 +576,10 @@ impl<T:Copy + Float + FuzzyEq<T> + Add<T,T> + Sub<T,T> + Mul<T,T> + Div<T,T> + N
 // GLSL-style type aliases, corresponding to Section 4.1.6 of the [GLSL 4.30.6 specification]
 // (http://www.opengl.org/registry/doc/GLSLangSpec.4.30.6.pdf).
 
-pub type mat3 = Mat3<f32>;      // a 3×3 single-precision floating-point matrix
-pub type dmat3 = Mat3<f64>;     // a 3×3 double-precision floating-point matrix
+/// a 3×3 single-precision floating-point matrix
+pub type mat3 = Mat3<f32>;
+/// a 3×3 double-precision floating-point matrix
+pub type dmat3 = Mat3<f64>;
 
 // Static method wrappers for GLSL-style types
 
diff --git a/src/mat4.rs b/src/mat4.rs
index 92dfec7..3052f89 100644
--- a/src/mat4.rs
+++ b/src/mat4.rs
@@ -513,8 +513,10 @@ impl<T:Copy + Float + FuzzyEq<T>> FuzzyEq<T> for Mat4<T> {
 // GLSL-style type aliases, corresponding to Section 4.1.6 of the [GLSL 4.30.6 specification]
 // (http://www.opengl.org/registry/doc/GLSLangSpec.4.30.6.pdf).
 
-pub type mat4 = Mat4<f32>;      // a 4×4 single-precision floating-point matrix
-pub type dmat4 = Mat4<f64>;     // a 4×4 double-precision floating-point matrix
+/// a 4×4 single-precision floating-point matrix
+pub type mat4 = Mat4<f32>;
+/// a 4×4 double-precision floating-point matrix
+pub type dmat4 = Mat4<f64>;
 
 // Static method wrappers for GLSL-style types
 
diff --git a/src/quat.rs b/src/quat.rs
index 1cab448..aa8ff09 100644
--- a/src/quat.rs
+++ b/src/quat.rs
@@ -416,8 +416,10 @@ impl<T:Copy + Float + FuzzyEq<T>> FuzzyEq<T> for Quat<T> {
 // GLSL-style type aliases for quaternions. These are not present in the GLSL
 // specification, but they roughly follow the same nomenclature.
 
-pub type quat  = Quat<f32>;             /// a single-precision floating-point quaternion
-pub type dquat = Quat<f64>;             /// a double-precision floating-point quaternion
+/// a single-precision floating-point quaternion
+pub type quat  = Quat<f32>;
+/// a double-precision floating-point quaternion
+pub type dquat = Quat<f64>;
 
 // Static method wrappers for GLSL-style types
 
diff --git a/src/vec2.rs b/src/vec2.rs
index 3e76330..c98f612 100644
--- a/src/vec2.rs
+++ b/src/vec2.rs
@@ -343,11 +343,16 @@ impl BooleanVector for Vec2<bool> {
 // GLSL-style type aliases, corresponding to Section 4.1.5 of the [GLSL 4.30.6 specification]
 // (http://www.opengl.org/registry/doc/GLSLangSpec.4.30.6.pdf).
 
-pub type vec2  = Vec2<f32>;     // a two-component single-precision floating-point vector
-pub type dvec2 = Vec2<f64>;     // a two-component double-precision floating-point vector
-pub type bvec2 = Vec2<bool>;    // a two-component Boolean vector
-pub type ivec2 = Vec2<i32>;     // a two-component signed integer vector
-pub type uvec2 = Vec2<u32>;     // a two-component unsigned integer vector
+/// a two-component single-precision floating-point vector
+pub type vec2  = Vec2<f32>;
+/// a two-component double-precision floating-point vector
+pub type dvec2 = Vec2<f64>;
+/// a two-component Boolean vector
+pub type bvec2 = Vec2<bool>;
+/// a two-component signed integer vector
+pub type ivec2 = Vec2<i32>;
+/// a two-component unsigned integer vector
+pub type uvec2 = Vec2<u32>;
 
 // Static method wrappers for GLSL-style types
 
diff --git a/src/vec3.rs b/src/vec3.rs
index 7ac04c2..1ed46b6 100644
--- a/src/vec3.rs
+++ b/src/vec3.rs
@@ -379,11 +379,16 @@ impl BooleanVector for Vec3<bool> {
 // GLSL-style type aliases, corresponding to Section 4.1.5 of the [GLSL 4.30.6 specification]
 // (http://www.opengl.org/registry/doc/GLSLangSpec.4.30.6.pdf).
 
-pub type vec3  = Vec3<f32>;     // a three-component single-precision floating-point vector
-pub type dvec3 = Vec3<f64>;     // a three-component double-precision floating-point vector
-pub type bvec3 = Vec3<bool>;    // a three-component Boolean vector
-pub type ivec3 = Vec3<i32>;     // a three-component signed integer vector
-pub type uvec3 = Vec3<u32>;     // a three-component unsigned integer vector
+/// a three-component single-precision floating-point vector
+pub type vec3  = Vec3<f32>;
+/// a three-component double-precision floating-point vector
+pub type dvec3 = Vec3<f64>;
+/// a three-component Boolean vector
+pub type bvec3 = Vec3<bool>;
+/// a three-component signed integer vector
+pub type ivec3 = Vec3<i32>;
+/// a three-component unsigned integer vector
+pub type uvec3 = Vec3<u32>;
 
 // Static method wrappers for GLSL-style types
 
diff --git a/src/vec4.rs b/src/vec4.rs
index e5497c4..8f9c7ef 100644
--- a/src/vec4.rs
+++ b/src/vec4.rs
@@ -387,11 +387,16 @@ impl BooleanVector for Vec4<bool> {
 // GLSL-style type aliases, corresponding to Section 4.1.5 of the [GLSL 4.30.6 specification]
 // (http://www.opengl.org/registry/doc/GLSLangSpec.4.30.6.pdf).
 
-pub type vec4  = Vec4<f32>;     // a four-component single-precision floating-point vector
-pub type dvec4 = Vec4<f64>;     // a four-component double-precision floating-point vector
-pub type bvec4 = Vec4<bool>;    // a four-component Boolean vector
-pub type ivec4 = Vec4<i32>;     // a four-component signed integer vector
-pub type uvec4 = Vec4<u32>;     // a four-component unsigned integer vector
+// a four-component single-precision floating-point vector
+pub type vec4  = Vec4<f32>;
+// a four-component double-precision floating-point vector
+pub type dvec4 = Vec4<f64>;
+// a four-component Boolean vector
+pub type bvec4 = Vec4<bool>;
+// a four-component signed integer vector
+pub type ivec4 = Vec4<i32>;
+// a four-component unsigned integer vector
+pub type uvec4 = Vec4<u32>;
 
 // Static method wrappers for GLSL-style types