diff --git a/glm/core/func_noise.hpp b/glm/core/func_noise.hpp
index 4af5f7d4..b76ec4b4 100644
--- a/glm/core/func_noise.hpp
+++ b/glm/core/func_noise.hpp
@@ -24,23 +24,31 @@ namespace glm
/// \addtogroup core_funcs
///@{
- // Returns a 1D noise value based on the input value x.
- // From GLSL 1.30.08 specification, section 8.9.
+ //! Returns a 1D noise value based on the input value x.
+ //!
+ //! \li GLSL noise1 man page
+ //! \li GLSL 1.30.08 specification, section 8.9
template
typename genType::value_type noise1(genType const & x);
- // Returns a 2D noise value based on the input value x.
- // From GLSL 1.30.08 specification, section 8.9.
+ //! Returns a 2D noise value based on the input value x.
+ //!
+ //! \li GLSL noise2 man page
+ //! \li GLSL 1.30.08 specification, section 8.9
template
detail::tvec2 noise2(genType const & x);
- // Returns a 3D noise value based on the input value x.
- // From GLSL 1.30.08 specification, section 8.9.
+ //! Returns a 3D noise value based on the input value x.
+ //!
+ //! \li GLSL noise3 man page
+ //! \li GLSL 1.30.08 specification, section 8.9
template
detail::tvec3 noise3(genType const & x);
- // Returns a 4D noise value based on the input value x.
- // From GLSL 1.30.08 specification, section 8.9.
+ //! Returns a 4D noise value based on the input value x.
+ //!
+ //! \li GLSL noise4 man page
+ //! \li GLSL 1.30.08 specification, section 8.9
template
detail::tvec4 noise4(genType const & x);